> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 今日头条指南

> 按文章链接读取今日头条教程和评论，把实际问题整理成能回查的文档修改清单。

要决定安装教程下一版该改哪些步骤，用 `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 鉴权。

```json
{"action":"toutiao.app.get_article_info","params":{"group_id":"123"}}
```

核对返回内容对应原文章，记录标题、版本、原链接和请求号。文章演示的是旧版菜单时，在评论表里加一列版本，方便分开比较新旧版本的使用体验。

## 从同一篇文章读首批评论

```json
{"action":"toutiao.app.get_comments","params":{"group_id":"123","offset":"0"}}
```

读取成功后，从返回的评论里找和安装有关的原句。需要再看一批时，保留同一个 `group_id`，用字符串 `"20"` 作为下一次的 `offset`。材料已经够用，或结果为空、重复时，记下停在第几批和停止原因。

## 把评论变成修改清单

| 评论原句示例      | 要对照的文章内容   | 给文档团队的下一步     |
| ----------- | ---------- | ------------- |
| 「新版找不到这个按钮」 | 文章演示的版本和截图 | 核对新版入口，确认后补图  |
| 「不知道要先插哪根线」 | 安装顺序是否明确   | 补一张步骤图，标出先后顺序 |

每一行保留文章链接、评论原句、实际核对的版本和评论请求号。只写了「同问」的回复，先查清父评论的上下文，再归组。文章详情请求和每一批评论请求分别计费。[核对作品 ID 和评论分页](/zh/faq/toutiao) · [BeatAPI 价格页](https://beatapi.io/zh/pricing)

## 同一篇攻略有几个版本，怎么确认原作者？

同事转来一篇安装攻略、而同名文章有好几篇时，把文章和发布方分别核对：

1. 用原文章的 `group_id` 读文章详情，记录标题、发布时间和署名。
2. 能确认对应的头条作者主页时，在同一个 API 客户端里把完整主页链接传给 `toutiao.app.get_user_id`。

```json
{"action":"toutiao.app.get_user_id","params":{"user_profile_url":"<完整的头条作者主页链接>"}}
```

3. 从返回中确认 `user_id`，再用 `{"action":"toutiao.app.get_user_info","params":{"user_id":"<确认后的用户ID>"}}` 核对账号资料。
4. 交给编辑时分两列：「发布账号」和「文内署名或转载来源」。发布账号和文内署名不同时，两项都保留，核实原出处后再合并记录。

头条的[家电安装报道](https://www.toutiao.com/article/7415896566721954314/)同时列出了发布账号和转载来源，可以用来理解这两列的区别。

把核对交给 AI 助手时，可以这样问：「请先确认这两条链接各自的发布账号、文内署名和发布时间，再找评论里与安装步骤相关的疑问。每条附原文链接，最后给我一张文档待改清单。」缺少作者主页时，先用已确认的文章和评论完成清单，并在来源栏标注账号待核。

## 把同事发来的文章链接变成请求文件

同事给你的脚本提供文章链接时，先校验链接，再生成请求。`build_request.py` 接收路径形如 `/article/<id>/` 的头条 HTTPS 完整链接。拿到分享短链时，先打开短链，确认跳转到哪篇文章。每篇文章在新目录里运行 `build_request.py`，让请求文件和响应文件一一对应。

把下面的脚本保存为 `build_request.py`。发送请求前，把示例地址换成你的文章链接。

```python
import json
import re
import sys
from urllib.parse import urlsplit

source_url = sys.argv[1].strip()
url = urlsplit(source_url)
match = re.fullmatch(r"/article/([0-9]+)/?", url.path)
if url.scheme != "https" or url.netloc.lower() not in {"toutiao.com", "www.toutiao.com"} or not match:
    raise SystemExit("Use the verified full Toutiao article URL.")
with open("article-request.json", "x", encoding="utf-8") as output:
    json.dump({"action":"toutiao.app.get_article_info","params":{"group_id":match[1]}}, output)
```

```bash
python3 build_request.py 'https://www.toutiao.com/article/123/' &&
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @article-request.json -o article-response.json
```

## 确认返回的是同一篇文章

把原文章链接和 `article-request.json`、`article-response.json` 存在一起。查看响应状态和请求号，核对返回的标题、发布账号与原链接一致后，再摘录文章内容或补读评论。请求失败或文章身份仍有疑问时，把这一条标为待核。[区分图文和视频的作品 ID](/zh/faq/toutiao)