跳到导航

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

可以。给飞书多维表格加一条自动化,让自动化向 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 文本。

{"action":"wechat_mp.v2.fetch_article_detail_h5","params":{"url":"<article_url>"}}
{"action":"xiaohongshu.app_v2.get_image_note_detail","params":{"share_text":"<image_note_share_link>"}}

第二个请求体读取小红书图文笔记。视频笔记改用对应的分享链接动作。

配置出参并更新当前行

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

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

一行跑完应该是什么样?

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

一周收 30 篇文章,只补标题需要 30 次详情请求;其中 8 篇再核对互动,共 38 次请求。详情和互动的单价分别见 BeatAPI 价格页。

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

例如用 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"}。成功时才修改触发行;出错时保留旧值,把抓取状态设为「待核对」。

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 请求和出参限制 · 从外部用 CLI 写入飞书