TikTok MCP 服务

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

特性

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

配置

服务使用环境变量进行配置。创建一个 .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  // 可选，默认为 30
  }
  

  响应包括视频 URL、描述以及参与度统计数据（浏览量、点赞数、分享数、评论数）。

资源管理

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

错误处理

服务包含全面的错误处理机制，涵盖：

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

开发

构建工具：

• TikTokApi
• FastMCP
• Poetry 用于依赖项管理
• Playwright 用于浏览器自动化

许可证

MIT