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

# 在飞书多维表格粘贴链接后，怎样自动补齐公众号文章或小红书笔记？

> 用飞书多维表格的 HTTP 自动化读取单条来源，再更新触发记录。

可以。给飞书多维表格加一条自动化，让自动化向 BeatAPI 发送 HTTP 请求，再更新触发它的那条记录。例如运营把公众号文章链接贴进选题表后，自动化调用 `wechat_mp.v2.fetch_article_detail_h5` 取回标题，写到原来那一行。要看阅读和点赞时，再只给选中的文章加一次统计查询。小红书图文也能用同一张表：先由中间步骤从 `xiaohongshu.app_v2.get_image_note_detail` 的详情里选出对应笔记，再写回标题。

先建**来源**、**链接**、**抓取状态**、**标题**、**请求号**、**更新时间**和**人工备注**七列。拿一篇团队熟悉的公众号文章跑一遍，核对标题回填到了原行，选题备注也还在。

## 在飞书设置触发和 HTTP 请求

打开多维表格的**自动化**，触发条件设为记录满足条件：链接已填，抓取状态为「待抓取」。按**来源**分支选择请求体，在每个分支添加**发送 HTTP 请求**：方法选 POST，URL 填 `https://api.beatapi.io/v1/social-data/call`，请求头设 `Content-Type: application/json` 和 `Authorization: Bearer <BEATAPI_API_KEY>`。密钥放在访问受限的自动化配置或受保护的中转服务里；能看到请求头的流程编辑者，等于能看到密钥。

请求体选 `raw` JSON，用变量选择器插入触发记录的链接字段，替换下面的占位值。先用一个确认能打开的链接，检查变量传入的是 URL 文本。

```json
{"action":"wechat_mp.v2.fetch_article_detail_h5","params":{"url":"<article_url>"}}
```

```json
{"action":"xiaohongshu.app_v2.get_image_note_detail","params":{"share_text":"<image_note_share_link>"}}
```

第二个请求体读取小红书图文笔记。视频笔记改用[对应的分享链接动作](/zh/faq/xiaohongshu-share-links)。

## 配置出参并更新当前行

* **公众号文章。** 出参响应体选 JSON，用已保存的成功响应样例定义可引用字段。检查 `status`、`request_id` 和 `data.content.title`，确认返回的文章对应触发链接。下一步添加**修改记录**，目标取触发记录的 ID，只更新自动化负责的字段。
* **公众号互动指标。** 需要时另设一个流程，调用 `wechat_mp.v2.fetch_article_stats`，传同一个 `url` 和 `raw:true`。按[阅读与互动口径](/zh/faq/wechat-article-metrics)映射实际取得的字段和采集时间；有展示或取数限制时记录状态。已验证的零值回填为 0；缺失值留空，或沿用旧值并注明旧值的观察时间。
* **小红书。** 详情对象位于 `data.data[].note_list[]`，飞书 HTTP 出参只能整体引用这个数组。把原响应交给能解析 JSON 的中间步骤（见文末一节），按已确认的笔记 ID 选中唯一一条笔记，再返回可映射的标题、ID、查询状态和请求号。只有分享链接时，先核对分享链接和返回的笔记是同一条。出现多个候选或身份不符时记「待确认」，保留原值。

编辑可能在查询期间换掉链接。发请求时把记录 ID 和查询用的链接一起保存；回填前核对当前链接和查询链接是否一致。比如同一行从活动 A 换成活动 B，A 的查询结果稍后才返回，就让 B 保持「待抓取」。流程能重新读取记录时，把这个核对放在「修改记录」之前；否则先把结果交给运营确认，再写入。

## 一行跑完应该是什么样？

假设编辑贴进一篇《秋季活动报名指南》，备注填「待确认活动日期」。详情查询成功后，同一行的**标题**变为「秋季活动报名指南」，**抓取状态**变为「已回填」，并写入本次请求号和时间；编辑的备注保持不变。之后查询互动数据时，阅读量字段实际返回 `0` 就写 `0`；字段没有返回时留空，或保留旧数字并标注旧数字的采集时间，避免排选题时把真实的 0 和缺失混在一起。

一周收 30 篇文章，只补标题需要 30 次详情请求；其中 8 篇再核对互动，共 38 次请求。详情和互动的单价分别见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

## 小红书数组怎么变成飞书能引用的字段？

例如用 n8n 做中间步骤。小红书分支把**分享链接和已确认的笔记 ID** POST 给一个受鉴权保护的 n8n **Webhook**。Webhook 后面依次接 **Edit Fields → HTTP Request → Code → Respond to Webhook**。Edit Fields 从 Webhook 正文取出这两个字段，节点命名为 `Note input`。HTTP Request 使用 BeatAPI 凭据，按上面的图文请求体取一条笔记，只输出 JSON 正文。这样飞书只调用一次中转，BeatAPI Key 留在 n8n 里。

把下方 Code 节点设为 **Run Once for Each Item**。飞书 HTTP 出参用 Code 节点返回的扁平对象作样例，例如 `{"title":"示例标题","note_id":"example","request_id":"example"}`。成功时才修改触发行；出错时保留旧值，把抓取状态设为「待核对」。

```javascript
const response = $json;
const expectedId = $('Note input').item.json.note_id;
const result = response.data;
if (response.status !== 'succeeded' || response.error != null ||
    response.action !== 'xiaohongshu.app_v2.get_image_note_detail' ||
    !response.request_id || !expectedId || result?.success === false ||
    (result?.code !== undefined && result.code !== 0) || !Array.isArray(result?.data)) {
  throw new Error('Expected a successful image-note result and verified note ID');
}
const matches = result.data
  .flatMap(group => Array.isArray(group?.note_list) ? group.note_list : [])
  .filter(note => note?.id === expectedId);
if (matches.length !== 1 || typeof matches[0].title !== 'string' || !matches[0].title.trim()) {
  throw new Error('Expected one matching note with a title');
}
return { json: { title: matches[0].title, note_id: expectedId, request_id: response.request_id } };
```

上线前按四步测试：

1. 用同一测试行跑两次，检查两次更新的都是这条记录，人工备注完好。
2. 模拟一条失败的输入，确认旧标题仍在。
3. 收到超时时，先在运行记录里查到原请求的结果，再决定是否重试。
4. 手工复跑时把抓取状态改回「待抓取」，避免修改标题时触发循环。

[飞书发送 HTTP 请求和出参限制](https://www.feishu.cn/hc/zh-CN/articles/410063847664-多维表格自动化发送-http-请求功能介绍) · [从外部用 CLI 写入飞书](/zh/guides/wechat-to-feishu)