shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析无需 API Key

采集红薯笔记到飞书多维表格

当用户提供飞书/Lark 多维表格链接，并要求从该表格模板读取小红书笔记链接、采集笔记标题/正文/点赞收藏评论数/账号/封面并写回同一可见视图记录时使用。

person作者: user_88ed8f47hubcommunity
download下载资源包

采集小红书笔记到多维表格（feishu-xhs-note-sync）

一个飞书 Base 自动化 Skill：你只需把小红书笔记链接放进飞书多维表格的「笔记信息」字段，Skill 会自动采集笔记标题、正文、封面、互动数和账号信息，并写回同一行。

核心能力

读取飞书 Base 当前视图 → 提取小红书笔记链接 → 采集公开笔记数据 → dry-run 预览 → 授权后写回飞书 → 自动复查写入结果。

适用场景

| 场景 | 说明 | | --- | --- | | 爆款笔记拆解 | 批量收集同行或竞品爆款笔记，自动补齐标题、正文、互动数和账号 | | 选题库搭建 | 把日常收藏的小红书链接沉淀成可筛选、可复盘的内容库 | | 素材库整理 | 将笔记正文、封面、互动数据统一整理到飞书 Base | | 竞品内容观察 | 只处理某个视图筛选出来的竞品笔记，不扫描整张表 | | 团队协作 | 运营同学填链接，AI Agent 负责补齐结构化字段 |

依赖与准备

本 Skill 依赖三个条件：

  1. 飞书多维表格模板 —— 存放小红书笔记链接，并接收采集结果。
  2. 已认证的 lark-cli —— 用于飞书 Base 的读写。
  3. 可访问公开小红书笔记页的网络环境。

飞书多维表格模板

作用：存放小红书笔记链接，并接收采集后的结果。

模板必须包含以下字段（字段名不可改，Skill 不会增删改字段）：

| 字段类型 | 字段名 | 说明 | | --- | --- | --- | | 来源字段 | 笔记信息 | 放小红书笔记链接，可以是 xhslink.com 短链或 xiaohongshu.com 链接 | | 目标字段 | 笔记标题 | 写入笔记标题 | | 目标字段 | 笔记内容 | 写入笔记正文 | | 目标字段 | 封面链接 | 写入封面图片链接 | | 目标字段 | 点赞数 | 写入点赞数 | | 目标字段 | 收藏数 | 写入收藏数 | | 目标字段 | 评论数 | 写入评论数 | | 目标字段 | 账号 | 写入发布账号昵称 |

建议直接复制官方模板使用，避免字段名不一致导致写入失败。 官方模板：https://yulu-tech.feishu.cn/base/GeBrboz1QatjljsmFTKcRSA5nXf?table=tblkBmkE0ytnAKSu&view=vewk4K2vGi

lark-cli —— 飞书读写工具

作用：读取飞书 Base 当前视图记录，并把采集结果写回同一行。

在 WorkBuddy / Codex 环境中，如果飞书连接器已经配置好，通常不需要额外安装；只需要确认 lark-cli 已能正常访问你的飞书账号。

验证方式：

lark-cli auth status

或：

lark-cli whoami

如果能看到当前飞书身份，说明认证可用。

WorkBuddy 外独立复现

如果你想在自己的终端里手动运行，需要安装 lark-cli：

npm install -g @larksuite/cli

登录授权：

lark-cli auth login

验证：

lark-cli auth status

表格链接要求

使用时必须提供包含 base、table、view 的飞书多维表格链接，例如：

https://xxx.feishu.cn/base/<base_token>?table=<table_id>&view=<view_id>

必须包含：

| 参数 | 说明 | | --- | --- | | base_token | 飞书 Base 应用 ID | | table | 表格 ID | | view | 视图 ID |

Skill 不会猜缺失参数。链接里没有 table 或 view 时，会直接停止。

采集字段说明

Skill 会从小红书公开笔记页中提取以下数据：

| 小红书数据 | 写入飞书字段 | | --- | --- | | title | 笔记标题 | | desc | 笔记内容 | | interactInfo.likedCount | 点赞数 | | interactInfo.collectedCount | 收藏数 | | interactInfo.commentCount | 评论数 | | user.nickName / user.nickname | 账号 | | 桌面端无中心水印封面、视频封面或首图 | 封面链接 |

未知互动数会留空，不会写成 0。这是为了避免把「没采到」误判成「真实为 0」。

完整运行流程

第一步：复制飞书模板

打开模板链接，复制一份到自己的飞书空间。复制后，在「笔记信息」字段填入要采集的小红书笔记链接。

第二步：把 Base 链接发给 Agent

链接必须是具体视图链接，包含 table 和 view 参数。

推荐话术：

使用 $feishu-xhs-note-sync 采集这个飞书 Base 当前视图里的小红书笔记，并先 dry-run：
<你的飞书 Base 链接>

第三步：先 dry-run 预览

Skill 会先运行预览模式：

python3 scripts/feishu_xhs_note_sync.py \
  --base-url '<FEISHU_BASE_URL>' \
  --dry-run

dry-run 会展示：

| 内容 | 说明 | | --- | --- | | record_id | 即将处理的飞书记录 ID | | source_url | 从「笔记信息」里提取到的小红书链接 | | fields | 计划写回的字段和值 | | 成功/跳过/失败数量 | 本次处理概况 |

dry-run 不会写回飞书。

第四步：确认后写回

只有你明确授权写回后，才运行写入模式：

python3 scripts/feishu_xhs_note_sync.py \
  --base-url '<FEISHU_BASE_URL>' \
  --write

写入后，Skill 会按记录 ID 重新读取飞书数据，并检查写入结果是否一致。

