最后更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文档均于当天查阅)
TikTok 报表自动化有两条路:让 Claude 通过 MCP 实时问数(见 Claude 自动生成 TikTok 广告日报与诊断),或者让 Codex 写一个稳定的拉数脚本,每天定时跑、结果可复核。这篇讲第二条:脚本怎么写、限流怎么处理,以及怎样让 Codex 只做「总结」而不碰帐户。
准备:开发者应用与访问令牌
官方步骤是:创建 TikTok for Business 帐号 → 注册开发者 → 创建开发者应用 → 广告主授权 → 认证 → 首次调用(Get started)。广告主授权后拿到的 auth_code 1 小时内有效且只能用一次,换取的长期访问令牌不会自动过期,但广告主取消授权后失效(Authentication):
# exchange the one-time auth_code (valid 1 hour) for a long-term access token
import os, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
r = requests.post(f"{BASE}/oauth2/access_token/", json={
"app_id": os.environ["TIKTOK_APP_ID"],
"secret": os.environ["TIKTOK_APP_SECRET"],
"auth_code": os.environ["TIKTOK_AUTH_CODE"], # from the advertiser authorization redirect
}, timeout=30).json()
assert r["code"] == 0, r["message"]
token = r["data"]["access_token"] # store in a secret manager, never in git
print("authorised advertisers:", r["data"].get("advertiser_ids"))让 Codex 写这段代码时,在 AGENTS.md 里写明「令牌只从环境变量读、不打印、不提交」。
报表脚本:分页 + 限流重试
# pull_report.py - synchronous report with paging and throttle handling
import os, json, time, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
H = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
def get(path, params, tries=5):
for i in range(tries):
r = requests.get(BASE + path, headers=H, params=params, timeout=60).json()
if r["code"] in (40100, 40016, 40133): # throttled
time.sleep(min(300, 15 * 2 ** i)); continue
if r["code"] != 0:
raise RuntimeError(f'{r["code"]} {r["message"]} {r.get("request_id")}')
return r["data"]
raise RuntimeError("still throttled")
def report(advertiser_id, start, end):
page, rows = 1, []
while True:
d = get("/report/integrated/get/", {
"advertiser_id": advertiser_id, "report_type": "BASIC",
"data_level": "AUCTION_CAMPAIGN",
"dimensions": json.dumps(["campaign_id", "stat_time_day"]),
"metrics": json.dumps(["spend", "impressions", "clicks", "ctr", "cpc",
"conversion", "cost_per_conversion"]),
"start_date": start, "end_date": end, # stat_time_day: max 30 days
"page": page, "page_size": 1000})
rows += d["list"]
if page >= d["page_info"]["total_page"]:
return rows
page += 1要点:dimensions 与 metrics 以 JSON 字符串传入;按 stat_time_day 拆天时最长 30 天;page_size 最大 1000;GMV Max 报表请改用 /gmv_max/report/get/(Run a synchronous report)。
限流等级
| 等级 | QPS | QPM | QPD |
|---|---|---|---|
| Basic(默认) | 10 | 600 | 864,000 |
| Advanced | 20 | 1,200 | 1,728,000 |
| Premium | 30 | 1,800 | 2,592,000 |
| Ultimate | 50 | 3,000 | 4,320,000 |

另外有接口级限制:异步报表创建(/report/task/create/)在所有等级都是 2 QPS、60 QPM、4,500 QPD;/ad/create/ 在 Basic 为 5 QPS(Rate limits)。
返回码怎么处理
| 返回码 | 含义 | 脚本怎么处理 |
|---|---|---|
| 0 | 成功 | 继续 |
| 40100 | 应用级限流(该接口) | 退避重试;QPM 超限暂停 5 分钟,QPD 超限等到 UTC 0 点 |
| 40016 | 请求过于频繁(应用级) | 同上 |
| 40133 | 广告主级限流 | 降低该广告主的调用频率 |
| 40011 | 单次请求 ID 过多 | 拆批 |
| 40050 | 重复请求 | 检查 request_id 是否重复使用 |

注意 TikTok 的业务错误码通常在 HTTP 200 的响应体里,脚本要判断 code 字段而不是只看 HTTP 状态码(Return codes)。
让 Codex 写、测、跑
- 给 Codex 本文的接口说明和 AGENTS.md,请它写 pull_report.py 并附上用假数据的单元测试(不调用真实 API)。
- 人工审查代码,重点看令牌处理、重试上限和日期范围。
- 用 cron 或 CI 每天跑脚本,再用
codex exec在只读沙盒里生成总结( - codex exec
- )。
# nightly report: script pulls data, codex exec (read-only sandbox by default) writes the summary
python pull_report.py --days 8 > report.csv
codex exec --ephemeral --output-schema summary_schema.json -o summary.json \
"Read report.csv. Summarise spend, CTR, CPC, conversions and CPA per campaign for \
yesterday vs the previous 7 days, list anomalies, propose (do not apply) budget changes."常见坑
- 把多个帐户放在同一循环里狂刷,触发 40133;按广告主错峰。
- 跨时区帐户直接相加;先按帐户时区对齐日期。
- QPD 用完后整天重试;QPD 在 UTC 0 点重置,脚本应直接停止并告警。
熊猫出海如何用 Claude、Codex 和 TikTok 广告帐户帮客户提升投放效率
这篇讲的是 Codex,但在实际服务中,熊猫出海会把 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 广告开户与投放(熊猫出海服务页)。
常见问题
用 MCP 不是更简单吗?
交互式问数用 MCP 更快;需要每天稳定跑、可审计、可回放的报表,用脚本更合适。
需要申请更高的 QPS 吗?
大多数中小广告主用 Basic 足够;确有需要时在 My Apps 里逐级申请,并写明理由。
Codex 会不会把令牌写进代码?
在 AGENTS.md 中禁止,并在代码审查和提交前扫描密钥。
能拉 GMV Max 的数吗?
可以,换用 /gmv_max/report/get/。GMV Max 实操见 GMV Max 投放实操:授权、建计划与 ROI 目标。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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 接入(熊猫出海)
- Codex 操作 TikTok 广告投放全流程自动化
- Claude 自动生成 TikTok 广告日报与诊断
- Codex + TikTok Marketing API: Python Smart+ pipeline
- TikTok 开发了 MCP:让 AI 直接操作你的广告投放
- 用 Codex 写 Google Ads 日报脚本(Google 篇)
- TikTok 广告归因窗口对比上线:38 个新指标
- 大模型 API Key 申请与安全管理
联系熊猫出海:TikTok 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业(是否需要行业准入/加白)、目标国家、落地页/App/TikTok Shop 链接和预计月预算,以及你想先自动化哪一段(报表、素材、Smart+ 建系列还是规则)。我们先做资质与素材预审,再协助企业合规开通 TikTok 海外户、加白户或海外代理户,并把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- TikTok: Get started for Marketing API
- TikTok: Marketing API authentication
- TikTok: Run a synchronous report
- TikTok: Rate limits (API for Business)
- TikTok: Return codes
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Supported countries and territories
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

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