奇链 奇链
← Agent Skills 目录 / 效率办公
2 jcaiagent7143-ui

linkdigest-xhs-note-ocr Skill

小红书图文笔记提取，连图片里的字一起 OCR。用户发来小红书笔记链接或分享文案（xiaohongshu.com、xhslink.com），要提取笔记正文、图片上的文字、每张图的描述、要点、点赞收藏数或话题标签时使用。图文笔记的正文常写在图片里，直接抓网页拿不到。通过 LinkDigest API 读取，不需要小红书账号或 Cookie。需要 LINKDIGEST_API_KEY，按量计费：6 张图以内 1 积分（约 ¥0.14），注册送 10 积分。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

小红书图文笔记提取（含图片文字 OCR）

脚本路径 scripts/linkdigest.py 相对于本技能目录。

小红书图文笔记的正文经常写在图片里：标题一句话，干货全在图上。直接抓网页只能拿到标题、几行正文和反复出现的「打开App查看更多」。这个技能把笔记链接交给 LinkDigest，返回正文、每张图的描述和图上的文字（OCR）、要点、点赞收藏数和话题标签，按图片顺序排好。

实测同一条图文笔记（公开结果页：https://linkdigest.dev/d/5d0e7837ec2742ea4ae07806d979f0ce ）：

  • 直接 curl 网页，去掉脚本和样式后只剩 860 个可见字符；
  • yt-dlp 报 No video formats found（它只认视频笔记）；
  • LinkDigest 返回的 Markdown 是 35,059 个字符，约为前者的 41 倍。

什么时候用

  • 用户发来小红书笔记链接或整段分享文案，要「提取文案」「图片上的字」「把这篇笔记转成文字」「整理成文档」。
  • 做选题或竞品调研，需要笔记的完整内容和互动数据。
  • 笔记是视频时，同一个接口也能读，逐字稿的说明见 linkdigest-video-transcript 技能。

什么时候不用

  • 要搜索笔记、看评论、发布或点赞：这个技能只读单条笔记，不搜索、不登录、不发帖。
  • 私密、已删除或需要登录才能看的笔记：读不了（返回 422，不扣费）。
  • B站链接：不支持。

准备（一次）

  1. 打开 https://linkdigest.dev/app/keys ，用 Google 或邮箱登录（邮箱会收到一封登录链接），创建 API Key（ld_live_ 开头）。新账户送 10 积分，只送一次，不用绑卡。
  2. 设置环境变量：
export LINKDIGEST_API_KEY=ld_live_...

也可以写进 OpenClaw 配置（~/.openclaw/openclaw.json）里这个技能的 env： 

{ skills: { entries: { "linkdigest-xhs-note-ocr": { env: { LINKDIGEST_API_KEY: "ld_live_..." } } } } }

Key 只放在环境变量或配置里，不要贴进对话、代码或提交记录。

用法

推荐用自带脚本。它只用 Python 3.8+ 标准库，已经处理好 202 排队和轮询： 

python3 scripts/linkdigest.py "<笔记链接或整段分享文案>"
  • 默认输出 Markdown，适合直接读；要结构化数据加 --format json（脚本会省略和其他字段重复的 raw_markdown）。
  • 分享文案里有引号或换行时，从标准输入传：printf '%s' "$SHARE_TEXT" | python3 scripts/linkdigest.py -
  • 用 App 里「分享 → 复制链接」得到的链接，保留链接上的参数（如 xsec_token）；整段分享文案也可以，服务端会从里面取出链接。
  • 想控制花费：--max-credits 2，这条笔记超过 2 积分就不读、不扣费（返回 402）。
  • 本次扣了几个积分、是否命中缓存，打印在 stderr 的最后一行。
  • 退出码：0 成功；2 参数错误或没设 Key；3 Key 无效（401）；4 积分不够（402，未扣费，stderr 里有付款链接）；5 链接读不了（422）；6 调用太频繁，或这个 Key 在 /app/keys 设的 30 天积分上限已用完（429，未扣费）；7 等待超时（任务还在跑，按提示用 --job-id 接着取）。

直接调 HTTP（没有 Python 时）

提交： 

curl -sS -X POST https://linkdigest.dev/api/v1/digest \
  -H "Authorization: Bearer $LINKDIGEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.xiaohongshu.com/explore/<笔记ID>?xsec_token=<...>", "format": "json"}'
  • 200：结果 JSON，字段见下文。
  • 202：还在处理，返回 {"pending":true,"jobId":"…","poll":"/api/v1/digest/…","retryAfter":15}。用 jobId 取结果，不要重新提交：
curl -sS "https://linkdigest.dev/api/v1/digest/<jobId>?wait=20" \
  -H "Authorization: Bearer $LINKDIGEST_API_KEY"

wait=20 让服务端最多等 20 秒再回复；仍是 202 就再取一次，直到 200。要 Markdown 时，提交用 "format": "markdown"，取结果加 &format=markdown（202 响应始终是 JSON）。用 curl 传分享文案时，注意把里面的引号和换行按 JSON 转义。

可以直接运行的 bash/zsh 版本（提交 + 轮询，最多约 15 分钟）： 

