LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube to text

LinkDigest MCP server

中文文档：README.zh-CN.md — 抖音、小红书链接转文本，支持 MCP / Python SDK / 命令行，价格以人民币标注。

面向 AI Agent 的社交媒体阅读层：将社交媒体链接转换为大模型可读的文本——转录文本、屏幕文字、图像描述、说明文字和元数据，并核对引文是否与帖子内容一致。

托管式远程服务（可流式传输的 HTTP）。无需安装或运行任何内容。对于仅支持 stdio 的客户端和脚本，python/ 提供零依赖 Python SDK、linkdigest 命令行工具，以及一个转发请求到托管端点的 linkdigest-mcp stdio 服务。

网站： linkdigest.dev · 注册表： dev.linkdigest/linkdigest

每份摘要都附带一份凭证——说明读取了多少内容，并为每个要点提供经过核对的引文。支持 Muse、Grok Bot、Manus Cue、Hermes、OpenClaw、Claude Code 和 Cursor：参见 linkdigest.dev/connect。初次体验无需密钥。

此仓库包含的内容

开放部分：Python SDK、linkdigest 命令行工具和 linkdigest-mcp stdio 服务（python/，MIT）、Dify 插件源代码（dify/）、Agent 技能（skills/）、示例，以及官方 MCP 注册表条目（server.json）。https://linkdigest.dev/mcp 背后的托管服务和 API 由 LinkDigest 运营；其阅读引擎并非开源。

问题

自行获取社交媒体链接得不到任何有用内容。分享链接使用令牌（xsec_token、app_code_link），内容位于视频和图片中，而非 HTML 里；服务器返回的是应用下载页面或登录墙，而不是帖子内容。

$ curl -sL 'https://xhslink.com/o/1WiQ1QI6Uc0' | grep -o '<title>.*</title>'
<title>小红书 - 你的生活兴趣社区</title>

这个标题属于一个 36 KB 的应用外壳（于 2026-10-04 核查）。没有说明文字，没有图片，也没有笔记文本。

安装

Claude Code

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

Cursor，作为插件安装 — 此仓库是一个 Cursor 插件（.cursor-plugin/plugin.json + mcp.json + skills/）。 从 cursor.directory 安装，然后在 Shell 中设置一次密钥：

export LINKDIGEST_API_KEY=ld_live_...

插件的 mcp.json 会读取 ${LINKDIGEST_API_KEY}；仓库中不会存储密钥。没有密钥时，工具仍会列出，但调用 tools/call 会返回 401，并告知在哪里获取密钥。

Cursor，手动配置 — ~/.cursor/mcp.json

{
  "mcpServers": {
    "linkdigest": {
      "url": "https://linkdigest.dev/mcp",
      "headers": { "Authorization": "Bearer ld_live_..." }
    }
  }
}

仅支持 stdio 的客户端 — 通过 mcp-remote（Node.js）：

{
  "mcpServers": {
    "linkdigest": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://linkdigest.dev/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer ld_live_..." }
    }
  }
}

或者通过发布到 PyPI 的 Python 服务 linkdigest-mcp（由此仓库的发布工作流构建并上传，附带证明；需要 uv）：

{
  "mcpServers": {
    "linkdigest": {
      "command": "uvx",
      "args": ["linkdigest-mcp"],
      "env": { "LINKDIGEST_API_KEY": "ld_live_..." }
    }
  }
}

可在 linkdigest.dev/app/keys 获取密钥。每个账户可免费获得 10 个额度，限领一次，无需银行卡。每篇帖子消耗 1 个额度；视频每开始一分钟额外消耗 1 个额度；热门内容分析或翻译各额外消耗 1 个额度。之后可一次性支付 $5 购买 250 个额度（支持支付宝，结算为 ¥36），或每月支付 $9 购买 500 个额度（银行卡）。

Agent 技能（OpenClaw、Hermes、Claude Code、Cursor 等）

