抖音MCP服务

这是一个用于抖音视频发现和元数据提取的模型上下文协议（Model Context Protocol）服务。该服务提供了一个强大的接口，通过标签搜索抖音视频并获取热门内容，内置了防检测措施和错误处理。

功能

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

配置

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

ms_token=你的tiktok_ms_token  # 可选但推荐，以避免被检测为机器人
TIKTOK_PROXY=你的代理URL     # 可选的代理配置

安装与设置

# 安装依赖
poetry install

# 安装浏览器自动化依赖
poetry run python -m playwright install

# 启动服务
poetry run python -m tiktok_mcp_service.main

Claude Desktop集成

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

# 导航到项目目录
cd /path/to/tiktok-mcp-service

# 使用Poetry在可编辑模式下安装服务到Claude Desktop
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# 可选：使用自定义名称安装
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok视频搜索" --with-editable . -f .env

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

API端点

健康检查

• GET /health - 检查服务健康和API初始化状态

  {
    "status": "running",
    "api_initialized": true,
    "service": {
      "name": "TikTok MCP服务",
      "version": "0.1.0",
      "description": "一个用于搜索TikTok视频的模型上下文协议服务"
    }
  }
  

搜索视频

• POST /search - 通过标签搜索视频

  {
    "search_terms": ["python", "coding"],
    "count": 30  // 可选，默认值为30
  }
  

  响应包括视频URL、描述以及互动统计数据（观看次数、点赞数、分享数、评论数）。

资源管理

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

错误处理

该服务包含了全面的错误处理机制，针对以下情况：

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

开发

构建工具：

• TikTokApi
• FastMCP
• 使用Poetry进行依赖管理
• 使用Playwright进行浏览器自动化

许可证

MIT