小红书笔记转文本 OCR

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install xiaohongshu-note-to-text
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 xiaohongshu-note-to-text。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

小红书笔记转文本 OCR 是一项 OpenClaw skill，可将公开的小红书、XHS Link 或 RedNote URL 发送给 LinkDigest，并获取普通网页抓取经常遗漏的内容。它会提取文案、按顺序排列的图片内容、每张图片中的 OCR 文本、图片描述、要点、互动统计数据和话题标签。
此 skill 专为阅读和整理单篇公开笔记而设计，不用于下载内容、搜索小红书、访问私人帖子、阅读评论、登录、发布或点赞。它支持无需密钥的每日摘要选项，也支持使用可选 LinkDigest API 密钥进行完整提取。

应用场景

提取以图片为主的小红书笔记中的完整文本。
通过逐张图片 OCR 还原轮播图片中嵌入的中文文本。
将分享的小红书链接或复制的分享文本转换为 Markdown 或 JSON 文档。
支持内容研究、话题发现、竞品研究和编辑分析。
收集笔记标题、作者、日期、标签、点赞数、评论数、收藏数和分享数。
翻译提取的笔记内容或请求要点拆解。
通过相关的 LinkDigest 视频转录工作流处理符合条件的视频笔记。
避免将其用于私人、已删除、仅登录可访问的内容、Bilibili 或基于互动的工作流。

工作原理

接受公开的 xiaohongshu.com、xhslink.com 或 rednote.com URL，也可接受完整的分享消息。
将输入传递给捆绑的 Python 3.8+ 脚本或 LinkDigest HTTP API。
LinkDigest 解析分享笔记，并处理其文案、图片、OCR、描述、元数据以及可用的互动数据快照。
如果处理为异步，API 会返回 job ID；客户端会轮询该任务，直到最终结果可用，而不是再次提交笔记。
为人工阅读返回 Markdown，或为结构化的下游处理返回 JSON。
先呈现文案，再按图片顺序呈现图片 OCR，同时区分源内容提取的字段与模型生成的描述和要点。
向用户报告已使用的 credits、缓存状态、降级部分以及相关的 OCR 不确定性。

配置指南

确保已安装 Python 3.8 或更高版本。捆绑脚本仅使用 Python 标准库。
如需完整提取，请在 https://linkdigest.dev/app/keys 创建 LinkDigest API 密钥。密钥以 ld_live_ 开头；新账户无需支付卡即可获得 10 credits。
导出可选的 API 密钥：
export LINKDIGEST_API_KEY=ld_live_...
也可以将 LINKDIGEST_API_KEY 添加到 ~/.openclaw/openclaw.json 中的 skill 环境变量：
{ skills: { entries: { "linkdigest-xhs-note-ocr": { env: { LINKDIGEST_API_KEY: "ld_live_..." } } } }
使用笔记 URL 或完整分享文本运行捆绑脚本：
python3 {baseDir}/scripts/linkdigest.py ""
如有需要，可请求结构化 JSON：
python3 {baseDir}/scripts/linkdigest.py --format json ""
如果分享文本包含引号或换行符，请使用标准输入：
printf '%s' "$SHARE_TEXT" | python3 {baseDir}/scripts/linkdigest.py -
如有需要，可设置消费上限：
python3 {baseDir}/scripts/linkdigest.py --max-credits 2 ""
请将 API 密钥保存在环境变量或受保护的配置中；切勿将其放入对话、源代码或提交历史。没有密钥时，该服务每天提供一次免费摘要。也可通过 LinkDigest 文档使用直接 HTTP 和 MCP 集成。

数据架构

该 skill 返回易读的 Markdown 或结构化 JSON。核心字段包括：
Field Purpose
caption 笔记正文中的文本部分
images[] 按顺序排列的图片记录，包含 description 和 ocr
ocr_text[] 汇总所有图片中去重后的 OCR 片段
key_points[] 以原文语言生成的要点
stats likes、comments、collects、shares 以及 as_of 中的快照日期
tags[] 笔记话题和主题标签
raw_markdown 完整 Markdown，包含文案、要点、按序排列的图片、描述和引用的图片文本
credits 此请求消耗的 credits；读取缓存内容不消耗 credits
cached 指示结果是否来自链接缓存
degraded[] 描述未完整处理的组件
Markdown 按 ## Caption、## Key points 和 ## Images 章节组织。图片 OCR 通过 images[].ocr 与其来源图片保持关联；需要逐张图片对照时请使用此字段。文案、OCR、标签和统计数据源自笔记或服务提取结果，而图片描述和要点由模型生成，应明确标注。

高级特性

异步任务处理，支持
响应、job ID、轮询和可配置的等待时间。
提供 Markdown 和 JSON 输出模式，适用于人工审阅或自动化流水线。 --max-credits 保护 credits；笔记超出上限时会拒绝处理且不收费。
基于链接的缓存机制，可在不额外消耗 credits 的情况下再次读取已处理的公开链接。
可选的要点拆解和翻译功能，例如 --breakdown --translate-to en 。
通过 Bearer 身份验证直接访问 REST API：
https://linkdigest.dev/api/v1/digest
。
https://linkdigest.dev/mcp
digest_url
工具支持远程 Streamable HTTP MCP。
兼容通过
mcp-remote
连接的本地 stdio MCP 客户端，以及 Dify 和 OpenAPI 集成。
针对无效参数、身份验证错误、credits 不足、链接无法访问、速率限制和超时提供明确的退出代码。
scripts/linkdigest.py
以临时方式处理媒体，不会读取或写入本地文件。
注重隐私的处理方式，无需小红书账户或 cookie；同时将使用范围限制为公开链接，并注明会由第三方模型处理。

name: xiaohongshu-note-to-text description: "小红书笔记转文字：图文笔记每张图里的字（OCR）、图片描述、正文、标签、点赞收藏，视频笔记给口播逐字稿和画面文字。用户发来 xiaohongshu.com、xhslink.com、rednote.com 链接或分享口令，要提取笔记内容、图片文字、文案、做笔记总结或翻译时使用。不需要 Key 也能先免费看一条摘要；注册拿 Key（送 10 积分）后给完整逐字稿和逐图文字，一条图文 1 积分（约 ¥0.14）。不需要小红书账号或 Cookie，不是下载/去水印工具。" version: 1.0.0
homepage: https://linkdigest.dev/zh/docs