关键执行边界（Hard Rules）

  • 只处理链接中 view 当前可见的记录
  • 不扫描整张表
  • 不新增字段
  • 不删除字段
  • 不重命名字段
  • 不修改字段类型
  • 不覆盖已有目标字段
  • 任意目标字段已有值时，整行跳过
  • 不清洗小红书短链参数，使用「笔记信息」里找到的第一个原始小红书链接
  • 单条失败不会影响其他记录继续处理
  • 不记录 token、cookie、密钥或 .env 内容

三种典型使用模式

模式 A：批量补齐空白素材库

适用场景：你已经收集了一批小红书笔记链接，但表格里只有链接，没有标题、正文、互动数。

流程：

  1. 把链接粘贴到「笔记信息」
  2. 发 Base 视图链接给 Agent
  3. Agent dry-run
  4. 确认无误后写回
  5. 得到完整素材库

适合做：爆款笔记拆解、选题库、竞品笔记库、账号内容观察表。

模式 B：只处理筛选后的某个视图

适用场景：一张表里有很多笔记，但你只想处理某个分类、某个账号、某个状态的记录。

做法：

  1. 在飞书 Base 里建一个视图
  2. 用筛选条件圈定要处理的记录
  3. 复制这个视图的链接
  4. 发给 Agent 执行

Skill 只会处理这个视图可见的记录，不会处理其他视图或隐藏记录。

模式 C：保留人工整理内容，只补新链接

适用场景：表格里已有部分人工填写的标题、正文或封面，不希望被 AI 覆盖。

Skill 默认规则是：只要目标字段中任意一个已有值，就跳过整行。这样可以避免：

  • 覆盖人工修正过的标题
  • 覆盖人工编辑过的正文
  • 覆盖已经筛选过的封面链接
  • 把旧数据重复写一遍

输出与交付

写回完成后，Agent 通常会在聊天里汇报：

处理完成：成功 N，跳过 N，失败 N

如果有失败，会列出失败记录 ID 和原因，例如：

失败 recxxxx：笔记信息中没有小红书链接

写入结果以飞书 Base 为准，聊天窗口只汇报处理概况，不会把整张表导出到本地。

故障排查

飞书链接缺少 table 或 view

原因：复制的不是具体视图链接。

处理方式：

  • 打开飞书 Base
  • 进入要处理的表格和视图
  • 复制浏览器地址栏完整链接
  • 确认链接里包含 table= 和 view=

字段名不匹配

原因：表格字段没有按模板创建，或字段名有改动。

检查字段：

  • 笔记信息
  • 笔记标题
  • 笔记内容
  • 封面链接
  • 点赞数
  • 收藏数
  • 评论数
  • 账号

字段名需要完全一致。

记录被跳过

常见原因：目标字段里已经有值。

这是正常保护机制。只要以下任意字段已有内容，整行就会跳过：

  • 笔记标题
  • 笔记内容
  • 封面链接
  • 点赞数
  • 收藏数
  • 评论数
  • 账号

小红书链接没有识别到

原因可能是：

  • 「笔记信息」里没有小红书链接
  • 链接不是 xhslink.com 或 www.xiaohongshu.com
  • 链接被拆成了多段文本
  • 单元格里放的是截图或不可解析内容

处理方式：把完整笔记链接以文本形式放入「笔记信息」。

小红书页面无法解析

可能原因：

  • 笔记已删除
  • 笔记设为不可访问
  • 网络访问小红书失败
  • 页面结构变化
  • 小红书风控导致公开页面信息不完整

处理方式：

  • 手动打开链接确认是否能访问
  • 换网络环境再试
  • 单独测试失败记录
  • 如果多条同时失败，可能需要维护脚本解析逻辑

互动数为空

这不一定是错误。

Skill 的规则是：未知互动数留空，不写 0。只有明确采集到数值时，才会写入点赞数、收藏数、评论数。

lark-cli 认证失败

检查：

lark-cli auth status

如果未登录，重新授权：

lark-cli auth login

完整检查清单

开始使用前，逐项确认：

  • [ ] 已复制飞书多维表格模板
  • [ ] 表格中存在「笔记信息」字段
  • [ ] 表格中存在「笔记标题」字段
  • [ ] 表格中存在「笔记内容」字段
  • [ ] 表格中存在「封面链接」字段
  • [ ] 表格中存在「点赞数」字段
  • [ ] 表格中存在「收藏数」字段
  • [ ] 表格中存在「评论数」字段
  • [ ] 表格中存在「账号」字段
  • [ ] 小红书链接已填入「笔记信息」
  • [ ] 复制的是具体 Base 视图链接
  • [ ] 链接包含 table= 参数
  • [ ] 链接包含 view= 参数
  • [ ] 本机 Python 3 可用
  • [ ] lark-cli 已安装或在 WorkBuddy 环境中可用
  • [ ] lark-cli 已完成飞书认证
  • [ ] 当前网络能访问公开小红书笔记页
  • [ ] 已先运行 dry-run
  • [ ] dry-run 输出确认无误后，再授权写回

关键链接

| 平台 / 资源 | 链接 | 用途 | | --- | --- | --- | | Skill GitHub 地址 | https://github.com/duuhuang-ai/feishu-xhs-note-sync | 安装完整 Skill 目录 | | 飞书 Base 模板 | https://yulu-tech.feishu.cn/base/GeBrboz1QatjljsmFTKcRSA5nXf?table=tblkBmkE0ytnAKSu&view=vewk4K2vGi | 复制表格模板 | | lark-cli GitHub | https://github.com/larksuite/cli | 安装和了解飞书 CLI | | 飞书开放平台 | https://open.feishu.cn/ | 查看飞书开放能力与授权说明 | | 小红书网页版 | https://www.xiaohongshu.com/ | 验证公开笔记是否可访问 |

License

MIT