每个节目库​都是一个 API。

MCP：面向 AI 智能体

每个频道都通过 Streamable HTTP 开放一个匿名、只读的 MCP 服务器。它提供一个工具 search：用自然语言提问，即可得到按相关度排序的单集和有据可查、带时间戳的引文，每条都附带精确到秒的引用 URL。

https://<channel>.podhood.com/mcp

可选参数：topK、maxSegmentsPerEpisode、includeText、fast、episodeIds。每个节目库的「提问」对话框都内置 30 多种 MCP 客户端的安装指引，涵盖 Claude、ChatGPT、Cursor、VS Code 等。

频道运营者还可使用创作者 MCP：一个以用户为范围、供你自己的智能体使用的服务器，覆盖所有单集状态（含草稿），并提供频道、单集、搜索、章节和分段文字稿等工具。可通过 OAuth 登录连接（Claude 和 ChatGPT 会自动发现该流程），或以 x-api-key 请求头或 Bearer 令牌的形式发送 API 密钥。

https://podhood.com/mcp

REST：创作者 API

Every REST endpoint requires a credential: an API key, created in Studio → Settings → API keys (paid plans) and sent in the "x-api-key" header (or as a Bearer token), or an OAuth access token from the creator MCP sign-in, sent as a Bearer token. Either reads the channels its owner is a member of — every non-archived episode status included; anything else 404s. Anonymous reading of published content lives on each channel's MCP server, not on REST.

带版本的接口位于 /api/v1；每个已文档化的端点都是只读 GET，幂等、可安全重试；若有破坏性变更，将以 /api/v2 发布，并在旧版本上返回 Deprecation 与 Sunset 响应头。对你频道的单集（含草稿）进行混合搜索（语义 + 关键词）。分面筛选接受以逗号分隔的 id：topicIds、personIds、entityIds、episodeIds，另有 collectionId 和 year。传入 fast=true 可仅做关键词搜索。

curl -H "x-api-key: $PODHOOD_API_KEY" \
  "https://podhood.com/api/v1/channels/{slug}/search?query=pricing%20strategy"

REST：浏览单集

你频道单集的键集分页列表，包含所有未归档状态（可用 status 缩小范围），支持同样的分面筛选，另加 sort。把响应中的 nextCursor 作为 cursor 传回即可获取下一页。单集记录带有 mediaUrl（YouTube 观看 URL 或 RSS enclosure），因此片段时间戳可直接换算成来源深链接。

curl -H "x-api-key: $PODHOOD_API_KEY" \
  "https://podhood.com/api/v1/channels/{slug}/episodes"

REST：单集资源

文字稿文档包含标注了发言人、带逐词时间的片段，是引文、切片和带注释文字稿的原材料。错误以 JSON 返回，并带有 error 信息，绝不返回 HTML。

GET /api/v1/episodes/{episodeId}/transcript   # word-level transcript
GET /api/v1/episodes/{episodeId}/chapters     # chapters with key moments
GET /api/v1/episodes/{episodeId}/related      # topically related episodes

机器可读的接口

• OpenAPI 规范：完整的 REST 接口，带类型化参数和 operation id。
• auth.md：智能体如何认证（频道 MCP 与 Markdown 匿名开放；创作者接口需要工作室设置里的 API 密钥或 OAuth 登录）。
• llms.txt：平台索引；每个频道主机也各自提供一份，列出其单集和 MCP 端点。
• Markdown 副本：在任意单集或营销页面 URL 后追加 .md（/index.md、/pricing.md，本页为 /developers.md）。
• 每个主机都提供 sitemap.xml 和 robots.txt，欢迎 AI 爬虫；单集页面还带有 Schema.org JSON-LD（PodcastEpisode，以及章节和关键时刻的深链接 Clip 节点、发言人、实体）。