Podcast Robot

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install podcast-robot
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 podcast-robot。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Podcast Robot 是一款零设置技能，可通过 Podcast Robot MCP 服务器探索播客。它让代理能够搜索节目和单集、查看最新内容、查找嘉宾和与地点相关的节目、搜索单集文字稿、创建可分享的片段引用、查看直播串流和 Podping 事件，以及评估播客 feed。
这项公开服务不需要 API 密钥、账户或 OAuth，也不会储存用户偏好。代理可以记住听众使用的播客应用、城市、关注的节目和语言，然后在请求中传递这些偏好。Podcast Robot 等 Openclaw Skills 让播客研究和收听工作流程更容易使用，同时不会编造细节：回应内容以工具输出为依据。

应用场景

当听众说出节目或主题时，按标题或其他支持的搜索条件探索播客。
查找关注节目近期发布的单集，或查看上次更新以来有哪些新内容。
查找与节目相关的人物，或探索与某个地点相关的播客。
搜索单集文字稿中的主题，然后创建指向相关片段的可分享引用。
探索可用的直播串流，或检查 Podping feed 事件。
使用服务器工具评估播客 feed，或排查与播客相关的问题。
有可用的应用偏好时，返回适配用户播客应用的收听链接。

工作原理

代理使用 bin/mcp_robot.py，这是一个精简的 JSON-RPC 客户端，通过 Streamable HTTP 与公开 MCP 端点通信。
它可以列出可用工具，或调用 start_here 获取实时菜单和入门清单。
代理选择相关工具并以 JSON 发送参数，也可以附带用户偏好，例如播客应用、城市、关注的节目或语言。
要查找文字稿，代理首先通过单集或新发布内容查询取得单集 ID，然后搜索该单集的文字稿。
如果用户想分享某个片段，代理会将单集 ID、开始时间和时长传递给 make_clip；仅文字稿搜索结果会提供媒体片段播放 URL。
代理根据工具回应呈现结果，使用建议的 hints 提供相关后续操作，并依照技能规则处理输入指引或已记录的故障。

配置指南

Podcast Robot 不需要 API 密钥、账户或 OAuth。公开端点位于 https://podcastindexrobot.com/mcp。使用随附客户端检查工具并发出调用：
bin/mcp_robot.py tools
bin/mcp_robot.py call start_here '{}'
bin/mcp_robot.py call search_podcasts '{"query": "No Agenda", "mode": "title", "max_results": 3}'
若要执行文字稿搜索和片段工作流程，请先取得单集 ID，然后搜索并创建片段引用：
bin/mcp_robot.py call get_episodes '{"feed": "41504", "max_results": 1}'
bin/mcp_robot.py call transcript_search '{"episode": "61124290178", "query": "bitcoin", "max_hits": 2}'
bin/mcp_robot.py call make_clip '{"episode": "61124290178", "start": 4577, "duration": 45}'
向用户询问一次相关偏好，并将其保留在代理自己的记忆中；服务器是无状态的。每次调用时都通过 prefs 传递偏好。不要索取凭证。

数据架构

Podcast Robot 通过其 JSON-RPC 客户端交换 JSON 参数和结果。技能没有指定由服务器生成的本地数据文件；用户偏好由代理保留，而非由无状态服务保留。
数据 用途与处理方式
工具参数 传递给所选工具的 JSON 值，例如搜索查询、单集 ID、时间范围或 prefs 对象。
prefs 可选的听众背景信息，包括 app、city、follows 和 language；可用时在调用中附带。
open 链接 如果设置了 prefs.app，结果可以包含 open.app；否则使用 open.universal。
hints 每个结果末尾附带的建议后续调用；提供两三个相关选项。
kind: fault 包含 errorId；报告该 ID 并重试一次。
kind: input 表示输入问题而非错误；遵循 whatToTry、closestMatches 或 howToAdd。
文字稿匹配项 包含使用 #t=start,end 的媒体片段播放 URL；使用 make_clip 创建可分享的片段引用。
Podping 事件 resolve: true 会添加 feedId 和标题；contains 可筛选 feed URL。

高级特性

无状态且能识别偏好的调用支持个性化应用链接，不会将偏好发送到服务器的持久储存中。

工作原理

make_clip
，生成可分享的片段引用。
增量监控支持
whats_new
、
podping_events
feed_activity
since
时间戳。
共享端点的防护措施将每个 IP 的请求限制为每分钟 60 次；进行监控时，检查频率不得高于每 15 分钟一次。
Podping 事件解析和 feed URL 筛选支持更聚焦的事件检查。
工具提供的
hints
会引导后续操作，结构化的故障和输入回应则提供明确的恢复途径。
该技能不需要用户凭证，并要求代理仅报告工具输出中存在的单集细节。

name: "podcast-robot" description: "Talk to the Podcast Robot MCP server (podcastindexrobot.com, a Podcast Index service) for podcast discovery, what's new, people, places, transcript search, shareable clips, live streams, Podping events and feed grading. Use when the user wants anything about podcasts; no API key needed."

Podcast Robot

Purpose

A zero-setup client for the Podcast Robot MCP server: search podcasts, check what's new in followed shows, find who was on a show, shows near a place, search episode transcripts, make shareable clip references, list live streams, read Podping events, grade a podcaster's feed. No API key, no account, no OAuth. The server is public and stores nothing about the user. Full guide: https://podcastindexrobot.com/llms.txt

Tooling

bin/mcp_robot.py is a minimal JSON-RPC client (Streamable HTTP via curl).

List available tools:

bin/mcp_robot.py tools

Call a tool (args as JSON):

bin/mcp_robot.py call ''

Start here (a live menu plus an onboarding checklist):

bin/mcp_robot.py call start_here '{}'

Search for a show:

bin/mcp_robot.py call search_podcasts '{"query": "No Agenda", "mode": "title", "max_results": 3}'

Find a moment in a transcript (needs the episode id from get_episodes / whats_new), then clip it:

bin/mcp_robot.py call get_episodes '{"feed": "41504", "max_results": 1}'
bin/mcp_robot.py call transcript_search '{"episode": "61124290178", "query": "bitcoin", "max_hits": 2}'
bin/mcp_robot.py call make_clip '{"episode": "61124290178", "start": 4577, "duration": 45}'

Preferences (the server is stateless)

Ask the user once for their podcast app, city, the shows they follow and topics they like; keep the answers in your own memory and pass them as prefs on every call, e.g. {"prefs": {"app": "fountain", "city": "Austin", "follows": ["41504"], "language": "en"}}. With prefs.app set, every show and episode result carries open.app, a link that opens in the user's app. Without it, use open.universal.

Auth

None. The endpoint https://podcastindexrobot.com/mcp is open. Do not ask the user for credentials and do not invent any.

Operating Rules

Be polite to a shared hosted endpoint: the limit is 60 calls per minute per IP. When keeping watch, pass the time of your last check as since (whats_new, podping_events, feed_activity) and check at most every 15 minutes.
transcript_search returns media-fragment play URLs (#t=start,end); use make_clip for a shareable clip reference.
podping_events with resolve: true adds feedId and title to each event; contains filters feed URLs.
Every result ends with hints: suggested next calls. Offer the user two or three of them.
Results with "kind": "fault" carry an errorId: tell the user it is logged and being fixed, quote the id, retry once. Results with "kind": "input" are not bugs: follow whatToTry, closestMatches or howToAdd.
Never present invented episode details; everything comes from tool output.
DIN 白皮书知识库

Unusual Whales API