跳到主要内容

用 Podwise CLI 和 API 搭一条播客阅读流水线

从找单集到定时发出,附命令和接口,让每周简报自己跑起来。

指南5 min read

定时跑起来的播客摘要流水线

每个团队都遇到过这个问题的某个版本:值得听的播客有十几个,却没人有空听,而周五发小结的人换岗了。读者已经够努力了,缺的是一条没人记得也能自己跑的流水线。

下面是我们一直在用的搭法,一共五个阶段,每个阶段都小到可以单独排查。

第一阶段:找单集

先从手头现成的东西开始找:你关注的节目、一个搜索词,或者别人甩来的一条链接。

CLI:

podwise search episode "developer hiring" --limit 20
podwise popular

用 API 的话,/api/open/v1 下面有一组接口,可以按关键词搜单集,可以拉某个节目的单集列表,也可以直接拿热门。如果你手里已经有确定的单集,这一步可以直接跳过:https://app.podwise.ai/dashboard/episodes/1234567 这个地址里的 seq 数字,就是后面每一步需要的全部信息。

第二阶段:狠狠筛

这条流水线要想成立,前提是敢扔东西。下面两个筛子最值回票价:

  • 节目白名单。 只收十个节目,不要整个索引。没人点名要的简报就是噪音。
  • 时间。 只要最近七天。补旧账是另一项任务,还会烧掉你的点数。

如果你在 Podwise 里已经关注了节目,list_followed_episodes 会直接返回带日期的新单集,这样可以省掉一次搜索。

第三阶段:取内容

已经处理过的内容随便取用,都不扣点数;只有处理新内容才要花钱,一期(或一个视频)一个点数,所以这一步要诚实记账。

CLI 直接往 stdout 输出,天生就是为这一步准备的:

podwise get summary https://app.podwise.ai/dashboard/episodes/1234567 > summary.md

API:

curl -s "https://app.podwise.ai/api/open/v1/episodes/1234567/summary" \
  -H "Authorization: Bearer $PODWISE_TOKEN"

拿回来的摘要是分好版块的,有 overview、takeaways,还有 chapters 和 highlights。问答、关键词和脑图按需索取,接口文档里列了完整的字段表。

还没处理的:

podwise process https://app.podwise.ai/dashboard/episodes/1234567

接下来就是等。处理是异步完成的,去轮询状态接口,不要猛刷摘要接口。

第四阶段:存下来

原始输出一定要留下来,可以是一期一个 JSON 文件,也可以是表格里的一行,每行存四个字段:seq 认单集,show 认节目,published 认时间,summary 存摘要。这个理由听起来无聊,但很决定性:当有人问“这句话是从哪来的”,你能在十秒内答出来。

存 Markdown 时,把源链接放在顶部;存 JSON 时,字段名按 API 返回的原样保留,不要把 takeaways 改成 bullets,否则渲染挂了都不知道问题在哪。

第五阶段:发出去

下面三种形状,能覆盖多数团队:

  • Markdown 简报:提交进仓库再编译成页面,每个单集一个标题,配三条结论,并链回原文。
  • 周五的 Slack:同样的内容换个格式,再加一句“这期值得完整听”。
  • Notion 库:按节目和日期进库,归档之后可以搜索。

排版可以用模板,但挑哪两期、为什么值得注意,这个决定省不了。一份什么都列的简报就是信息流,而信息流会被人免打扰。

定时和钱

流水线一周跑一次就行,不用一小时一次。做法是周五 06:00 的一条 cron,跑一个任务,配上超时,再给每期记一行日志。

有两个花钱的地方:

  • 点数。 发现节目、阅读已经处理好的单集都不扣点数,只有处理新单集才会扣。在脚本里写死上限:一次超过十期就停下来问人。
  • 限流。 企业版 API 允许每用户每小时调用 10,000 次;如果返回 429,就按 Retry-After 头等一会儿再试。每周只跑一次的任务基本碰不到上限,除非哪里写循环了。

认证只需要一个 token:在 Settings › Developer(设置 › 开发者) 页面里建一个,请求时走 Bearer 头,放在环境变量里,不要写进仓库。认证页里有 CLI 自己的登录方式说明。

为什么不用 MCP server

如果输出是给人看的,让助手装上 Podwise 插件,在聊天里就能干完前四步,MCP 指南是更短的路。

流水线回答的是另一种情形,没人开口也要有输出。每周五页面自己重建,表格自己变厚,任务在半夜自己跑。数据是一样的数据,触发方式不一样。

大家都跳过的那步

把流水线失败时怎么办写下来:空简报、过期简报,或者在 Slack 里说一句“3 期没取到”,三选一,但一定要让人看得见。静默失败是内部工具失去信任的原因,一份没人信的简报还不如没有。

Podwise

跳过那六个步骤。 直接听就好。

Podwise 帮你把任何一期节目转写、摘要,并画成思维导图。