用 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.mdAPI:
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 期没取到”,三选一,但一定要让人看得见。静默失败是内部工具失去信任的原因,一份没人信的简报还不如没有。


