最後更新:2026-11-16(Meta、Anthropic、OpenAI 官方文件皆於當天查閱)
這篇只做一件事:讓 Claude 把一份投放 Brief 變成 Facebook 上「暫停狀態」的行銷活動、廣告組合、創意和廣告,最後由投手在廣告管理員檢查後啟用。我們不透過 MCP,而是直接呼叫 Meta Marketing API,這樣每一個參數都看得見、可測試、可版本控管。想用 MCP 對話式操作,請看 如何將 Claude 連結到 Facebook 廣告。
四層物件與分工
| 物件 | API 端點 | 必要/關鍵參數 | Claude 協助的地方 |
|---|---|---|---|
| 行銷活動 Campaign | POST /act_id/campaigns | name、objective、status、special_ad_categories | 依 Brief 選目標、命名 |
| 廣告組合 Ad set | POST /act_id/adsets | campaign_id、預算(以分計)、billing_event、optimization_goal、targeting | 把受眾描述轉成 targeting JSON |
| 廣告創意 Creative | POST /act_id/adcreatives | object_story_spec(page_id、link、message、image_hash) | 撰寫文案初稿 |
| 廣告 Ad | POST /act_id/ads | adset_id、creative、status | 產出待啟用清單 |

準備:系統使用者權杖與環境變數
在企業管理平台建立系統使用者,指派需要的廣告帳戶與粉絲專頁,產生具 ads_management 權限的權杖(Marketing API 驗證)。權杖只放在環境變數或密鑰管理服務,不貼進對話,也不寫進 Git:
# .env (add .env to .gitignore; never commit or paste tokens into a prompt)
META_API_VERSION=v27.0
META_AD_ACCOUNT_ID=act_<AD_ACCOUNT_ID>
META_PAGE_ID=<PAGE_ID>
META_SYSTEM_USER_TOKEN=<SYSTEM_USER_ACCESS_TOKEN>第 1 步:讓 Claude 把 Brief 轉成參數
在 Claude Code 裡提供 Brief 與規則,要求它只輸出 JSON,不呼叫任何 API:
讀取 brief.md:美國市場、導流到官網、每日預算 50 美元、25–54 歲、廣泛受眾、
2 組文案。依 rules.md 命名規範,輸出 plan.json:
campaign{name,objective}, adsets[{name,daily_budget_cents,targeting}],
ads[{name,primary_text,headline,cta,image_file}]。
預算一律以「分」為單位;不要呼叫任何 API。人工檢查 plan.json(特別是預算、國家、年齡和文案)後,才進入下一步。
第 2 步:建立行銷活動
special_ad_categories 為必填;若業務屬於信貸、就業、住房或社會議題/選舉政治,必須宣告對應類別(Campaign 參考、Special ad category)。用 curl 測試單一請求:
curl -X POST "https://graph.facebook.com/v27.0/$META_AD_ACCOUNT_ID/campaigns" \
-H "X-Client-Idempotent-Key: $(uuidgen)" \
-F 'name=PWM | US | Traffic | Nov' \
-F 'objective=OUTCOME_TRAFFIC' \
-F 'status=PAUSED' \
-F 'special_ad_categories=[]' \
-F "access_token=$META_SYSTEM_USER_TOKEN"第 3 步:用腳本建立完整結構(全部暫停)
正式批次建立時,用 Python 用戶端加上冪等鍵與退避。Meta 的冪等鍵適用於行銷活動、廣告組合、廣告和創意的建立,鍵在 7 天內有效,範圍是單一廣告帳戶(冪等請求):
# meta_api.py - minimal Marketing API client (Python 3.10+, pip install requests)
import os, time, json, uuid, requests
API = "https://graph.facebook.com/" + os.environ.get("META_API_VERSION", "v27.0")
TOKEN = os.environ["META_SYSTEM_USER_TOKEN"] # from env / secret manager only
ACT = os.environ["META_AD_ACCOUNT_ID"] # e.g. act_1234567890
THROTTLE = {4, 17, 613, 80000, 80003, 80004, 80014} # rate-limit codes in Meta's docs
def call(method, path, params=None, data=None, idem_key=None, tries=5):
headers = {"X-Client-Idempotent-Key": idem_key} if idem_key else {}
for attempt in range(tries):
r = requests.request(method, f"{API}/{path}", headers=headers, timeout=60,
params={**(params or {}), "access_token": TOKEN} if method == "GET" else None,
data={**(data or {}), "access_token": TOKEN} if method != "GET" else None)
for h in ("X-Business-Use-Case-Usage", "X-Ad-Account-Usage", "X-FB-Ads-Insights-Throttle"):
if h in r.headers:
print(h, r.headers[h]) # log usage, back off early
body = r.json()
err = body.get("error")
if not err:
return body
if err.get("code") in THROTTLE or r.status_code >= 500:
time.sleep(min(60 * 2 ** attempt, 900)) # exponential backoff
continue # same idem_key -> no duplicates
raise RuntimeError(json.dumps(err))
raise RuntimeError("rate limited: giving up, try later")
def key(run_id, name):
"""Stable idempotency key per object, so a retry never creates a duplicate."""
return str(uuid.uuid5(uuid.NAMESPACE_URL, f"{ACT}/{run_id}/{name}"))# create_paused.py - campaign -> ad set -> creative -> ad, everything PAUSED
import json
from meta_api import call, key, ACT
import os
RUN = "2026-11-16-us-traffic"
camp = call("POST", f"{ACT}/campaigns", data={
"name": "PWM | US | Traffic | Nov",
"objective": "OUTCOME_TRAFFIC",
"status": "PAUSED",
"special_ad_categories": json.dumps([]), # required; declare a category if it applies
"is_adset_budget_sharing_enabled": "0",
}, idem_key=key(RUN, "campaign"))
adset = call("POST", f"{ACT}/adsets", data={
"name": "US | 25-54 | broad",
"campaign_id": camp["id"],
"daily_budget": "5000", # in cents of the account currency = 50.00
"billing_event": "IMPRESSIONS",
"optimization_goal": "LINK_CLICKS",
"bid_strategy": "LOWEST_COST_WITHOUT_CAP",
"targeting": json.dumps({"geo_locations": {"countries": ["US"]},
"age_min": 25, "age_max": 54}),
"status": "PAUSED",
}, idem_key=key(RUN, "adset-us-broad"))
creative = call("POST", f"{ACT}/adcreatives", data={
"name": "US | hook-A",
"object_story_spec": json.dumps({
"page_id": os.environ["META_PAGE_ID"],
"link_data": {"message": "<approved primary text>",
"link": "https://www.example.com/landing",
"image_hash": "<IMAGE_HASH>",
"call_to_action": {"type": "LEARN_MORE"}}}),
}, idem_key=key(RUN, "creative-hook-A"))
ad = call("POST", f"{ACT}/ads", data={
"name": "US | hook-A",
"adset_id": adset["id"],
"creative": json.dumps({"creative_id": creative["id"]}),
"status": "PAUSED", # a human activates after review
}, idem_key=key(RUN, "ad-hook-A"))
print(camp["id"], adset["id"], creative["id"], ad["id"])Claude 可以依 plan.json 迴圈呼叫上面的流程,或幫你補上 dry-run 與單元測試。v27.0 的變更(例如裝置自動化預設開啟、部分定位欄位被拒)請先看 Marketing API v27.0 更新解讀。
第 4 步:人工檢查並啟用
- 在廣告管理員檢查預算、受眾、版位、追蹤與落地頁。
- 確認文案符合 Meta 廣告刊登準則(
- 廣告刊登準則
- )。
- 由投手手動啟用;不要讓 AI 在無人值守時啟用。
常見錯誤
| 常見錯誤 | 原因 | 處理方式 |
|---|---|---|
| 缺少 special_ad_categories | 建立行銷活動時為必填 | 無特殊類別時傳空陣列 [] |
| 預算金額差 100 倍 | 預算以帳戶貨幣最小單位計 | 50.00 美元填 5000 |
| 重試後出現重複物件 | 逾時後重送沒帶冪等鍵 | 使用 X-Client-Idempotent-Key,重試沿用同一鍵 |
| 613 錯誤 | 超過寫入頻率限制 | 指數退避;同一物件 30 秒內只改一次 |
| v27 拒絕 location_spec | v27.0 起相關欄位被拒 | 改用目前文件列出的定位欄位 |

