Crowdlistening

TikTok MCP 服务

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

特征

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

配置

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

安装和设置

Claude 桌面集成

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

安装后，该服务将在 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 访问。因此，此服务提供以下功能：

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

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