最後更新:2026-11-16(Meta、Anthropic、OpenAI 官方文件皆於當天查閱)
Facebook 投放裡最機械化的工作,大概就是「把幾十張圖傳上去、記下每張的 hash、再一張張組成創意」。這正好適合交給 OpenAI Codex:讓它寫一套可測試的批次上傳工具,你只負責素材審核和最後的啟用。Claude 版本(簡體中文)請看 用 Claude 生成並批次上傳素材。
工具組成
| 工具/檔案 | 用途 | Codex 產出 | 人工檢查 |
|---|---|---|---|
| approved/ | 只放審核通過的圖片 | — | 品牌、版權、政策 |
| upload_images.py | 上傳並記錄 檔名→hash | 程式與測試 | 抽查上傳結果 |
| copy_images.py | 用 copy_from 複製到其他帳戶 | 程式 | 確認目標帳戶有授權 |
| make_creatives.py | 文案 × 圖片 組合建立創意 | 程式(含冪等鍵) | 預覽 |
| fatigue_webhook.py | 接收素材疲勞通知 | 程式 | 決定換素材 |

第 1 步:先寫 AGENTS.md
Codex 每次工作前會讀 AGENTS.md(AGENTS.md)。素材相關的規則要特別寫清楚:只處理 approved/ 資料夾、不修改原圖、不把權杖寫進程式碼。
# AGENTS.md (repo root) - rules Codex reads before every task
## Meta ads automation rules
- Only touch ad accounts listed in accounts.allowlist (our own / client-authorised).
- Read tokens from env vars (META_SYSTEM_USER_TOKEN, META_ADS_MCP_TOKEN). Never print,
log or commit them. Never put them in prompts.
- Create every campaign, ad set and ad with status=PAUSED. Never activate anything.
- Never raise a daily budget by more than 20% in one change; budgets are in cents.
- Always send X-Client-Idempotent-Key on create calls; reuse it on retries.
- Respect rate limits: back off on error codes 4, 17, 613, 80000-80014.
- Run `pytest -q` and `python -m scripts.dry_run` before proposing changes.
- Ad copy must follow Meta Advertising Standards; flag health, finance,
employment, housing, politics and gambling for human review.第 2 步:上傳圖片取得 hash
| /adimages 重點 | 說明 |
|---|---|
| 檔名 | 必須含副檔名,例如 sample.jpg |
| 回傳 | images 物件,內含每張圖的 hash |
| 跨帳戶複製 | copy_from:source_account_id + hash |
| 複製權限 | 應用使用者需能讀取來源帳戶的創意 |
| 刪除限制 | 已被廣告創意使用的圖片無法刪除 |

