金大哥 - TikTok Video Discovery MCP 详情

article

README

🚀 TikTok MCP 服务

TikTok MCP 服务是一个用于视频发现和元数据提取的模型上下文协议服务。它提供强大接口，支持通过标签搜索 TikTok 视频并提取流行内容，还内置了反检测措施和错误处理机制，为用户提供稳定、高效的使用体验。

🚀 快速开始

本服务可通过标签搜索 TikTok 视频，并提取流行内容。使用前，需完成配置和安装设置，之后便可集成到 Claude Desktop 中使用。

✨ 主要特性

视频搜索：支持使用标签搜索视频，且每次搜索可配置视频数量（默认 30 条）。
反检测机制：具备反机器人检测措施，还支持代理配置。
自动化管理：拥有自动 API 会话管理功能，能进行速率限制和错误处理。
状态监控：提供健康状态监控，方便了解服务运行情况。

📦 安装指南

配置环境变量

服务使用环境变量进行配置。创建一个.env文件，内容如下：

ms_token=your_tiktok_ms_token  # 可选但推荐以避免反机器人检测
TIKTOK_PROXY=your_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

# 使用可编辑模式安装服务到 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 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：用于与 TikTok 进行交互。
FastMCP：提供核心的模型上下文协议功能。
Poetry：进行依赖管理，确保项目依赖的一致性和可重复性。
Playwright：进行浏览器自动化，支持服务的自动化操作。

📄 许可证

本项目采用 MIT 许可证。

TikTok Video Discovery