今日头条指南
要决定安装教程下一版该改哪些步骤,用 toutiao.app.get_article_info 读今日头条文章,用 toutiao.app.get_comments 读同一篇文章的评论,再交给同事一张修改清单,每一行都带评论原句、文章链接和请求号。需要确认原作者时,用 toutiao.app.get_user_id 和 toutiao.app.get_user_info 核对作者主页。
先读文章,确认教程讲的是哪个版本
从 https://www.toutiao.com/article/123/ 这类链接取作品 ID,把示例 ID 123 换成实际 ID。把下面的 JSON 请求体依次 POST 到 https://api.beatapi.io/v1/social-data/call,在请求头用 BeatAPI Bearer 鉴权。
核对返回内容对应原文章,记录标题、版本、原链接和请求号。文章演示的是旧版菜单时,在评论表里加一列版本,方便分开比较新旧版本的使用体验。
从同一篇文章读首批评论
读取成功后,从返回的评论里找和安装有关的原句。需要再看一批时,保留同一个 group_id,用字符串 "20" 作为下一次的 offset。材料已经够用,或结果为空、重复时,记下停在第几批和停止原因。
把评论变成修改清单
每一行保留文章链接、评论原句、实际核对的版本和评论请求号。只写了「同问」的回复,先查清父评论的上下文,再归组。文章详情请求和每一批评论请求分别计费。核对作品 ID 和评论分页 · BeatAPI 价格页
同一篇攻略有几个版本,怎么确认原作者?
同事转来一篇安装攻略、而同名文章有好几篇时,把文章和发布方分别核对:
- 用原文章的
group_id读文章详情,记录标题、发布时间和署名。 - 能确认对应的头条作者主页时,在同一个 API 客户端里把完整主页链接传给
toutiao.app.get_user_id。
- 从返回中确认
user_id,再用{"action":"toutiao.app.get_user_info","params":{"user_id":"<确认后的用户ID>"}}核对账号资料。 - 交给编辑时分两列:「发布账号」和「文内署名或转载来源」。发布账号和文内署名不同时,两项都保留,核实原出处后再合并记录。
头条的家电安装报道同时列出了发布账号和转载来源,可以用来理解这两列的区别。
把核对交给 AI 助手时,可以这样问:「请先确认这两条链接各自的发布账号、文内署名和发布时间,再找评论里与安装步骤相关的疑问。每条附原文链接,最后给我一张文档待改清单。」缺少作者主页时,先用已确认的文章和评论完成清单,并在来源栏标注账号待核。
把同事发来的文章链接变成请求文件
同事给你的脚本提供文章链接时,先校验链接,再生成请求。build_request.py 接收路径形如 /article/<id>/ 的头条 HTTPS 完整链接。拿到分享短链时,先打开短链,确认跳转到哪篇文章。每篇文章在新目录里运行 build_request.py,让请求文件和响应文件一一对应。
把下面的脚本保存为 build_request.py。发送请求前,把示例地址换成你的文章链接。
确认返回的是同一篇文章
把原文章链接和 article-request.json、article-response.json 存在一起。查看响应状态和请求号,核对返回的标题、发布账号与原链接一致后,再摘录文章内容或补读评论。请求失败或文章身份仍有疑问时,把这一条标为待核。区分图文和视频的作品 ID

