TikTok 广告 MCP 服务器

这是一个用于 TikTok 广告 API 集成的模型上下文协议（MCP）服务器。该服务器使像 Claude 这样的AI助手能够与 TikTok 广告活动进行交互，提供全面的广告活动管理、分析和优化功能。

该项目是 AdsMCP AI 广告自动化平台 的一部分，这是一个由人工智能驱动的平台，旨在简化并自动化跨多个广告网络的广告活动管理。该平台强调效率、数据驱动的洞察力以及智能自动化，适用于营销人员和代理机构。此外，AdsMCP 还支持与其他广告平台（如 Google Ads 和 Meta（Facebook）Ads）的集成，使得从单一界面管理多个网络的广告活动变得更加容易。

功能

• 广告活动管理：创建、读取和更新广告活动及广告组
• 性能分析：获取详细的性能指标和洞察
• 受众管理：处理自定义受众和定位选项
• 创意管理：上传和管理广告创意
• 报告生成：生成并下载定制的性能报告

安装

先决条件

• Python 3.10+
• 具有 API 访问权限的 TikTok For Business 账户
• TikTok 广告开发者账户和应用注册

本地安装

# 克隆仓库
git clone <repository-url>
cd adsmcp-server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上使用：venv\Scripts\activate

# 安装依赖
pip install -e .

使用 uv 安装（推荐）

# 使用 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 设置

1. 注册为开发者

   • 访问 TikTok For Business 开发者门户
   • 创建一个开发者账户
   • 注册您的应用程序

2. 获取 API 凭据

   • 从已注册的应用程序获取 App ID 和 App Secret
   • 通过 OAuth 流程生成访问令牌
   • 记录您的广告主 ID

3. OAuth 流程（生产环境）

   • 实现 OAuth 2.0 流程以进行用户授权
   • 自动处理令牌刷新
   • 安全存储令牌

安全最佳实践

• 不要将 API 凭据提交到版本控制
• 使用环境变量存储敏感数据
• 实现适当的令牌轮换
• 监控 API 使用情况和速率限制
• 使用 HTTPS 进行所有通信

API 速率限制

TikTok 广告 API 有以下限制：

• 每个应用每小时 1000 次请求
• 最多 10 个并发请求
• 特定端点可能有不同的限制

服务器内置了速率限制和重试逻辑。

错误处理

服务器提供了全面的错误处理：

• API 速率限制管理
• 处理令牌过期
• 网络连接问题
• 参数验证

许可证

本项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。

支持

对于问题和疑问，请在此仓库中创建一个 Issue。

更新日志

v0.1.0（初始发布）

• 基础的 TikTok 广告 API 集成
• 广告活动和广告组管理
• 性能报告
• OAuth 认证支持