🚀 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 }
资源管理
POST /cleanup- 清理资源和 API 会话
错误处理
服务包含全面的错误处理，针对以下情况：
- API 初始化失败
- 反机器人检测问题
- 网络错误
- 速率限制
- 无效搜索词
🔧 技术细节
本服务使用以下技术进行开发：
- TikTokApi：用于与 TikTok 进行交互。
- FastMCP：提供核心的模型上下文协议功能。
- Poetry：进行依赖管理，确保项目依赖的一致性和可重复性。
- Playwright：进行浏览器自动化，支持服务的自动化操作。
📄 许可证
本项目采用 MIT 许可证。