最后更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文档均于当天查阅)
Claude 篇讲了「AI 直接操作」,这篇讲 OpenAI Codex。Codex 是编码代理,最擅长的是把投放工作变成可测试、可审计的脚本,同时它也能像 Claude 一样直接连 TikTok 官方 MCP:TikTok 的连接指南把 Codex 列为可连接平台之一(官方连接指南)。TikTok 官方的 TikTok for Business MCP Server 由 TikTok 托管,把约 400 个 TikTok API for Business 接口封装成 MCP 工具,提供两个地址:全量版 tt-ads-mcp-flat(约 400 个工具一次加载)和渐进版 tt-ads-mcp-layer(先加载约 40 个核心工具);不需要注册开发者或创建开发者应用,用 TikTok for Business 帐号授权即可,授权有效期 30 天,每个工具每个用户限 6 QPS。
Codex 在 TikTok 投放流程里的 6 个环节
| 环节 | Codex 怎么做 | 产出 | 人工节点 |
|---|---|---|---|
| 1 接入 | codex mcp add + codex mcp login | 可用的 tiktok-ads 服务器 | 确认授权帐户 |
| 2 规则 | 写 AGENTS.md | DISABLE、request_id、限流等硬规则 | 审核规则 |
| 3 报表 | 写 pull_report.py | 分页 + 限流重试的日报脚本 | 核对口径 |
| 4 建系列 | 写 create_smart_plus.py | 以 DISABLE 创建的 Smart+ 脚本 | 代码审查 |
| 5 定时 | codex exec 只读总结 | summary.json 日报 | 阅读并决策 |
| 6 迁移 | 扫描旧版手动流程代码 | Smart+ 迁移清单 | 排期上线 |

三种接入方式
| 方式 | 适合 | 凭据 | 写入控制 |
|---|---|---|---|
| Codex + TikTok MCP(OAuth) | 交互式查数、起草、少量写入 | TikTok for Business 授权(30 天) | default_tools_approval_mode = “writes” |
| Codex + MCP(访问令牌) | 无人值守的只读任务 | Marketing API 长期访问令牌(环境变量) | enabled_tools 只放读工具 |
| Codex 写的 API 脚本 | 批量、可测试、可审计 | 开发者应用 + 访问令牌 | 代码审查 + DISABLE |

