最后更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文档均于当天查阅)
投手每天最花时间的,往往不是调广告,而是拉数、对比、找异常。通过 TikTok 官方的 TikTok for Business MCP Server,Claude 可以直接调用报表工具和官方诊断代理,把这部分工作自动化(MCP 概览)。本文只讲只读部分:看数、诊断、提建议,不改任何东西。全流程见 Claude 操作 TikTok 广告投放全流程自动化。
报表工具怎么选
report_integrated_get:同步报表,对应 /report/integrated/get/,适合日报、周报。report_task_create+report_task_check+report_task_download:异步报表,适合大数据量;异步创建接口在所有级别都是 2 QPS、60 QPM(- Rate limits
- )。
creative_report_get、report_video_performance_get:素材与视频表现。gmv_max_report_get:GMV Max 系列请用专用报表,普通报表不覆盖。
同步报表的关键参数
| 参数 | 含义 | 注意 |
|---|---|---|
| report_type | 报表类型,如 BASIC | 受众、商品等用其他类型 |
| data_level | 数据层级,如 AUCTION_CAMPAIGN/AUCTION_ADGROUP/AUCTION_AD | 按需要的粒度选 |
| dimensions | 分组维度,如 campaign_id + stat_time_day | 按天(stat_time_day)时最长 30 天 |
| metrics | 指标,如 spend、impressions、clicks、ctr、cpc、conversion | 不传时默认 spend、impressions |
| start_date / end_date | 日期范围 | 按帐户时区 |
| page / page_size | 分页 | page_size 1–1000 |

官方说明:同步报表最多支持 20,000 条广告的数据;按 stat_time_day 拆天时日期范围最长 30 天;响应头里的 X-Tt-Ads-Throttle 会提示限流(Run a synchronous report)。
官方诊断代理:tiktok_ads_diagnosis_agent
TikTok MCP 里有两个不直接对应 API 接口的工具。其中 tiktok_ads_diagnosis_agent 是官方的帐户优化分数(AOS)诊断代理,以 A2A(代理对代理)方式被调用,可诊断非 GMV Max 帐户、系列或广告组的效果问题,用自然语言输出结论,Claude 可以把它当成「第二意见」(工具清单)。
异常 → 先查什么
| 异常信号 | Claude 先查什么 | 可能原因 | 建议动作(人工确认) |
|---|---|---|---|
| 花费突然下降 | 系列/广告组状态、审核信息 | 广告被拒、预算用完、帐户余额 | 查 ad_review_info_get,补素材或余额 |
| CPA 上涨 | 按广告组和素材拆分、频次 | 素材疲劳、定向过窄 | 换素材、放宽定向 |
| CTR 下降 | 素材维度报表 | 前 3 秒钩子变弱 | 用创意测试代理做 A/B |
| 转化掉零 | 像素/事件、落地页 | 事件断流、页面故障 | 查事件管理与落地页 |
| 归因差异大 | 1 天点击 vs 7 天点击对比 | 决策周期长 | 按归因窗口对比列复盘 |

