用途:pp-podscan 技能驱动 podscan-pp-cli 二进制,用于在 Podscan 数据集中搜索播客节目与单集,覆盖超过 5100 万集节目与 440 万档播客,可获取全文转录、AI 提取实体、提及与品牌安全分析。
主要能力:命令分为 alerts(创建、删除、获取、列出提醒)、categories(列出播客分类)、episodes(按 ID 获取、按转录内容搜索单集)、exports(下载导出文件、列出每日单集与播客目录导出)、podcasts(按 ID 获取、按名称或描述搜索)。可用 podscan-pp-cli which "<自然语言能力描述>" 将需求映射到最匹配命令,退出码 0 表示有匹配、2 表示无把握匹配。
安装与认证:需先安装 CLI,验证 podscan-pp-cli --version。可通过 npx -y @mvanhorn/printing-press-library install podscan --cli-only 安装,或回退到 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/podscan/cmd/podscan-pp-cli@latest(需 Go 1.26.6 或更新版本)。认证用 podscan-pp-cli auth set-token YOUR_TOKEN_HERE,或设置 PODSCAN_BEARER_AUTH 环境变量,再用 podscan-pp-cli doctor 验证。
使用方式:任意命令可加 --agent,等价于 --json --compact --no-input --no-color --yes。支持 --select 保留字段子集、--dry-run 预览、--deliver stdout|file:<path>|webhook:<url> 路由输出、profile save/list/show/delete 保存复用参数组合。读取本地库或 API 的命令返回含 meta 与 results 的信封,需解析 .results,并用 .meta.source 区分 live 或 local。
限制:安装目录需在 PATH 中,否则 --version 报 command not found 时不应继续执行技能命令;Webhook 失败会返回非零并记录 URL 与 HTTP 状态;feedback 默认仅写入本地 ~/.podscan-pp-cli/feedback.jsonl,除非设置 PODSCAN_FEEDBACK_ENDPOINT 并显式 --send 或开启自动发送。其余细节暂未提供。