API=https://linkdigest.dev/api/v1/digest
AUTH="Authorization: Bearer $LINKDIGEST_API_KEY"
LINK='https://www.xiaohongshu.com/explore/<笔记ID>?xsec_token=<...>'
res=$(curl -sS -w '\n%{http_code}' -X POST "$API" -H "$AUTH" \
  -H "Content-Type: application/json" -d "{\"url\": \"$LINK\", \"format\": \"json\"}")
code=${res##*$'\n'}; body=${res%$'\n'*}
n=0
while [ "$code" = 202 ] && [ $n -lt 45 ]; do
  n=$((n+1))
  job=$(printf '%s' "$body" | sed -n 's/.*"jobId":"\([^"]*\)".*/\1/p')
  res=$(curl -sS -w '\n%{http_code}' "$API/$job?wait=20" -H "$AUTH")
  code=${res##*$'\n'}; body=${res%$'\n'*}
done
echo "HTTP $code" >&2
printf '%s\n' "$body"

返回字段（图文笔记）

| 字段 | 内容 |
| --- | --- |
| title / author / posted_at | 标题、作者、发布日期 |
| caption | 笔记正文（文字部分） |
| images[] | 按图片顺序，每张一个 {description, ocr}：description 是模型写的画面描述，ocr 是图上的文字 |
| ocr_text[] | 所有图片里读出的文字片段汇总成一个列表（同样的字只出现一次）；要按图对应，用 images[].ocr |
| key_points[] | 要点，用原文语言 |
| stats | likes 点赞、comments 评论、collects 收藏、shares 分享；是读取当天平台给的数，as_of 是日期，拿不到的是 null |
| tags[] | 话题标签 |
| raw_markdown | 整条内容的 Markdown：## Caption、## Key points、## Images（每张图是「Image N. 描述」，下面引用块里是图上文字） |
| credits / cached | 本次扣了几个积分；读过的链接 cached=true，0 积分 |
| degraded[] | 处理中没做完的部分的说明，正常为空 |

把结果交给用户时

  • 用户要「文案」「图片上的字」：先给 caption，再按顺序给每张图的 ocr，标明「图 1」「图 2」。原样给出，不改写、不总结，除非用户要求。
  • caption、ocr、stats、tags 来自笔记本身；images[].description 和 key_points 是模型写的。转述时分清楚。
  • 花体字、手写字、很小的字可能认错。涉及价格、数字、品牌名时，提醒用户对照原图。
  • 告诉用户这次用了几个积分（credits，缓存命中是 0）。

费用

按加量包 ¥36 = 250 积分折算，1 积分约 ¥0.144。

| 内容 | 积分 | 约合 |
| --- | --- | --- |
| 图文笔记，6 张图以内 | 1 | ¥0.14 |
| 7–12 张图 | 2 | ¥0.29 |
| 13–18 张图 | 3 | ¥0.43 |
| 加爆款拆解（--breakdown） | +1 | +¥0.14 |
| 加译文（--translate-to en 等） | +1 | +¥0.14 |
| 任何人读过的链接（缓存） | 0 | 0 |
| 读不出内容 | 0 | 0 |

注册送 10 积分（每个账户一次，不按月补）。加量包 $5 = 250 积分，可用支付宝付款（按 ¥36 结算），不过期；或 Dev 月付 $9 = 每月 500 积分（银行卡）。价格以 https://linkdigest.dev/zh/docs 为准。

限制

  • 不支持 B站：哔哩哔哩对我们服务器的地址直接返回 HTTP 412。
  • 私密、已删除、需要登录才能看的笔记读不了。
  • 视频笔记另按时长计费（每开始的 1 分钟 +1 积分）；免费账户和加量包账户单条视频最长 10 分钟，Dev 月付 30 分钟，超过返回 402 且不扣费。详见 linkdigest-video-transcript。
  • 互动数据是读取当天的快照，不是实时数据；缓存里的结果保留第一次读取那天的数。
  • 每个账户每小时最多 60 次 API 调用。
  • 不搜索、不读评论、不登录、不发帖、不点赞。

隐私

  • 只把你给的链接发给 linkdigest.dev，不需要也不会读取你的小红书账号或 Cookie。
  • 图片、视频、音频只在处理时放在临时目录，返回前删除，不保存、不转发。
  • 文字结果按链接缓存（所以同一链接再读免费），可能提供给请求同一公开链接的其他用户。不要提交私密内容的链接。
  • 读取时会用到第三方模型服务，详见 https://linkdigest.dev/privacy 。
  • scripts/linkdigest.py 只读环境变量 LINKDIGEST_API_KEY，只连 linkdigest.dev，不读写本地文件。

其他接入方式

  • 远程 MCP（Streamable HTTP）：https://linkdigest.dev/mcp，请求头 Authorization: Bearer ，工具 digest_url。Claude Code：

claude mcp add --transport http linkdigest https://linkdigest.dev/mcp --header "Authorization: Bearer "

  • 只支持本地（stdio）MCP 的客户端：npx mcp-remote https://linkdigest.dev/mcp --header "Authorization: Bearer "
  • Dify 插件市场：jcaiagent7143-ui/linkdigest
  • OpenAPI：https://linkdigest.dev/openapi.json
  • 开源客户端与接入示例：https://github.com/jcaiagent7143-ui/linkdigest-mcp
  • 中文文档：https://linkdigest.dev/zh/docs

LinkDigest 由独立开发者 Jack（GitHub jcaiagent7143-ui）开发和维护。问题和反馈：support@linkdigest.dev