用途:pp-alltrails 是一套驱动 alltrails-pp-cli 二进制的命令技能,把 AllTrails 浏览器/移动端接口映射为带证据标注、可实况调用的 CLI 命令,并以“非官方 API 契约”定位。
安装与验证:npx -y @mvanhorn/printing-press-library install alltrails --cli-only;验证 alltrails-pp-cli --version。npx 失败时可回退 go install github.com/mvanhorn/printing-press-library/library/travel/alltrails/cmd/alltrails-pp-cli@latest,需 Go 1.26.6 或更新版本。安装目录需在 $PATH 中。
主要能力:覆盖活动与轨迹数据——创建活动记录、活动详情(GPS/统计面)、轨迹详情、离线地图元数据、地图与轨迹静态图元数据/渲染端点、用户活动列表、按文本/地点/过滤条件的轨迹搜索、当前账户资料。命令包括 alltrails create、get、get-v3 至 get-v3-5、list、list-v3。可用 alltrails-pp-cli which "<能力描述>" 将自然语言需求解析到对应命令。
认证:公开读取可能无需凭证;账户路由使用调用方自备的 ALLTRAILS_ACCESS_TOKEN、ALLTRAILS_COOKIE、ALLTRAILS_CSRF_TOKEN,可用 doctor 检查配置。
写入安全:默认只读。实况写入需同时满足两条——命令带 --live-write(而非默认 dry-run),且环境中存在 ALLTRAILS_PP_ALLOW_WRITES=1;否则预览请求或直接失败。未获用户明确批准前不要设置该环境变量。
代理模式:任意命令可加 --agent(等价于 --json --compact --no-input --no-color --yes),支持 --select 裁剪字段、--dry-run 预览、同步/搜索可用本地 SQLite。输出带 meta.source(live/local)与 results 信封。sync 默认安全空操作,因浏览器 API 受 DataDome 保护;仅在配置了自备认证且确需实况读取时用 sync --resources routing_info。
其它:--deliver 支持 stdout、file:<path>、webhook:<url>;profile save/list/show/delete 保存命名配置,显式参数优先;feedback 默认仅本地存储于 ~/.local/share/alltrails-pp-cli/feedback.jsonl;退出码 0 成功、2 用法错误、3 未找到、5 API 错误、7 限流、10 配置错误。安装 MCP 可执行 claude mcp add alltrails-pp-mcp -- alltrails-pp-mcp。
限制:非官方 API 契约,接口稳定性与可用性以实际为准;部分能力依赖自备凭证,资料未提供具体的可用范围、收费与配额细节。