第 1 步:接入 TikTok MCP
# Codex CLI: add TikTok's hosted MCP server and sign in (OAuth, CIMD/DCR)
npm install -g @openai/codex
codex mcp add tiktok-ads --url https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer
codex mcp login tiktok-ads # opens TikTok for Business authorization in the browser
codex mcp list
# inside the codex TUI: /mcp shows the server and its toolsCodex 支持 OAuth(含 CIMD 与 DCR 客户端注册),TikTok 的 MCP 授权正是 OAuth 2.0 + PKCE,并支持 CIMD/DCR(Codex MCP、TikTok 自建代理指南)。
第 2 步:用 config.toml 管住写入
default_tools_approval_mode = "writes" 会对所有未标记只读的工具弹出确认;TikTok 的工具带有 readOnlyHint 注解,正好配合使用。商务中心与付款类工具直接禁用。详细说明见 Codex config.toml for the TikTok for Business MCP server。
# ~/.codex/config.toml (or a trusted project's .codex/config.toml)
[mcp_servers.tiktok-ads]
url = "https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer"
tool_timeout_sec = 120
default_tools_approval_mode = "writes" # prompt for every tool not marked read-only
disabled_tools = [
"bc_member_invite", "bc_asset_assign", "bc_transfer",
"payment_portfolio_credit_line_update", "advertiser_update",
]
[mcp_servers.tiktok-ads.tools.smart_plus_adgroup_budget_update]
approval_mode = "prompt" # always ask before budget edits
[mcp_servers.tiktok-ads.tools.campaign_status_update]
approval_mode = "prompt"第 3 步:写 AGENTS.md
Codex 每次任务前都会读取仓库根目录的 AGENTS.md(AGENTS.md)。把 TikTok 的硬规则写进去:
# AGENTS.md (repo root) - rules Codex reads before every task
## TikTok ads automation rules
- Only touch advertiser IDs listed in accounts.allowlist (our own / client-authorised,
assigned in the client's Business Center).
- Read TIKTOK_APP_ID, TIKTOK_APP_SECRET and TIKTOK_ACCESS_TOKEN from env vars.
Never print, log or commit them, never put them in prompts.
- Create every campaign, ad group and ad with operation_status = "DISABLE".
Never send "ENABLE". A media buyer turns delivery on in Ads Manager.
- Generate request_id once per create call (string of a 64-bit int) and reuse it
on retries so TikTok de-duplicates.
- Budgets are floats in account currency. Never raise a budget >20% in one change.
- Respect rate limits: on code 40100/40016 back off; after a QPM hit wait 5 minutes.
- Upgraded Smart+ ads: max one create/update/status call per ad every 5 seconds.
- Do not build new non-Search Legacy Manual campaigns (unsupported from 2027-01-01).
- Run `pytest -q` and `python -m scripts.dry_run` before proposing changes.
- Flag finance, health, gambling/games, dating and AIGC creatives for human policy review.第 4 步:报表与建系列脚本
让 Codex 写两个脚本:带分页和限流重试的报表拉取(见 用 Codex 写 TikTok Marketing API 报表脚本与限流处理),以及以 DISABLE 创建 Smart+ 的建系列脚本(英文完整版见 Codex + TikTok Marketing API: Python Smart+ pipeline):
# create_smart_plus.py - Upgraded Smart+ campaign, created switched OFF
import os, random, requests
BASE = "https://business-api.tiktok.com/open_api/v1.3"
H = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"], "Content-Type": "application/json"}
def new_request_id():
return str(random.getrandbits(63)) # string of a 64-bit int; reuse on retry
def create_campaign(advertiser_id, name, daily_budget, request_id=None):
body = {
"advertiser_id": advertiser_id,
"request_id": request_id or new_request_id(),
"objective_type": "WEB_CONVERSIONS",
"sales_destination": "WEBSITE", # required for WEB_CONVERSIONS
"campaign_name": name,
"operation_status": "DISABLE", # default is ENABLE - never rely on it
"budget_optimize_on": True,
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget": float(daily_budget), # account currency units
}
r = requests.post(f"{BASE}/smart_plus/campaign/create/", headers=H, json=body, timeout=60).json()
if r["code"] != 0:
raise RuntimeError(f'{r["code"]} {r["message"]} request_id={body["request_id"]}')
return r["data"]第 5 步:codex exec 定时总结
codex exec 默认在只读沙盒中运行(codex exec)。脚本负责拉数,Codex 只负责总结和建议:
# 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."第 6 步:提前处理 2027 年的变化
TikTok 官方提示:自 2027-01-01 起,/campaign/create/、/campaign/copy/task/create/、/adgroup/create/、/ad/create/、/ad/aco/create/ 将不再支持为销售、应用推广和线索收集目标创建或复制非搜索的旧版手动(Legacy Manual)系列,需迁移到 Upgraded Smart+ 接口(TikTok 公告)。让 Codex 扫描现有代码里对这些接口的调用并列出迁移清单,见 Codex 協助把 TikTok 舊版手動廣告遷移到 Upgraded Smart+。
限流要点
- 开发者应用默认 Basic:10 QPS/600 QPM/864,000 QPD;/ad/create/ 在 Basic 级别为 5 QPS;QPD 在 UTC 0 点重置(
- Rate limits
- )。
- 40100、40016 为应用级限流,40133 为广告主级限流(
- Return codes
- )。
- MCP 每个工具每个用户 6 QPS;同一条 Smart+ 广告每 5 秒最多 1 次操作。
熊猫出海如何用 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 广告开户与投放(熊猫出海服务页)。
常见问题
Codex 和 Claude 选哪个?
日常问数、诊断适合 Claude;要沉淀成脚本、定时任务和 CI 的部分适合 Codex。熊猫出海通常两者并用。
Codex 需要 TikTok 开发者应用吗?
只连 MCP 不需要;写 Marketing API 脚本需要开发者应用和广告主授权。
中国大陆能用 Codex 吗?
OpenAI 不支持中国大陆和香港,请由支持地区的合法主体使用,参考 ChatGPT API 怎么购买?企业开通 OpenAI API。
脚本出错会不会乱花钱?
脚本只以 DISABLE 创建、预算单次变动有上限、开启由人做,这三条写进 AGENTS.md 并在代码审查中检查。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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 Marketing API 报表脚本与限流处理
- Codex config.toml for the TikTok for Business MCP server
- Claude 操作 TikTok 广告投放全流程自动化
- 如何将 Claude 链接到 TikTok 广告(TikTok MCP 教程)
- TikTok 开发了 MCP:让 AI 直接操作你的广告投放
- Codex 操作 Google 广告全流程自动化(Google 篇)
- Codex 操作 Facebook 广告全流程自动化(Facebook 篇)
- TikTok 广告投放全流程指南(2026)
联系熊猫出海:TikTok 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业(是否需要行业准入/加白)、目标国家、落地页/App/TikTok Shop 链接和预计月预算,以及你想先自动化哪一段(报表、素材、Smart+ 建系列还是规则)。我们先做资质与素材预审,再协助企业合规开通 TikTok 海外户、加白户或海外代理户,并把 Claude / Codex 接入你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- TikTok: How to connect a ready-made agent to TikTok for Business MCP Server
- TikTok: How to connect a custom agent to TikTok for Business MCP Server
- TikTok API for Business: TikTok for Business MCP Server overview
- TikTok: Create an Upgraded Smart+ campaign
- TikTok: Rate limits (API for Business)
- TikTok: Return codes
- OpenAI: Codex and MCP
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Codex non-interactive mode (codex exec)
- OpenAI: Codex configuration reference
- OpenAI: Supported countries and territories
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

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