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

# 怎样用 n8n 定时查新公众号并把新文章发到飞书群？

> 用已确认的公众号名单查找新文章，去重后汇总标题和链接到飞书群。

要把公众号新文章汇总发到飞书群，在 n8n 里搭一个工作流：对名单上每个核对过的 `username` 调用 `wechat_mp.v2.fetch_account_articles`，把文章记进 **Data Table**，只把上次检查后新增的文章发给飞书自定义机器人。例如编辑团队每天要看十几个公众号，群里每次只需要一条新增文章汇总。首次执行只为每个账号建立基线，不发提醒。已有历史文章要补齐时，另跑[历史归档](/zh/guides/wechat-account-articles)。

[n8n 接入设置](/zh/integrations/n8n) · [公众号请求遇到频率限制怎么办](/zh/faq/wechat-frequency-error)

## 在 n8n 搭一轮

1. 先用 **Manual Trigger**，在 **Edit Fields** 放一个核对过的 `username`。之后改为从名单读取，每个账号输出一项。记录每个账号的扫描结果，某个账号失败时只补跑这个账号。
2. 添加 **HTTP Request**，向 `https://api.beatapi.io/v1/social-data/call` 发 POST，选择 **Header Auth** 凭据并配置 `Authorization: Bearer <BEATAPI_API_KEY>`。JSON 正文切到 Expression，填入下面的表达式；首次请求的 `offset` 留空。

```javascript
{{ { action: 'wechat_mp.v2.fetch_account_articles', params: { username: $json.username, offset: '', item_show_type: 0, raw: false } } }}
```

3. 拆成文章项之前，确认响应的 `status` 为 `succeeded`、`error` 为空、`data.articles` 是数组。
   * `data.articles` 为空数组时，记为这次请求没有返回文章。
   * 请求失败或字段结构不符时，记录请求号，停在这个账号，不推进这个账号的扫描进度。
   * 需要翻页时，沿用同一账号和栏目，把 `data.next_offset` 传回。遇到 `is_end` 为 1、游标为空或重复、或到达预设页数时停止。到达页数上限仍没扫到旧边界时，把这个账号标为未扫齐。
4. 在 **Data Table** 创建 `article_key`、`title`、`url`、`delivery_state` 四列。
   * 用 `data.biz_username`、文章的 `app_msg_id` 和 `idx` 组成 `article_key`，每页先按 `article_key` 合并重复项。键不完整的文章暂留审核队列。
   * 首次执行把所有文章写成 `baseline`；之后只把表里没有的文章键写成 `pending`。
   * 使用 **Upsert** 时，先确认 **Upsert** 不会把已有的 `sent` 改回 `pending`。
   * 执行可能重叠时，让工作流串行执行，或改用能对 `article_key` 设唯一约束的存储。

## 用两次运行确认哪些文章该发

| 编辑团队看到的情况                         | 表里怎么记                                       | 群里应该出现什么       |
| --------------------------------- | ------------------------------------------- | -------------- |
| 周一首次接入「产品周报」，列表已有《安装手册》和《常见问题》    | 两篇作为这个账号的 `baseline`                        | 无通知            |
| 周二「产品周报」发了《新版上线》和《迁移须知》，两篇属于同一次群发 | 两篇的 `app_msg_id` 相同，`idx` 不同，各写一行 `pending` | 一条摘要，两篇文章各有链接  |
| 周二重跑，同一批已确认送达                     | 保留两行 `sent`                                 | 无重复通知          |
| 周三名单加了「社区动态」，「社区动态」已有十篇文章         | 只给新账号建立基线，「产品周报」继续查新                        | 只提醒已建基线账号的新增文章 |

每个账号单独记录上次扫齐时的边界，例如一组近期文章键：

1. 每轮从首页开始查。
2. 往后翻到包含旧边界的那一页，并处理这一页的所有文章。
3. 只看到置顶文章或跨页重复的旧文时，继续翻到设定的边界。
4. 游标异常或页数用完仍没扫到边界时，保留原边界。已经找到的文章可以先入表，下次从首页补扫时按 `article_key` 去重。

把「每个账号扫到哪里」和「哪几篇文章已发到群」分开存。比如周二找到两篇新文，飞书发送超时，两篇文章还挂在批次 MP-002 上。周三即使查新为空，也先查批次 MP-002 是否已送达，再决定是否补发。周二如果还有一个账号没扫到旧边界，周三单独补扫这个账号。

## 把本轮的新文章汇总发到群里

1. 在目标飞书群的群设置里添加**自定义机器人**，把机器人的 Webhook 放进运行环境的受保护配置。
2. 按群配置满足机器人的关键词、签名或 IP 策略。开启签名时，按飞书文档为每次请求生成新的 `timestamp` 和 `sign`。
3. 添加第二个 **HTTP Request**，向 Webhook 地址 POST 下面的 JSON 消息。消息写明账号、标题、链接和批次编号，便于回查。

```json
{"msg_type":"text","content":{"text":"公众号查新｜批次 MP-001\n示例账号｜本周安装手册更新\nhttps://mp.weixin.qq.com/s/example"}}
```

正式启用前，先测试发送这一步：

1. 用一条已保存记录发到测试群。
2. 飞书返回 `code: 0` 后，才把本批的 `pending` 改为 `sent`。
3. 发送前保存批次编号和本批的文章键，后续核对和补发都沿用这组记录。
4. 发送超时或状态写入失败时，先在群里按批次编号确认是否已送达，再决定是否补发。
5. 没有 `pending` 文章时跳过发送。已入表但未确认送达的批次仍要处理，即使这一次没有查到新文章。
6. 一条新记录发送成功、同一批重跑也验证过之后，换成 **Schedule Trigger**，设好工作流时区并发布工作流。

需要入选文章的正文时，从入选 URL 接[单篇 n8n 读取](/zh/guides/wechat-n8n-read)。

预算按各账号实际请求的列表页数计算，正文请求和重试另计，[价格见 BeatAPI 价格页](https://beatapi.io/zh/pricing)。最后检查三项结果：同批重跑只保留一条提醒，某个账号失败能单独补跑，推送里的每个链接都能打开对应文章。

[定时节点](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/) · [数据表节点](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.datatable/) · [飞书自定义机器人](https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot?lang=zh-CN)