TikTok MCP Service
2025.04.03
21
Python视频搜索元数据提取TikTok 内容发现内容生成娱乐功能
TikTok MCP Service 是一个用于 TikTok 视频发现和元数据提取的模型上下文协议服务。该服务提供了一个强大的接口，用于通过标签搜索 TikTok 视频并获取热门内容，内置反检测措施和错误处理功能。
View on GitHub
Overview
基本能力
产品定位
TikTok MCP Service 是一个专注于 TikTok 视频搜索和元数据提取的服务，旨在帮助用户高效地发现和获取 TikTok 上的热门内容。
核心功能
- 通过标签搜索视频
- 可配置每次搜索的视频数量（默认：30）
- 反机器人检测措施
- 代理支持
- 自动 API 会话管理
- 速率限制和错误处理
- 健康状态监控
适用场景
- 内容创作者寻找热门标签和视频
- 研究人员分析 TikTok 视频趋势
- 开发者集成 TikTok 视频搜索功能到其他应用中
工具列表
- TikTokApi: 用于与 TikTok API 交互
- FastMCP: 用于快速构建 MCP 服务
- Poetry: 用于依赖管理
- Playwright: 用于浏览器自动化
常见问题解答
- API 初始化失败: 检查环境变量是否正确配置
- 机器人检测问题: 确保使用有效的
ms_token和代理 - 网络错误: 检查代理设置和网络连接
- 速率限制: 调整搜索频率或使用代理
使用教程
使用依赖
# 安装依赖
poetry install
# 安装浏览器自动化依赖
poetry run python -m playwright install
安装教程
# 启动服务
poetry run python -m tiktok_mcp_service.main
# 安装到 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 Video Search" --with-editable . -f .env
调试方式
# 检查服务健康状态
curl http://localhost:8000/health
# 搜索视频
curl -X POST http://localhost:8000/search -d '{"search_terms": ["python", "coding"], "count": 30}'