内容
# TikTok MCP 服务器
专注于 **TikTok 商业 API v1.3** 的 Smart+ TRAFFIC 目标的 MCP 服务器。包含 21 个工具，覆盖了广告活动创建、目标搜索（位置、兴趣、行为）、创意管理、报告、身份列表和批量状态更新。
单文件 FastMCP 服务器。MCP 客户端进行 NL 解析；该服务器提供类型化接口并针对 TikTok 的 Smart+ 架构进行验证。
## 安装
```bash
pip install -r requirements.txt
```
## 运行
```bash
TIKTOK_ACCESS_TOKEN=<您的令牌> \
TIKTOK_ADVERTISER_ID=<您的广告商 ID> \
python server.py
```
默认为 **沙盒** 基地址（`https://sandbox-ads.tiktok.com/open_api/v1.3`）。生产环境：
```bash
TIKTOK_API_BASE_URL=https://business-api.tiktok.com/open_api/v1.3 \
TIKTOK_ACCESS_TOKEN=... \
TIKTOK_ADVERTISER_ID=... \
python server.py
```
### 获取令牌
TikTok for Business → 开发者门户 → 创建应用 → 为您的广告商 ID 请求 `Access-Token`。在开发过程中使用沙盒令牌（无实际支出，无实际受众范围）。
## 工具列表
- **广告活动 / 广告组 / 广告** — 创建、获取、列出、更新、验证有效载荷
- **目标搜索** — 位置、兴趣、行为
- **创意** — 列出创意资产、列出应用条目
- **身份** — 列出 Spark Ads 身份
- **报告** — 广告活动级洞察，带有分解维度
- **批量操作** — 跨实体的批量状态更新
所有工具共用 `tt_*` 命名约定，与多平台 `meta-ads-mcp` 兄弟项目相同。
## MCP 客户端配置
```json
{
"mcpServers": {
"tiktok-ads": {
"command": "python",
"args": ["/绝对路径/to/tiktok-mcp-server/server.py"],
"env": {
"TIKTOK_ACCESS_TOKEN": "...",
"TIKTOK_ADVERTISER_ID": "..."
}
}
}
}
```
## 许可证
MIT
