用途：面向智能体或脚本，把 Surfline 的海浪、涌浪、风、潮汐、天气与评分数据以结构化输出取回，用于判断单个浪点是否值得冲、在多个浪点间排序、寻找白天合适时段，或按自定义阈值定时告警。也可获取原始数值而非星级评分，并保存本地预报历史。
主要能力：now 将某一浪点未来数小时合并为可划可不划的单行读数；rank 按浪、风、涌浪综合 optimalScore 对多个浪点排序；windows 仅输出白天内三项评分均达标的时间块；raw 输出可管道处理的表格或 JSON，含最小/最大/optimalScore 及涌浪分量、风向类型与阵风；buoy-check 将附近浮标观测涌浪与同一时段预报并排对比；alert run 依据本地阈值规则评估新预报并以退出码标记是否命中；journal show 把当前预报快照存入本地 SQLite 并回看历史；search 通过本地分类词库离线把浪点名解析为 spotId。命令覆盖 spots（wave、wind、tide、weather、rating、report、conditions、forecast 等）、buoys、regions、taxonomy。
使用方式：需先安装 CLI，可用 npx -y @mvanhorn/printing-press-library install surfline --cli-only 安装，或用 go install github.com/mvanhorn/printing-press-library/library/other/surfline/cmd/surfline-pp-cli@latest（需 Go 1.26.4 及以上），并确保安装目录在 PATH 中，用 surfline-pp-cli --version 验证。任意命令加 --agent 即展开为 --json --compact --no-input --no-color --yes。可用 --select 按点路径裁剪字段、--dry-run 预览、--deliver 将输出写到 file:<path> 或 webhook:<url>。输出包裹在 meta/results 信封中，读取 results 与 meta.source。
适用场景与限制：适合需要原始海浪/风/潮数据、需要多点比较或需要本地预报历史的自动化流程。基础预报、搜索、分类与多点数据无需认证，约有 6 天时间范围；7 至 17 天预报与高级摄像头需通过 auth login 或 auth set-token 设置 Surfline 访问令牌。它不返回实时摄像头视频流，只给出静帧或流地址；不覆盖非 Surfline 的天气或未收录浪点，也不用于预订、发帖或管理账号，属于只读预报工具。缺少 Node、离线等情况下可改用 Go 安装。具体价格、收费与其他效果类信息资料未提供。