归因窗口对比是 2026 年 11 月 Ads Manager 的新功能,详见 TikTok 广告归因窗口对比上线:38 个新指标;搜索广告展示份额见 TikTok 搜索广告展示份额与关键词包;GMV Max 不投放的状态排查见 GMV Max 不投放怎么办?9 种素材状态。
诊断提示词模板
# 适合交给 Claude 的 TikTok 指令示例(先读后写)
1. 列出我能访问的广告主,以及每个帐户昨天的花费、点击和转化。
2. 用 tiktok_ads_diagnosis_agent 诊断广告主 <ID> 下 CPA 上涨最多的 3 个广告组,给出原因。
3. 为新品写 Smart+ 网站转化系列方案:命名、预算、素材清单;先不要创建。
4. 方案确认后,用 smart_plus_campaign_create 以 DISABLE 状态创建,并把返回的 ID 列出来。第 3、4 条涉及写入,日报任务里不要放;需要建系列时按 Claude 操作 TikTok 广告投放全流程自动化 的权限设置走。
定时只读日报
用 claude -p 加 --allowedTools 只放行读工具,结果输出为 JSON 再推送给投手(headless 模式):
# read-only daily summary, only read tools allowed
claude -p "Use tiktok-ads to pull yesterday's spend, impressions, clicks, CTR, CPC and \
conversions by campaign for advertiser <ADVERTISER_ID> with report_integrated_get. \
Compare with the previous 7 days, flag anomalies, propose (do not apply) changes." \
--allowedTools "mcp__tiktok-ads__report_integrated_get,mcp__tiktok-ads__campaign_get" \
--output-format json > tiktok-summary.json如果你的团队更习惯脚本 + 模型总结,可以用 Codex 写拉数脚本,见 用 Codex 写 TikTok Marketing API 报表脚本与限流处理。
三个容易出错的地方
- 授权过期:MCP 授权 30 天有效,定时任务突然失败先看是否需要重新授权。
- 工具找不到:用 layer 版时报表类工具可能需要按需发现;或 Claude 未加载全部工具,刷新工具列表即可,见
- Claude 连接 TikTok 广告常见问题排查
- 。
- 口径不一致:帐户时区、归因窗口、币种不同,跨帐户汇总前先统一口径。
熊猫出海如何用 Claude、Codex 和 TikTok 广告帐户帮客户提升投放效率
这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 TikTok 广告帐户组合起来,帮出海企业更快跑完「开户与像素/事件 → 搭 Smart+ 系列 → 素材上传与预审 → 看报表与诊断 → 调预算与规则」这套重复工作,让投手把时间花在素材策略、出价判断和放量节奏上。
- 广告帐户:使用企业自有的 TikTok 海外户;需要行业准入的(如游戏、金融等)按 TikTok 政策申请加白户;也可通过授权代理商开通海外代理户。所有帐户以企业真实主体开通、归企业使用,不出租、不共享,多帐户通过企业自己的商务中心(BC)管理。
- Claude:通过 TikTok 官方 TikTok for Business MCP Server 用自然语言查报表、调用官方诊断代理、整理素材与 Smart+ 建系列方案,写入类工具一律先确认再执行。
- Codex:写和维护 Marketing API v1.3 的 Python 脚本(报表拉取、限流重试、Smart+ 以 DISABLE 状态批量创建、request_id 幂等),在沙盒里运行并接入定时任务。
- 人工把关:开启投放、提预算、改出价都由投手审核后执行;素材与落地页是否符合 TikTok 广告政策由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投流程请看 TikTok 广告开户与投放(熊猫出海服务页)。
常见问题
Claude 看数会不会改到我的广告?
只要像本文这样只放行读工具(allowedTools 只写 report 与 get 类工具),Claude 无法调用写入工具。
能看 GMV Max 的数据吗?
可以,但要用 gmv_max_report_get;官方诊断代理也不覆盖 GMV Max。GMV Max 实操见 GMV Max 投放实操:授权、建计划与 ROI 目标。
报表数据和后台不一致?
先核对时区、归因窗口和 data_level;同一时间段按天拆分时最长 30 天。
多帐户怎么一起看?
用同一个 TikTok for Business 用户授权,并在企业自己的 BC 里给这个用户分配需要的帐户。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 TikTok 广告帐户(含商务中心 BC 下分配给你的帐户),通过 TikTok 官方 TikTok API for Business、TikTok for Business MCP Server 或 TikTok 广告管理平台接入,遵守 TikTok 广告政策、行业准入要求与 API 限流,并在任何会产生花费的动作前保留人工审核。TikTok 海外户、加白户、海外代理户都应由广告主以真实主体和资质开通、归广告主使用;熊猫出海不出售、出租、共享或转让广告帐户、BC 或 API 凭据,不协助规避广告审核、行业准入、地区限制或身份验证,也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- TikTok 广告开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- Claude 操作 TikTok 广告投放全流程自动化
- 用 Codex 写 TikTok Marketing API 报表脚本与限流处理
- 如何将 Claude 链接到 TikTok 广告(TikTok MCP 教程)
- TikTok 开发了 MCP:让 AI 直接操作你的广告投放
- Claude 用 GAQL 自动生成 Google Ads 报表(Google 篇)
- TikTok 广告归因窗口对比上线:38 个新指标
- TikTok 广告管理平台后台教程(2026)
- TikTok 广告效果怎么样?拆分测试判断效果
联系熊猫出海:TikTok 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业(是否需要行业准入/加白)、目标国家、落地页/App/TikTok Shop 链接和预计月预算,以及你想先自动化哪一段(报表、素材、Smart+ 建系列还是规则)。我们先做资质与素材预审,再协助企业合规开通 TikTok 海外户、加白户或海外代理户,并把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- TikTok API for Business: TikTok for Business MCP Server overview
- TikTok: Available tools in TikTok for Business MCP Server
- TikTok: Run a synchronous report
- TikTok: Rate limits (API for Business)
- Anthropic: Run Claude Code programmatically (claude -p)
- Anthropic: Claude Code permissions
- Anthropic: Supported regions
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
