# Douyin Mcp

> 抖音视频解析 MCP Server — 无水印下载 + TikTok热门视频

- **Type:** MCP server
- **Install:** `agentstack add mcp-521w-douyin-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [521w](https://agentstack.voostack.com/s/521w)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [521w](https://github.com/521w)
- **Source:** https://github.com/521w/douyin-mcp

## Install

```sh
agentstack add mcp-521w-douyin-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Douyin MCP Server

An MCP server for AI agents that need to parse Douyin share links and extract useful video metadata.

It focuses on practical short-video workflows: collecting assets, understanding video metadata, and helping agents work with Douyin/TikTok-style content links.

## What It Does

- Parses Douyin short share links
- Resolves redirected video pages
- Extracts title, author, duration, cover image, music, and video URL
- Attempts to return watermark-free video URLs when available
- Provides TikTok trending retrieval support

## Tools

| Tool | Description |
| --- | --- |
| `parse_douyin` | Parse a Douyin share link and extract video info and media URLs |
| `get_tiktok_trending` | Get a global TikTok trending video list |

## Good For

- Short-video asset collection
- AI-assisted video research
- Content repurposing workflows
- Creator research and reference gathering
- Agent workflows that need structured video metadata

## Installation

```bash
pip install git+https://github.com/521w/douyin-mcp.git
```

Or install from source:

```bash
git clone https://github.com/521w/douyin-mcp.git
cd douyin-mcp
pip install -e .
```

## MCP Configuration

```json
{
  "mcpServers": {
    "douyin": {
      "command": "python3",
      "args": ["-m", "douyin_mcp.server"]
    }
  }
}
```

## Example

Input:

```json
{
  "share_url": "https://v.douyin.com/xxxxx/"
}
```

Output includes:

```text
Title
Author
Duration
Cover image URL
Video URL
Music URL
```

## Example Agent Tasks

- "Parse this Douyin link and summarize the video metadata."
- "Extract cover, music, and video URL from this share link."
- "Collect references from a batch of short-video links."
- "Help me build a content inspiration board from Douyin links."

## Why This Server

- **Agent-ready**: turns messy share links into structured metadata
- **Practical**: useful for creator workflows and content operations
- **Small and focused**: one job, easy to plug into a larger agent pipeline
- **Productizable**: can become part of a content research, clipping, or remix workflow

## Requirements

- Python >= 3.9
- `mcp >= 1.0.0`
- `requests >= 2.28.0`

## Notes

Douyin and TikTok endpoints can change or block automated access. This server should be treated as a practical integration layer that may require maintenance when platforms update their behavior.

Respect platform rules and copyright when downloading or reusing media.

## Verified Status

Verified on Termux/Android with Python 3.13:

```bash
python -m venv .venv
. .venv/bin/activate
pip install -e .
douyin-mcp
```

MCP initialization and tool listing were verified successfully. `get_tiktok_trending` returned a handled platform/network failure when TikTok reset the connection, so live endpoint availability may vary.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [521w](https://github.com/521w)
- **Source:** [521w/douyin-mcp](https://github.com/521w/douyin-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-521w-douyin-mcp
- Seller: https://agentstack.voostack.com/s/521w
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.