How do I install LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text need an API key?

No required environment variable is listed on this record.

What transport does LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text use?

LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text is reached over HTTP.

When was LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text last checked?

Last checked 2026-11-08. Douyin, Xiaohongshu, TikTok, YouTube, X links to text: transcript, screen text, viral breakdown

LinkDigest — Xiaohongshu, Douyin, TikTok, Yo MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://linkdigest.dev/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http dev.linkdigest-linkdigest https://linkdigest.dev/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "dev.linkdigest-linkdigest": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://linkdigest.dev/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.9
License

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

LinkDigest MCP server

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

The social media reading layer for AI agents: turn a social media link into text a language model can read — transcript, on-screen text, image descriptions, caption and metadata, with quotes checked against the post.

Hosted, remote (streamable HTTP). Nothing to install or run. For stdio-only clients and scripts, python/ adds a zero-dependency Python SDK, a linkdigest command line and a linkdigest-mcp stdio server that forwards to the hosted endpoint.

Website: linkdigest.dev · Registry: dev.linkdigest/linkdigest

Every digest comes with a receipt — how much was read, and a checked quote behind each key point. Works from Muse, Grok Bot, Manus Cue, Hermes, OpenClaw, Claude Code and Cursor: see linkdigest.dev/connect. No key needed for a first look.

What this repository contains

The open parts: the Python SDK, the linkdigest command line and the linkdigest-mcp stdio server (python/, MIT), the Dify plugin source (dify/), the agent skill (skills/), examples, and the official MCP registry entry (server.json). The hosted service behind https://linkdigest.dev/mcp and the API is operated by LinkDigest; its reading engine is not open source.

The problem

Fetching a social link yourself returns nothing useful. Share URLs are tokenised (xsec_token, app_code_link), the content lives in video and images rather than HTML, and the server sends an app-download shell or a login wall instead of the post.

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

That title belongs to a 36 KB app shell (checked 2026-10-04). No caption, no images, no text of the note.

Install

Claude Code

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

Cursor, as a plugin — this repo is a Cursor plugin (.cursor-plugin/plugin.json + mcp.json + skills/). Install it from cursor.directory, then set the key once in your shell:

export LINKDIGEST_API_KEY=ld_live_...

The plugin's mcp.json reads ${LINKDIGEST_API_KEY}; no key is stored in the repo. Without it, the tool still lists and tools/call returns a 401 that says where to get one.

Cursor, by hand — ~/.cursor/mcp.json

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

stdio-only clients — through 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_..." }
    }
  }
}

or through this repo's Python server (needs uv and git). It is installed from this git repository because it is not on PyPI yet; a linkdigest-mcp package on PyPI is not ours until this README says so:

{
  "mcpServers": {
    "linkdigest": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python", "linkdigest-mcp"],
      "env": { "LINKDIGEST_API_KEY": "ld_live_..." }
    }
  }
}

A key is issued at linkdigest.dev/app/keys. 10 free credits to start, once per account, no card. A post is one credit; video adds one per started minute; a viral breakdown or a translation adds one each. Then $5 once for 250 credits (Alipay accepted, settled as ¥36) or $9 a month for 500 (card).

Agent skills (OpenClaw, Hermes, Claude Code, Cursor and others)

Eleven ready-made skills live in skills/. Each is one job, a SKILL.md plus one script that uses only the Python standard library. No key needed for a first look: without LINKDIGEST_API_KEY the script gives one free summary a day; with a key (10 free credits on sign-up, no card) it returns the full transcript and per-image text.

Skill	Job
`xiaohongshu-note-to-text`	小红书笔记转文字: a Xiaohongshu note, the text in every image, caption, stats
`douyin-video-to-text`	抖音视频转文字: a Douyin video's spoken words, on-screen text, chapters
`douyin-search-to-text`	抖音搜索转文字: search Douyin by topic (free), then read the videos you pick
`tiktok-transcript`	A TikTok video's transcript with timestamps and captions
`long-video-transcript`	长视频转文字: lectures and podcasts up to 2 h, 1 credit per 2 minutes
`linkdigest-xhs-note-ocr`	Xiaohongshu image notes, with the text inside every image
`linkdigest-video-transcript`	Douyin / Xiaohongshu video to transcript and on-screen text
`linkdigest-wechat-article-reader`	WeChat 公众号 articles: full text and every image's text
`linkdigest-youtube-summary`	YouTube summary and timed transcript, translated to Chinese on request
`linkdigest-xiaohongshu-douyin-reader`	Read Xiaohongshu / Douyin posts in English
`linkdigest-viral-breakdown`	How a viral post is built, with quotes checked against the source
`linkdigest-script-rewrite`	Extract a reference video's script and structure, then write your own

