Back to Details

pp-podscan

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Podscan — Printing Press CLI

Podscan — Printing Press CLI工具

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the 
podscan-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press install podscan --cli-only
  2. Verify: 
    podscan-pp-cli --version
  3. Ensure 
    $GOPATH/bin
    (or 
    $HOME/go/bin
    ) is on 
    $PATH
    .
If the 
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/podscan/cmd/podscan-pp-cli@latest
If 
--version
reports "command not found" after install, the install step did not put the binary on 
$PATH
. Do not proceed with skill commands until verification succeeds.
Podscan REST API — search 51M+ podcast episodes and 4.4M+ podcasts. Full transcripts, AI-extracted entities, mentions, brand-safety analysis.
本技能基于
podscan-pp-cli
二进制文件运行。在调用本技能的任何命令前，必须确认CLI已安装。若未安装，请按以下步骤安装：
  1. 通过Printing Press安装器安装：
    bash
    npx -y @mvanhorn/printing-press install podscan --cli-only
  2. 验证安装：
    podscan-pp-cli --version
  3. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）已添加到
    $PATH
    环境变量中。
如果
npx
安装失败（如无Node环境、离线等），可改用Go直接安装（要求Go 1.26.3或更高版本）：
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/podscan/cmd/podscan-pp-cli@latest
若安装后执行
--version
提示“command not found”，说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行技能命令。
Podscan REST API——可搜索5100多万个播客剧集和440多万个播客，提供完整转录文本、AI提取实体、提及内容、品牌安全分析等功能。

Command Reference

命令参考

alerts — Manage alerts
  • podscan-pp-cli alerts create
    — Create a new alert
  • podscan-pp-cli alerts delete
    — Delete an alert
  • podscan-pp-cli alerts get
    — Get an alert
  • podscan-pp-cli alerts list
    — List configured alerts
categories — Manage categories
  • podscan-pp-cli categories
    — List all podcast categories
episodes — Manage episodes
  • podscan-pp-cli episodes get
    — Get an episode by ID
  • podscan-pp-cli episodes search
    — Search episodes by transcript content
exports — Manage exports
  • podscan-pp-cli exports download
    — Download an export file
  • podscan-pp-cli exports list-episode
    — List daily episode export files
  • podscan-pp-cli exports list-podcast
    — List podcast catalog export files
podcasts — Manage podcasts
  • podscan-pp-cli podcasts get
    — Get a podcast by ID
  • podscan-pp-cli podcasts search
    — Search podcasts by name or description
alerts — 管理告警
  • podscan-pp-cli alerts create
    — 创建新告警
  • podscan-pp-cli alerts delete
    — 删除告警
  • podscan-pp-cli alerts get
    — 获取告警详情
  • podscan-pp-cli alerts list
    — 列出已配置的告警
categories — 管理分类
  • podscan-pp-cli categories
    — 列出所有播客分类
episodes — 管理剧集
  • podscan-pp-cli episodes get
    — 通过ID获取剧集详情
  • podscan-pp-cli episodes search
    — 根据转录内容搜索剧集
exports — 管理导出
  • podscan-pp-cli exports download
    — 下载导出文件
  • podscan-pp-cli exports list-episode
    — 列出每日剧集导出文件
  • podscan-pp-cli exports list-podcast
    — 列出播客目录导出文件
podcasts — 管理播客
  • podscan-pp-cli podcasts get
    — 通过ID获取播客详情
  • podscan-pp-cli podcasts search
    — 根据名称或描述搜索播客

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
podscan-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 
0
means at least one match; exit code 
2
means no confident match — fall back to 
--help
or use a narrower query.
当你知道要执行的操作但不确定对应命令时，可直接询问CLI：
bash
podscan-pp-cli which "<用你自己的语言描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少找到一个匹配项；退出码
2
表示没有确定的匹配项——此时可改用
--help
或缩小查询范围。

Auth Setup

认证设置

Store your access token:
bash
podscan-pp-cli auth set-token YOUR_TOKEN_HERE
Or set 
PODSCAN_BEARER_AUTH
as an environment variable.
Run 
podscan-pp-cli doctor
to verify setup.
存储你的访问令牌：
bash
podscan-pp-cli auth set-token YOUR_TOKEN_HERE
或者将
PODSCAN_BEARER_AUTH
设置为环境变量。
执行
podscan-pp-cli doctor
验证设置是否正确。

Agent Mode

Agent模式

Add 
--agent
to any command. Expands to: 
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable — 
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    podscan-pp-cli alerts list --agent --select id,name,status
  • Previewable — 
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Explicit retries — use 
    --idempotent
    only when an already-existing create should count as success, and 
    --ignore-missing
    only when a missing delete target should count as success