來源:Ad Image 參考。請 Codex 依此寫上傳腳本,並以模擬回應寫單元測試:
# .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># 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}"))# upload_images.py - upload approved images, keep name -> hash mapping
import os, glob, json, requests
from meta_api import API, TOKEN, ACT
hashes = {}
for path in sorted(glob.glob("approved/*.jpg")): # only human-approved files
with open(path, "rb") as f:
r = requests.post(f"{API}/{ACT}/adimages", timeout=120,
files={"filename": (os.path.basename(path), f)},
data={"access_token": TOKEN}).json()
if "error" in r:
raise RuntimeError(r["error"])
for name, info in r["images"].items():
hashes[name] = info["hash"]
json.dump(hashes, open("image_hashes.json", "w"), indent=1)
print(len(hashes), "images uploaded")跨帳戶使用同一批素材時,可用 copy_from 指定來源帳戶與 hash,而不是重新上傳;前提是你的應用使用者有權讀取來源帳戶的廣告創意(來源帳戶 ID 不帶 act_ 前綴)。
第 3 步:組合文案與圖片建立創意
創意以 object_story_spec 描述,包含粉絲專頁、連結、文案、圖片 hash 與 CTA(建立廣告創意)。建立請求帶冪等鍵,逾時重試不會產生重複創意(冪等請求):
# make_creatives.py (excerpt) - copy.csv x image_hashes.json -> creatives
import csv, json, os
from meta_api import call, key, ACT
RUN = "2026-11-16-tw-batch"
hashes = json.load(open("image_hashes.json"))
for row in csv.DictReader(open("copy_approved.csv", encoding="utf-8")):
spec = {"page_id": os.environ["META_PAGE_ID"],
"link_data": {"message": row["primary_text"], "name": row["headline"],
"link": row["link"], "image_hash": hashes[row["image_file"]],
"call_to_action": {"type": row["cta"]}}}
c = call("POST", f"{ACT}/adcreatives",
data={"name": f"TW | {row['variant_id']}", "object_story_spec": json.dumps(spec)},
idem_key=key(RUN, "creative-" + row["variant_id"]))
print(row["variant_id"], c["id"])v27.0 起,若創意未設定產品展示,Meta 可能在高信心配對時自動加入 Product showcase;不需要時可在 degrees_of_freedom_spec 選擇退出(v27.0 changelog)。
第 4 步:在沙盒裡讓 Codex 改程式
交給 Codex 改程式時用 workspace-write 沙盒;只有你自己執行上傳指令時才會連到 Meta。Codex 的沙盒與核准設定見 Codex 權限、沙盒與合規。
# pip install openai-codex (Python 3.10+)
from openai_codex import Codex, Sandbox
with Codex() as codex:
thread = codex.thread_start(sandbox=Sandbox.workspace_write) # no full access
result = thread.run(
"Read AGENTS.md. Add a --dry-run flag to create_paused.py that prints "
"the payloads instead of calling the API, plus tests. Do not call the live API.")
print(result.final_response)第 5 步:監控素材疲勞
訂閱 creative_fatigue Webhook 後,廣告的素材疲勞等級改變時 Meta 會推送 LOW/MEDIUM/HIGH(creative_fatigue)。收到 HIGH 時,把該廣告的近期頻次、CTR、成本整理成清單,交由投手決定是否替換素材,再走一次審核 → 上傳 → 建立創意的流程。
限流與批次大小
同一廣告帳戶寫入請求每秒不超過 100 次;遇到 613 或 80000 系列錯誤時退避(Rate limiting)。素材多時建議分批,每批記錄結果,方便從中斷處續傳。
熊貓出海如何用 Claude、Codex 與 Facebook 廣告帳戶提升客戶投放效率
本文主角是 Codex,但在實際服務中,熊貓出海會把 Claude、Codex 與 Facebook 企業廣告帳戶組合使用,協助出海企業更快完成「開戶 → 建立結構 → 上素材 → 看數據 → 調預算」這套重複工作,讓投放團隊把時間留給策略與素材判斷。
- 廣告帳戶:使用企業自己的 Facebook 廣告帳戶,或透過熊貓出海開戶服務合規開通的企業戶;帳戶歸企業所有,不出租、不共享。
- Claude:適合閱讀長文件與報表、撰寫投放規劃與文案初稿、透過 Meta 廣告 MCP 以暫停狀態起草廣告結構、依規則排查異常。
- Codex:適合撰寫與維護自動化腳本(Marketing API、Insights 報表、批次上傳、預算規則),在沙盒中執行並接入排程或 CI。
- 人工把關:所有會花錢的動作(啟用廣告、提高預算)都由投手審核後執行;Meta 廣告政策與素材合規由人工最終確認。
這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 Facebook 廣告代操與海外開戶(熊貓出海服務頁)。
常見問題
Codex 會幫我做圖嗎?
本文流程中 Codex 負責寫上傳與組合的程式;圖片由設計團隊或你選定的工具產出,經人工審核。
上傳失敗怎麼續傳?
以 image_hashes.json 記錄已完成的檔案,重跑時跳過即可。
影片素材也能這樣做嗎?
影片走不同的上傳端點與流程,本文只涵蓋圖片。
同一張圖可以用在多個廣告帳戶嗎?
可以用 copy_from 從來源帳戶複製,需具備讀取來源帳戶創意的權限。
批次建立的廣告會自動上線嗎?
不會,我們的流程中廣告一律以暫停狀態建立,由人工啟用。
合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的廣告帳戶、粉絲專頁與像素,透過 Meta 官方 Marketing API、Ads MCP 伺服器或 Ads CLI 接入,使用企業管理平台中的系統使用者與最小權限,遵守 Meta 速率限制與《廣告刊登準則》,並在任何會產生花費的動作前保留人工審核。熊貓出海不販售、出租、共享或轉讓廣告帳戶、企業管理平台或 API 金鑰,不協助規避廣告審查、地區限制、KYC、企業驗證或付款管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。
延伸閱讀
- Facebook 廣告代操與海外開戶(熊貓出海服務頁)
- 海外 AI Token 服務:帳號開通 + API 接入(熊貓出海)
- Codex 自動化 Facebook 廣告的權限、沙盒與合規
- Claude 自動建立 Facebook 廣告活動、廣告組合與廣告
- 如何將 Claude 連結到 Facebook 廣告
- Meta 開發了 MCP,讓 AI 直接操作你的廣告投放
- Facebook 企業戶建置清單
- Facebook 海外企業戶開戶文件與審核流程
聯絡熊貓出海:Facebook 開戶 + AI 自動化投放
請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(建立結構、素材、報表或預算規則)。我們先做資格與素材預審,再協助開通合規的 Facebook 企業廣告帳戶,並用 Claude、Codex 建立在您自有帳戶上執行的自動化流程。我們不販售、出租或共享任何廣告帳戶。
WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

官方來源
- Meta: Ad image reference
- Meta: Create an ad creative
- Meta: Idempotent requests
- Meta: Marketing API v27.0 changelog
- Meta: creative_fatigue ads webhook
- Meta: Marketing API rate limiting
- OpenAI: Custom instructions with AGENTS.md
- OpenAI: Codex SDK
以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

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