Metadata-Version: 2.5
Name: linkdigest-mcp
Version: 0.2.1
Summary: 抖音、小红书、TikTok、YouTube、X 链接转 AI 可读文本 — Python SDK, CLI and stdio MCP server for the hosted LinkDigest API
Project-URL: Homepage, https://linkdigest.dev
Project-URL: Documentation, https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md
Project-URL: Repository, https://github.com/jcaiagent7143-ui/linkdigest-mcp
Project-URL: Issues, https://github.com/jcaiagent7143-ui/linkdigest-mcp/issues
Author-email: LinkDigest <support@linkdigest.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: douyin,mcp,mcp-server,ocr,rednote,tiktok,transcript,xiaohongshu,youtube,小红书,抖音,文案提取,爆款拆解
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Text Processing
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: test
Requires-Dist: pytest>=7; extra == 'test'
Description-Content-Type: text/markdown

# linkdigest-mcp (Python)

<!-- mcp-name: dev.linkdigest/linkdigest -->

把抖音、小红书、TikTok、YouTube、X 链接变成 AI 能读的文本：逐字稿、带大致时间的画面文字、
每张图的描述和 OCR、要点，可选爆款拆解（breakdown）和翻译。

Turn a Douyin, Xiaohongshu, TikTok, YouTube or X link into text an LLM can read.

This package is a thin client for the hosted service at [linkdigest.dev](https://linkdigest.dev):
nothing is downloaded or transcribed on your machine, and it has **no dependencies**
(Python 3.10+, standard library only). It installs three things:

| | |
|---|---|
| `from linkdigest import LinkDigest` | Python SDK — waits for long videos for you (`GET /api/v1/digest/{jobId}?wait=20`) and raises typed errors (402 carries a pay link) |
| `linkdigest <url>` | command line — Markdown to stdout, `--json`, `--breakdown`, `--translate en` |
| `linkdigest-mcp` | stdio MCP server — the `digest_url` tool, forwarded to `https://linkdigest.dev/mcp` with your key |

Install from this repo (the package is **not on PyPI yet**; a `linkdigest-mcp` package on PyPI
is not ours until this README says so):

```bash
pip install "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python"
```

All three read the API key from `LINKDIGEST_API_KEY`. Issue one at
[linkdigest.dev/app/keys](https://linkdigest.dev/app/keys) — 10 free credits on sign-up, no card.

```python
from linkdigest import LinkDigest

ld = LinkDigest()  # LINKDIGEST_API_KEY
d = ld.digest("https://v.douyin.com/xxxx/", breakdown=True)
print(d.title, d.credits)
print(d.markdown)
```

```bash
linkdigest "https://xhslink.com/o/xxxx" --breakdown
```

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

Full documentation (中文): [README.zh-CN.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md)
· English: [README.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.md)

MIT licensed.