在任何命令后添加
--agent
参数，等效于添加：
--json --compact --no-input --no-color --yes
。
  • 可管道传输 — 标准输出为JSON格式，错误信息输出到标准错误
  • 可过滤 — 
    --select
    参数保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。这在处理冗长API时对缩小上下文范围至关重要：
    bash
    podscan-pp-cli alerts list --agent --select id,name,status
  • 可预览 — 
    --dry-run
    参数会显示请求内容但不发送
  • 离线友好 — 同步/搜索命令在本地SQLite存储可用时可使用该存储
  • 非交互式 — 从不提示输入，所有输入均通过标志参数提供
  • 显式重试 — 仅当已存在的创建操作应视为成功时使用
    --idempotent
    参数；仅当缺失的删除目标应视为成功时使用
    --ignore-missing
    参数

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse 
.results
for data and 
.meta.source
to know whether it's live or local. A human-readable 
N results (live)
summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据，通过
.meta.source
判断数据来自实时API还是本地存储。仅当标准输出为终端时，才会向标准错误输出人类可读的
N results (live)
摘要——管道/Agent消费者会在标准输出获得纯JSON格式内容。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
podscan-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
podscan-pp-cli feedback --stdin < notes.txt
podscan-pp-cli feedback list --json --limit 10
Entries are stored locally at 
~/.podscan-pp-cli/feedback.jsonl
. They are never POSTed unless 
PODSCAN_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
PODSCAN_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当你（或Agent）发现此CLI存在问题时，可记录反馈：
podscan-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
podscan-pp-cli feedback --stdin < notes.txt
podscan-pp-cli feedback list --json --limit 10
反馈条目会存储在本地
~/.podscan-pp-cli/feedback.jsonl
文件中。除非设置了
PODSCAN_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置
PODSCAN_FEEDBACK_AUTO_SEND=true
，否则反馈不会被POST发送。默认行为仅存储在本地。
记录让你感到意外的内容，而非正式的错误报告。简短、具体、一句话即可：这样的反馈更有价值。

Output Delivery

输出交付

Every command accepts 
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to 
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or 
application/x-ndjson
when 
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会除了（或代替）标准输出外发送到指定的sink，以便Agent无需手动管道即可路由命令结果。支持三种sink：
Sink效果
stdout
默认值；仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
（先写入临时文件再重命名）
webhook:<url>
将输出体POST到指定URL（当使用
--compact
时为
application/json
或
application/x-ndjson
格式）
未知的协议会被拒绝，并返回结构化错误说明支持的协议集合。Webhook失败会返回非零退出码，并在标准错误中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
podscan-pp-cli profile save briefing --json
podscan-pp-cli --profile briefing alerts list
podscan-pp-cli profile list --json
podscan-pp-cli profile show briefing
podscan-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. 
agent-context
lists all available profiles under 
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的标志值，可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时，可使用此功能——即HeyGen的“Beacon”模式。
podscan-pp-cli profile save briefing --json
podscan-pp-cli --profile briefing alerts list
podscan-pp-cli profile list --json
podscan-pp-cli profile show briefing
podscan-pp-cli profile delete briefing --yes
显式标志始终优先于配置文件值；配置文件值优先于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件，以便自省Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
4需要认证
5API错误（上游问题）
7速率限制（请等待后重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    podscan-pp-cli --help
    output
  2. Starts with 
    install
     → ends with 
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with 
    --agent
    )
解析
$ARGUMENTS
的规则：
  1. 为空、
    help
    或
    --help
     → 显示
    podscan-pp-cli --help
    输出
  2. 以
    install
    开头     → 若结尾为
    mcp
    → 安装MCP；否则 → 参见上方前提条件中的安装步骤
  3. 其他情况 → 直接使用（添加
    --agent
    标志执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:
bash
claude mcp add podscan-pp-mcp -- podscan-pp-mcp
Verify: 
claude mcp list
从本CLI已发布的公共库条目或预构建版本安装MCP二进制文件，然后注册：
bash
claude mcp add podscan-pp-mcp -- podscan-pp-mcp
验证：
claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which podscan-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the 
    --agent
    flag:
    bash
    podscan-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    podscan-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which podscan-pp-cli
    若未找到，提供安装选项（参见顶部前提条件中的安装步骤）。
  2. 将用户查询与上方“独特功能”和“命令参考”中的最佳命令匹配。
  3. 添加
    --agent
    标志执行命令：
    bash
    podscan-pp-cli <command> [subcommand] [args] --agent
  4. 若存在歧义，查看子命令帮助：
    podscan-pp-cli <command> --help
    。