skills/ 中有 11 个现成技能。每个技能只负责一项工作，由一个 SKILL.md 和一个仅使用 Python 标准库的脚本组成。初次体验无需密钥：不设置 LINKDIGEST_API_KEY 时，脚本每天提供一次免费摘要；设置密钥后（注册即送 10 个免费额度，无需银行卡），即可获取完整转录文本和每张图片中的文字。

技能	用途
xiaohongshu-note-to-text	小红书笔记转文字：小红书笔记、每张图片中的文字、说明文字和数据
douyin-video-to-text	抖音视频转文字：抖音视频中的口述内容、屏幕文字和章节
douyin-search-to-text	抖音搜索转文字：按主题搜索抖音（免费），然后读取你选择的视频
tiktok-transcript	TikTok 视频的转录文本，带时间戳和说明文字
long-video-transcript	长视频转文字：最长 2 小时的讲座和播客，每 2 分钟消耗 1 个额度
linkdigest-xhs-note-ocr	小红书图片笔记，包含每张图片中的文字
linkdigest-video-transcript	抖音／小红书视频转录文本和屏幕文字
linkdigest-wechat-article-reader	微信公众号文章：全文和每张图片中的文字
linkdigest-youtube-summary	YouTube 摘要和带时间戳的转录文本，可按需翻译成中文
linkdigest-xiaohongshu-douyin-reader	用英文阅读小红书／抖音帖子
linkdigest-viral-breakdown	爆款帖拆解，逐字核对引文与来源
linkdigest-script-rewrite	提取参考视频的脚本和结构，然后撰写自己的内容

# Any agent the skills CLI supports (Claude Code, Cursor, Codex, OpenClaw, Trae, Qwen Code, ...)
npx skills add jcaiagent7143-ui/linkdigest-mcp --skill xiaohongshu-note-to-text

# Hermes Agent
hermes skills install jcaiagent7143-ui/linkdigest-mcp/skills/xiaohongshu-note-to-text
hermes skills install clawhub/linkdigest-xhs-note-ocr   # or from ClawHub

# OpenClaw (ClawHub)
clawhub install jackchew7143/linkdigest-xhs-note-ocr

工具

digest_url(url, format, job_id, translate_to, breakdown, ask, partial_ok, depth) ——只有 url 是必填项。

参数	说明
url	帖子 URL，包含任何分享令牌。
format	markdown（默认，最适合阅读）或 json（结构化格式）。
job_id	获取已在运行的摘要。传入此参数而不是 url；重新发送 url 会重新开始处理。
breakdown	true 会添加爆款拆解：开头几秒的钩子、按时间节点划分的结构、标题公式、封面文字、行动号召、受众和可复用模板。引文会与帖子逐字核对；互动数据和话题标签来自平台。+1 个额度。
translate_to	ISO 639-1 代码（en、ja、zh-CN）：在原文旁添加译文，并以该语言撰写拆解。+1 个额度。
ask	根据帖子内容回答的问题（“它推荐了哪些产品和价格？”、“讲者有说 X 吗？”）。答案会附上依据的引文，并逐字与帖子核对；如果帖子中没有相关内容，found 为 false，不会编造。+1 个额度。
partial_ok	true 会读取预算允许范围内的开头几分钟，而不是拒绝处理长视频。

你无需亲自调用此工具。工具描述会指示 Agent 在遇到无法读取的社交链接时使用它，因此它会在任务进行中自动调用，无需额外请求。

长视频可能无法在一次调用中处理完毕。遇到这种情况时，结果会给出一个任务 ID；再次调用工具时传入该 job_id，不要传入 url，即可获取结果。

返回内容

platform、author、title、posted_at、caption、transcript（{t, text}）、 ocr_text、on_screen（{t, text}）、images（{description, ocr}）、key_points、stats （likes、comments、saves、shares、plays）、tags、raw_markdown、source_url、transcript_source、 degraded——以及在需要时返回的 breakdown 和 translation。