# 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

The tool

digest_url(url, format, job_id, translate_to, breakdown, ask, partial_ok, depth) — only url is required.

Argument	Notes
`url`	The post URL, including any share tokens.
`format`	`markdown` (default, best for reading) or `json` (structured).
`job_id`	Collect a digest already running. Pass this instead of `url` — re-sending the url would start the work again.
`breakdown`	`true` adds a viral breakdown (爆款拆解): the hook in its first seconds, the structure as timed beats, the title formula, cover text, call to action, audience and a reusable template. Quotes are checked word for word against the post; engagement and hashtags come from the platform. +1 credit.
`translate_to`	An ISO 639-1 code (`en`, `ja`, `zh-CN`): adds a translation beside the original, and writes the breakdown in that language. +1 credit.
`ask`	A question to answer from the post ("what products and prices does it recommend?", "does the speaker say X?"). The answer comes with the quotes it rests on, each checked word for word against the post; `found` is false when the post does not say, and nothing is invented. +1 credit.
`partial_ok`	`true` reads the opening minutes the budget affords instead of refusing a long video.

You do not call it yourself. The tool description tells the agent to reach for it whenever it meets a social link it cannot read, so it happens mid-task without being asked.

A long video may not finish inside one call. When that happens the result names a job id; call the tool again with that job_id and no url to collect it.

What comes back

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 — plus breakdown and translation when asked for.

Two are worth knowing about:

transcript_source — native_captions, asr, gemini_video or none. Captions the platform already published are exact; speech recognition is not. gemini_video means a YouTube video without captions was watched by Gemini, which wrote the transcript and its times. Treating them identically eventually quotes a mis-heard number back at someone as fact.
degraded — what did not fully work, in plain words, plus notes on how a complete read was obtained (e.g. "read via oEmbed", "read by Gemini watching the video directly"). It exists because a digest once returned a well-formed, completely empty result during a provider outage and was cached for thirty days.

Platforms

Checked against real posts, not documentation.

Platform	Status
Xiaohongshu 小红书	Works — image notes and video notes, no login needed
Douyin 抖音	Works — video posts and image notes (图文)
TikTok	Works — short links resolve. Rate-limits under load
YouTube	Works — native captions where published, otherwise a watched transcript
X	Works — posts with video or images
Web pages / articles	Works — readable article text, title, author, date
Bilibili	Not supported. Returns HTTP 412 to our server's address. Needs a proxy
Instagram	Not verified. Wired, not confirmed end to end
Facebook	Not supported. Serves no post content to logged-out requests

The rows that do not work are listed on purpose. Finding out after you have wired something in is worse than knowing now.

How long it takes

Measured, not estimated:

Already-digested link: about 1 second — anything anyone has run before is cached, and cached links are free
Xiaohongshu note with images: 1–2 minutes
YouTube video with captions: about 2.5 minutes

Notes

Speech is transcribed with Qwen3-ASR. It was kept over whisper-large-v3-turbo after a side-by-side on the same clips, where Whisper misheard Mandarin (创业 → 创意, 900人 → 酒派人).
transcript is [{t, text}]. Platform captions are timed per line. Speech recognition currently returns one segment per ~170 s of audio (a single segment at t: 0 for a shorter clip); on_screen carries approximate, keyframe-level times.
Media is never stored or served. It is processed in a temporary directory deleted before the request returns; only the text digest is kept.
A blocked or removed post returns an error, not a description of the error page.

Python SDK and command line

In python/: MIT, Python 3.10+, standard library only.

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

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)

Long jobs are collected for you (GET /api/v1/digest/{jobId}?wait=20); errors are typed (PaymentRequiredError carries buy_url). Examples — Dify, OpenAPI import for Coze-style platforms, Feishu Bitable, links to CSV — are in examples/ (Chinese).

Dify

The same tool as a Dify plugin lives in dify/ — source, manifest and privacy policy. Install it from the Dify Marketplace and paste your API key into the provider credential.

Also available

A REST API (POST https://linkdigest.dev/api/v1/digest), a web app, and Apify Store actors for bulk runs. See linkdigest.dev.

License

MIT — see LICENSE. Changes are listed in CHANGELOG.md.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text?

Does LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text need an API key?

What transport does LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text use?

When was LinkDigest — Xiaohongshu, Douyin, TikTok, YouTube To Text last checked?

Documentation

LinkDigest MCP server

What this repository contains

The problem

Install

Agent skills (OpenClaw, Hermes, Claude Code, Cursor and others)

The tool

What comes back

Platforms

How long it takes

Notes

Python SDK and command line

Dify

Also available

License