> 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.

# 想研究一个公众号，文章、正文、阅读数和评论分别怎么取？

> 从账号或文章链接开始，按历史目录、正文阅读、传播对比和读者反馈四类任务选择数据，并串成有用的研究流程。

**先用 `wechat_mp.v2.fetch_account_articles` 整理公众号的文章目录，挑出相关文章，再只对入选文章的链接读取正文、查互动数据和看可返回的评论。** 先确定研究任务：找资料、读文章、比较传播表现，还是整理读者疑问。不同研究任务需要的材料不同，对应关系见下表。

例如研究同行的新产品发布：先列出发布期间的文章，选出相关公告，读公告正文。只有互动数据或评论有助于回答研究问题时，再补取互动数据或评论。

## 如果你运营这个号，先到哪里取报表？

自己运营的公众号，报表从微信公众平台取，不走公开文章流程。

1. 用有数据权限的账号登录微信公众平台。
2. 选择正确的公众号和报表日期，核对图文阅读人数、阅读次数、分享等实际列。
3. 团队已打通官方统计接口时，用同一日期抽一篇已发布文章，对比统计接口和后台的指标与时间窗。

腾讯云的公众号开放服务说明将图文群发每日数据、图文群发总数据和用户增减数据分列，开发时按应用可用能力选择。 [微信公众平台](https://mp.weixin.qq.com/) · [腾讯云公众号接口说明](https://cloud.tencent.cn/document/product/1301/100187)

用自有报表解释一周效果时，按报表原名保留到达人数、阅读人数或次数。研究别人的公众号时，从下方的公开目录和原文开始。自有后台数据和公开互动快照分别放进各自的来源列。

## 手里有什么，就从哪里开始

* **有一篇准确的文章链接：** 直接[读取文章](/zh/guides/read-wechat-article)。文章详情返回的账号标识可以继续用来[定位公众号](/zh/faq/wechat-account-identifier)和取目录。
* **有已确认的公众号编号：** 直接[整理公众号的历史列表](/zh/guides/wechat-account-articles)，先看标题、摘要、链接和发布时间，再决定读哪些文章。
* **只有账号名称：** 先在搜一搜找账号候选，核对每个候选的简介与实际发布的文章，确认文章链接后再按第一种起点继续。核对已发文章可以避免把同名账号放进同一份材料。

按名称找账号候选时，使用 `data:wechat_search.v2.fetch_search` 的账号分类。下面是 `POST /v1/social-data/call` 的请求体，替换其中的关键词：

```json
{"action":"wechat_search.v2.fetch_search","params":{"keyword":"品牌名称","business_type":"account","offset":0,"raw":false}}
```

搜索结果用于认准账号；需要实际公众号标识时，再按[标识问答](/zh/faq/wechat-account-identifier)核对。昵称、署名作者和账号编号分列保留。

## 你要完成的事，对应哪种材料？

| 研究任务          | 取得什么                                             | 拿到后怎么用                      |
| ------------- | ------------------------------------------------ | --------------------------- |
| 看这个号一段时间都在写什么 | [历史文章目录](/zh/guides/wechat-account-articles)     | 按发布时间筛范围，再给文章做主题分类          |
| 核对一篇文章说了什么    | [返回正文及来源](/zh/guides/read-wechat-article)        | 阅读原句，给判断标上来源和适用条件           |
| 比较选中文章的传播表现   | [阅读与互动数据](/zh/faq/wechat-article-metrics)        | 记录查询时间，按可比的发布时间、头条位置和字段口径比较 |
| 整理读者在问什么      | [评论及选中讨论的回复](/zh/guides/wechat-article-comments) | 留原句与父子上下文，区分提问、自述和补充        |
| 确认账号及关联视频号    | [公众号资料与关联信息](/zh/faq/wechat-account-profile)     | 建立带来源的账号名单，分别进入文章或视频研究      |

阅读与互动数据记录的是查询时的一次观察；多次查询才有多个观察点，单次结果不是历史曲线。评论按评论动作实际返回的范围描述。精选留言适合研究具体疑问，不能代表所有读者的意见。

账号背后的登记主体、认证材料和粉丝估计是另外的任务，现有资料流程不覆盖这三项。原创文章数、关联视频号和阅读数都不能替代登记主体、认证材料或粉丝数据。

### 列了一批文章后，怎样只给入选文章取统计？

1. 用已核对的账号调用 `wechat_mp.v2.fetch_account_articles`，传 `raw:false`，保留每篇文章链接、`app_msg_id`、`idx` 和实际取到的页数。
2. 对每篇入选文章，向 `POST https://api.beatapi.io/v1/social-data/call` 发送下列请求，使用 BeatAPI Bearer 鉴权：

```json
{"action":"wechat_mp.v2.fetch_article_stats","params":{"url":"<confirmed_article_url>","raw":true}}
```

3. 在成功结果里核对 `data.read_num`，以及 `data.read_num` 的可见性与取数状态。阅读数缺失时单独记为缺失，H5 的评论计数不能填到阅读列。记录统计快照的采集时点。
4. 要比较涨幅，隔一段时间对同一篇文章再调用一次 `wechat_mp.v2.fetch_article_stats`。

要引用读者原话，改用[文章评论](/zh/guides/wechat-article-comments)，并注明评论流程返回的是精选留言范围。 [统计字段与口径](/zh/faq/wechat-article-metrics)

## 把材料串成一份能交接的研究结果

把研究任务写成具体指令，例如：

> 整理这个公众号最近一个月关于产品更新的文章，先列目录并挑出相关篇目。读选中的正文，归纳每次更新的内容、适用条件和原文依据；需要比较传播时再补互动数据。交付文章来源表和结论表，把尚待核实的问题单列。

文章来源表放标题、账号、原文链接、发布时间、查询时间和已取得的材料；结论表放你的判断、支持原句和待办。同事读结论表里的总结，再回到文章来源表逐条核对。

要持续更新，接[增量收集](/zh/guides/wechat-incremental-articles)；要放进本地资料库，接[Markdown入库](/zh/guides/wechat-to-obsidian)；要替换旧导出器，读[替代方案](/zh/faq/wechat-exporter-alternative)。

例如账号目录里有一篇功能公告和一篇迁移教程。要回答「哪些用户要迁移」，先读迁移教程正文；要比较哪篇读得更多，分别取这两篇在同一观察时点的统计，并记下每篇的发布时间。要找迁移教程还没答清的问题，读迁移教程返回的评论。材料表里分别记原句、统计时间和留言来源。

账号目录和入选文章的材料分成两张表：

* **目录表：** 一行一篇文章，记录原链接与可用摘要。
* **复盘表：** 只给入选文章加已读正文、统计快照或返回的评论。

下次查新时继续沿用目录表；已保存的材料能回答问题时，直接打开已保存的材料。

## 查询费用怎么控制？

先取文章列表、选好文章，再取正文、互动或评论。当前单价见[价格页](https://beatapi.io/zh/pricing)，列表页数和额外文章请求数分开记录。已经保存的响应可复用，本地整理与格式转换无需再次取数。

[公众号问题目录](/zh/faq/wechat)

## 给已连接工具的助手一个具体任务

> 用这个已确认的公众号整理近期安装教程。先列文章标题、日期和链接，再选两篇读正文。列出安装条件、步骤与原文出处；只有摘要的文章标为目录线索。需要比较阅读或互动时，另列查询时点和字段状态。

助手先用预览选对象。需要引用时，助手读取已保存的结果或补取具体对象。要求助手写明实际读了哪些材料、覆盖到什么范围。 [操作流程](/zh/guides/wechat-python-article-review) · [连接和结果阅读](/zh/faq/assistant-social-research)。