TikTok MCP 服务

用于 TikTok 视频发现和元数据提取的模型上下文协议服务。该服务提供了一个强大的界面，可通过主题标签搜索 TikTok 视频并检索热门内容，并内置了反检测措施和错误处理功能。

特征

按主题标签搜索视频
可配置每次搜索的视频数量（默认值：30）
反机器人检测措施
代理支持
自动 API 会话管理
速率限制和错误处理
健康状态监测

Related MCP server: Liveblocks

配置

该服务使用环境变量进行配置。创建一个.env文件，其中包含以下内容：

ms_token=your_tiktok_ms_token # Optional but recommended to avoid bot detection TIKTOK_PROXY=your_proxy_url # Optional proxy configuration

安装和设置

# Install dependencies poetry install # Install browser automation dependencies poetry run python -m playwright install # Start the service poetry run python -m tiktok_mcp_service.main

Claude 桌面集成

服务运行后，即可将其与 Claude Desktop 集成。由于我们使用 Poetry 进行依赖管理，请确保通过 Poetry 运行 MCP CLI 命令：

# Navigate to the project directory cd /path/to/tiktok-mcp-service # Install the service in Claude Desktop with Poetry in editable mode poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env # Optional: Install with a custom name poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env

安装后，该服务将在 Claude Desktop 中可用，并将使用 Poetry 运行以进行适当的依赖关系管理。

API 端点

健康检查

GET /health - 检查服务健康状况和 API 初始化状态
{ "status": "running", "api_initialized": true, "service": { "name": "TikTok MCP Service", "version": "0.1.0", "description": "A Model Context Protocol service for searching TikTok videos" } }

搜索视频

POST /search - 使用主题标签搜索视频
{ "search_terms": ["python", "coding"], "count": 30 // Optional, defaults to 30 }
回复包括视频 URL、描述和参与度统计数据（观看次数、喜欢次数、分享次数、评论次数）。

资源管理

POST /cleanup - 清理资源和 API 会话

错误处理

该服务包括针对以下方面的全面错误处理：

API 初始化失败
机器人检测问题
网络错误
速率限制
无效的搜索词

发展

内置：

TikTokAPI
FastMCP
依赖管理的诗歌
浏览器自动化的 Playwright

执照

麻省理工学院# tiktok_mcp

TikTok API 限制

重要提示： TikTok 已实施严格的反抓取措施，限制 API 访问。因此，此服务提供以下功能：

模拟数据模式：当 TikTok 阻止 API 访问时（目前情况如此），该服务会提供与搜索词相关的逼真模拟结果。这可确保您的 Claude 集成即使在 TikTok 限制访问的情况下也能继续运行。
API 访问尝试：该服务仍会首先尝试使用 TikTok API，但如果 API 不可用或返回错误，则会快速回退到模拟数据。
透明度：当提供模拟数据时，这将通过transformations字段在响应中清楚地表明，其中包括一条说明，说明正在显示模拟结果。

此实施可确保您的服务在 TikTok 采取反抓取措施的情况下仍能继续运行。