寫入頻率限制:同一廣告帳戶每秒最多 100 次寫入請求、同一物件每 30 秒只能修改一次、同一廣告組合預算每小時最多改 4 次(Rate limiting)。
熊貓出海如何用 Claude、Codex 與 Facebook 廣告帳戶提升客戶投放效率
本文主角是 Claude,但在實際服務中,熊貓出海會把 Claude、Codex 與 Facebook 企業廣告帳戶組合使用,協助出海企業更快完成「開戶 → 建立結構 → 上素材 → 看數據 → 調預算」這套重複工作,讓投放團隊把時間留給策略與素材判斷。
- 廣告帳戶:使用企業自己的 Facebook 廣告帳戶,或透過熊貓出海開戶服務合規開通的企業戶;帳戶歸企業所有,不出租、不共享。
- Claude:適合閱讀長文件與報表、撰寫投放規劃與文案初稿、透過 Meta 廣告 MCP 以暫停狀態起草廣告結構、依規則排查異常。
- Codex:適合撰寫與維護自動化腳本(Marketing API、Insights 報表、批次上傳、預算規則),在沙盒中執行並接入排程或 CI。
- 人工把關:所有會花錢的動作(啟用廣告、提高預算)都由投手審核後執行;Meta 廣告政策與素材合規由人工最終確認。
這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 Facebook 廣告代操與海外開戶(熊貓出海服務頁)。
常見問題
一定要用系統使用者權杖嗎?
自動化場景建議用系統使用者權杖,不依賴個人帳號登入狀態,也方便控管權限。
Claude 會不會直接把預算設錯?
讓它只產出 plan.json,由腳本建立暫停物件,再由人工檢查,預算錯誤能在上線前攔下。
可以用 v25 或 v26 嗎?
可以使用仍在支援期內的版本,但新專案建議使用目前最新的 v27.0。
建立後為什麼看不到投放?
因為全部以 PAUSED 建立,需要人工啟用。
Claude 在台灣可以用嗎?
依 Anthropic 支援地區清單,台灣在支援範圍內;實際方案與付款方式以官方為準。
合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的廣告帳戶、粉絲專頁與像素,透過 Meta 官方 Marketing API、Ads MCP 伺服器或 Ads CLI 接入,使用企業管理平台中的系統使用者與最小權限,遵守 Meta 速率限制與《廣告刊登準則》,並在任何會產生花費的動作前保留人工審核。熊貓出海不販售、出租、共享或轉讓廣告帳戶、企業管理平台或 API 金鑰,不協助規避廣告審查、地區限制、KYC、企業驗證或付款管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。
延伸閱讀
- Facebook 廣告代操與海外開戶(熊貓出海服務頁)
- 海外 AI Token 服務:帳號開通 + API 接入(熊貓出海)
- Claude 自動化 Facebook 廣告的 Meta 政策合規與人工審核
- 如何將 Claude 連結到 Facebook 廣告
- Codex 批量上傳 Facebook 廣告素材(adimages)
- Meta 開發了 MCP,讓 AI 直接操作你的廣告投放
- Facebook 企業戶建置清單
- AI Token 是什麼?
聯絡熊貓出海:Facebook 開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(建立結構、素材、報表或預算規則)。我們先做資格與素材預審,再協助開通合規的 Facebook 企業廣告帳戶,並用 Claude、Codex 建立在您自有帳戶上執行的自動化流程。我們不販售、出租或共享任何廣告帳戶。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

官方來源
- Meta: Marketing API authentication
- Meta: Ad account campaigns reference
- Meta: Create an ad campaign
- Meta: Create an ad set
- Meta: Create an ad creative
- Meta: Create an ad
- Meta: Idempotent requests
- Meta: Marketing API rate limiting
- Meta: Special ad category (Marketing API)
- Meta Advertising Standards
- Meta: Marketing API v27.0 changelog
- Anthropic: Supported regions
以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

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