TikTok广告MCP服务器
一个用于TikTok广告API集成的模型上下文协议（MCP）服务器。该服务器使像Claude这样的AI助手能够与TikTok广告活动进行交互，提供全面的活动管理、分析和优化功能。
这个项目是……的一部分 AdsMCP AI广告自动化平台这是一个由人工智能驱动的平台，旨在简化和自动化跨多个广告网络的广告活动管理。该平台强调效率、数据驱动的洞察以及为营销人员和代理机构提供的智能自动化。此外，AdsMCP还支持与其他广告平台的集成，例如 Google Ads（谷歌广告） 并且 Meta（Facebook）广告，使得能够从单一界面轻松管理跨多个网络的广告活动。
特点/特性
- 活动管理创建、阅读和更新广告系列及广告组
- 性能分析获取详细的性能指标和见解
- 观众管理处理自定义受众群体和定位选项
- 创意管理上传和管理广告创意素材
- 报告生成并下载自定义性能报告
安装
先决条件
- Python 3.10+
- 拥有API访问权限的TikTok For Business账户
- TikTok广告开发者账号及应用注册
本地安装
# Clone the repository
git clone
cd adsmcp-server
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -e .使用UV（推荐）
# Install with uv
uv sync远程MCP服务器选项
如果你不想自己托管服务器并手动进行设置， AdsMCP 提供一个远程MCP服务器。您可以轻松地在（系统/平台）内连接您的广告账户 一分钟，无需担心服务器配置或依赖问题。访问 AdsMCP 远程MCP服务器设置指南 以下是一个分步教程，帮助您快速连接您的广告账户。
MCP 客户端配置
在您的MCP客户端配置（例如，Claude Desktop）中添加：
{
"mcpServers": {
"tiktok-ads": {
"command": "python",
"args": ["/path/to/adsmcp-server/run_server.py"],
"cwd": "/path/to/adsmcp-server",
"env": {
"TIKTOK_APP_ID": "your_app_id",
"TIKTOK_APP_SECRET": "your_app_secret",
}
}
}
}可用工具
认证
tiktok_ads_login- 启动TikTok广告OAuth认证流程tiktok_ads_complete_auth- 完成带有授权码的OAuth认证tiktok_ads_auth_status- 检查当前的认证状态tiktok_ads_switch_ad_account- 切换到另一个广告商账户
活动管理
tiktok_ads_get_campaigns- 获取广告商账户下的所有广告系列tiktok_ads_get_campaign_details- 获取特定活动的详细信息tiktok_ads_get_adgroups- 获取广告系列的广告组
性能与分析
tiktok_ads_get_campaign_performance- 获取带有详细指标支持的活动性能指标tiktok_ads_get_adgroup_performance- 获取广告组的性能指标，并进行细分分析
认证
TikTok广告API设置
- 注册成为开发者
- 访问 TikTok商业开发者门户 - 创建一个开发者账户 - 注册您的申请
- 获取API凭据
- 来自您已注册应用的App ID和App Secret - 通过OAuth流程生成访问令牌 - 记下您的广告商ID
- OAuth 流程 （用于生产）
- 实现OAuth 2.0流程以进行用户授权 - 自动处理令牌刷新 - 安全存储令牌
安全最佳实践
- 永远不要将API凭据提交到版本控制系统中
- 使用环境变量来存储敏感数据
- 实施适当的令牌轮换
- 监控API使用情况和速率限制
- 所有通信均使用HTTPS
API速率限制
TikTok Ads API 有以下限制：
- 每个应用每小时1000次请求
- 10个并发请求
- 可能适用特定的终点限制
服务器内置了速率限制和重试逻辑。
错误处理
服务器提供全面的错误处理功能：
- API速率限制管理
- 令牌过期处理
- 网络连接问题
- 无效的参数验证
许可证
这个项目采用MIT许可证授权——详见 许可证 详情请查阅文件。
支持
对于问题和疑问，请在此仓库中创建一个议题。
更新日志
v0.1.0（初始发布）
- 基础TikTok广告API集成
- 活动和广告组管理
- 业绩报告
- OAuth认证支持
