用途:为拟邀嘉宾寻找在内容定位与近期编辑方向上契合的播客节目,产出带来源的候选清单和选题角度。
主要能力:通过 Crawlora 的 Apple Podcasts 数据集与接口做节目发现、单集检索和公开网站抓取,并可用 Spotify 播客接口交叉核对同一节目。
使用方式:设置环境变量 CRAWLORA_API_KEY(来自 crawlora.net),运行技能目录下的 scripts/crawlora.sh,脚本会向 https://api.crawlora.net/api/v1 发送 x-api-key。接口细节见 reference/endpoints.md。示例: scripts/crawlora.sh /datasets/apple-podcasts-shows/search q=founder page_size=5 scripts/crawlora.sh /apple-podcasts/episodes/search term="bootstrapped business" country=us limit=10
发现与契合度:先明确嘉宾专长、可信案例、拟谈主题、语言、受众与地域限制。用 /datasets/apple-podcasts-shows/search 及 facets 找候选;该数据集的 q 只搜标题/作者,不搜单集库;country 指发现用的商店,不代表听众地域或完整可获取性;sort=popularity 依据榜单种子排名,不代表下载量。可用 /apple-podcasts/episodes/search?term=... 或实时节目搜索扩展主题,确认节目与创作者并保留 Apple 节目 ID。目录为榜单/搜索抽样,并非全部播客。读取 /apple-podcasts/show/{id} 与 /show/{id}/episodes,查看近期发布日期、简介与嘉宾/访谈证据;单集列表可能有上限,需记录已核查范围。可用 /spotify-podcasts/search?q=... 解析同一节目,将返回的 spotify:show:... URI 传给 /spotify-podcasts/show 与 /spotify-podcasts/show/episodes(offset、limit 最大 50)。Apple 数字 ID 与 Spotify URI 是不同身份,合并前需按创作者/标题/网站核对。必要时用 /web/scrape 查看官方节目网站或单集说明,核实投稿说明与公开职业联系方式;仅用短摘录,区分简介与完整文字稿,不得仅凭元数据声称听过某集。
交付与边界:返回节目/主播、规范链接与 ID、契合理由、带日期的近期单集证据、建议角度、已核实的投稿渠道(如有)及注意事项;把已调研联系人与草拟提案文案分开,仅在要求时发送。跨平台去重需依据已核实的身份/feed 证据,不能仅凭通用标题合并。在实时单集列表中检查时效性;高集数或旧榜单种子不能证明节目活跃。保留缺失日期与覆盖空白。排名、评分与集数不能证明受众规模、受众画像、赞助价格或转化潜力。遵守数据集 page_size<=100 与 10,000 条结果窗口;遇到重复页、偏移耗尽或达到候选上限即停止;429 退避,瞬时 5xx 重试一次,401/403 停止,并检查应用代码。