有两项值得了解：

• transcript_source——native_captions、asr、gemini_video 或 none。平台已发布的字幕是准确的；语音识别则不一定。gemini_video 表示 Gemini 观看了一段没有字幕的 YouTube 视频，并生成了转录文本和时间戳。如果把它们 一视同仁，最终可能会把听错的数字当作事实转述给别人。
• degraded——以通俗语言说明哪些内容未能完整处理，以及如何获得完整读取结果的备注（例如“通过 oEmbed 读取”“Gemini 直接观看视频后读取”）。 之所以提供此字段，是因为曾有一次服务商故障期间，摘要返回了格式正确但完全为空的结果，并被缓存了 30 天。

支持的平台

基于真实帖子测试，而非文档。

平台	状态
Xiaohongshu 小红书	可用——图片笔记和视频笔记，无需登录
Douyin 抖音	可用——视频帖子和图片笔记（图文）
TikTok	可用——可解析短链接。负载较高时会触发速率限制
YouTube	可用——已发布字幕时使用原生字幕，否则生成观看转录文本
X	可用——带视频或图片的帖子
网页 / 文章	可用——可读取文章正文、标题、作者和日期
Bilibili	不支持。 向我们服务器的地址返回 HTTP 412。需要代理
Instagram	未经验证。 已接入，但尚未完成端到端确认
Facebook	不支持。 不会向已退出登录的请求提供帖子内容

我们特意列出了无法使用的平台。等你接入后才发现，总比现在就知道要糟糕。

耗时

实测数据，非预估：

• 已生成过摘要的链接：约 1 秒——之前处理过的链接都会缓存，读取缓存链接无需付费
• 带图片的小红书笔记：1–2 分钟
• 带字幕的 YouTube 视频：约 2.5 分钟

备注

• 语音使用 Qwen3-ASR 转录。我们对同一批片段进行了并排比较后，选择了它而非 whisper-large-v3-turbo；Whisper 会误听中文普通话（创业 → 创意，900人 → 酒派人）。
• transcript 的格式为 [{t, text}]。平台字幕按行标注时间。语音识别目前每约 170 秒音频返回一个片段（较短片段只会在 t: 0 返回一个片段）；on_screen 提供关键帧级别的近似时间。
• 媒体绝不会被存储或提供。媒体会在临时目录中处理，该目录会在请求返回前删除；仅保留文本摘要。
• 被屏蔽或已删除的帖子会返回错误，而非错误页面的描述。

Python SDK 和命令行

位于 python/：MIT 许可证，Python 3.10+，仅使用标准库。

pip install linkdigest-mcp          # PyPI; or from this repo: pip install "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python"
export LINKDIGEST_API_KEY=ld_live_...
linkdigest "https://v.douyin.com/xxxx/" --breakdown       # Markdown to stdout
linkdigest capture ./video.mp4 --url "<link>"              # a video you already have: sound + frames extracted here, never uploaded

from linkdigest import LinkDigest

d = LinkDigest().digest("https://xhslink.com/o/xxxx", translate_to="en")
print(d.title, d.credits, d.cached)
print(d.markdown)

长任务会为你收集结果（GET /api/v1/digest/{jobId}?wait=20）；错误有明确类型（PaymentRequiredError 包含 buy_url）。示例——Dify、适用于 Coze 类平台的 OpenAPI 导入、飞书多维表格、CSV 链接——位于 examples/（中文）。

Dify

同一工具也作为 Dify 插件提供，位于 dify/——包含源代码、清单和隐私政策。从 Dify Marketplace 安装，并在提供方凭据中粘贴 API 密钥。

其他可用方式

REST API（POST https://linkdigest.dev/api/v1/digest）、Web 应用，以及用于批量运行的 Apify Store actors。详见 linkdigest.dev。

许可证

MIT——参见 LICENSE。变更记录见 CHANGELOG.md。