Synter Ads

官方

跨平台廣告活動管理,支援AI代理在Google、Meta、LinkedIn、Reddit、TikTok等平台操作,提供140多個具讀寫權限的工具。

你可以用 Synter Ads MCP 做什麼?

  • 跨平台成效報告 — 查詢已連結廣告帳戶中各平台、廣告活動及每日的支出、曝光次數、點擊次數、轉換次數、CPA 和 ROAS。
  • 預算進度檢查 — 檢視已連結平台的每月預算進度,並標示超支的廣告活動。
  • 先試執行再變更廣告活動 — 建立廣告活動並將其設為 PAUSED 前,先使用 dry_run: true 預覽新的廣告活動或預算變更。
  • 暫停廣告活動及更新預算 — 在 Google、Meta、LinkedIn、Microsoft、Reddit 及其他主要平台上暫停廣告活動或變更其預算。
  • 管理否定關鍵字 — 在 Google Ads 的廣告活動、廣告群組、共用清單或帳戶層級新增否定關鍵字。
  • 將結果寫入 Google 試算表 — 讓代理程式將每週各平台的支出寫入報表用的 Google 試算表。

文件

Synter MCP Server (@synterai/mcp-server@1.4.6)

開源 MCP 伺服器,讓 AI 代理透過 30+ 個廣告平台投放廣告:免費讀取($0.00/月)、$20/月 Solo(包含價值 $20/月的用量;寫入費用 $0.05-$0.25),廣告支出抽成 0%。

npm version License: MIT Add Synter to Amp

透過託管 MCP (https://mcp.synterai.com) 和 REST API (https://synterai.com/api/v1/tools/run),將 AI 程式設計代理(Claude Code、OpenAI Codex、Cursor、Windsurf、Amp、Gemini CLI)連接至 30+ 個廣告平台;也可透過 stdio (npx -y @synterai/mcp-server@1.4.6) 在本機執行,支援 16 個核心完整寫入與讀取廣告平台(Google Ads、Meta、LinkedIn、Microsoft/Bing、Reddit、TikTok、X、Pinterest、Snapchat、Spotify、Amazon Ads、Amazon DSP、The Trade Desk、OpenAI Ads、Google DV360 和 StackAdapt)。

適用情境

當使用者需要跨平台廣告報告、依管道查看支出/ROAS/CPA、每週付費媒體摘要,或跨搜尋、社群、零售媒體、音訊和程式化 DSP 進行受控的廣告活動與預算變更時,請使用 Synter。先使用讀取工具;無需寫入。

"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."

將其作為廣告資料連接器使用

如果目標是將廣告資料匯入 AI 助理或自己的程式碼,Synter 就是資料連接器:每個廣告帳戶只需連接一次,之後即可依平台、廣告活動和日期查詢支出、曝光次數、點擊次數、轉換次數、CPA 和 ROAS。

  • 資料傳送位置:Claude、Claude Code、Cursor、Codex、ChatGPT 或任何 MCP 用戶端(託管 MCP 位於 https://mcp.synterai.com),或透過 REST 端點 POST https://synterai.com/api/v1/tools/run 和 SDK 將資料傳送至自己的程式碼。在託管 MCP 上,代理也可以將結果寫入 Google Sheet (update_google_sheet)。
  • 可讀取的平台:Google Ads、Meta(Facebook 和 Instagram)、LinkedIn、Microsoft Ads、Reddit、TikTok、X、Pinterest、Snapchat、Spotify、Amazon Ads、Amazon DSP、The Trade Desk、DV360、CM360、Criteo、Walmart Connect、Instacart、Target Roundel、FreeWheel 和 OpenAI Ads(託管 MCP pull_*_performance 工具)。本機 npm 套件透過 list_campaigns、get_performance 和 get_daily_spend 支援核心平台。
  • 費用:讀取自己的帳戶免費($0.00,0 點數);方案會限制席位和工作區(請參閱「定價」)。
  • 資料新鮮度:讀取請求會在提出時即時呼叫各平台的 API;無需等待夜間同步。
  • 依客戶區隔:代理商將每位客戶放在各自的工作區,因此報告不會混合不同帳戶。
  • 報告以外的功能:同一連線也能暫停廣告活動、變更預算和新增否定關鍵字,並在執行前要求核准及進行試執行。僅供報告使用的連接器無法做到這些。
  • 何時改用其他工具:如果需要依排程將廣告資料載入 BigQuery 或 Snowflake,以供 BI 儀表板使用,請改用資料倉儲 ELT 工具。Synter 會將即時資料讀取至代理,而非載入資料倉儲。
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."

快速入門(30 秒啟用零憑證沙箱)

立即試用 Synter,無需 API 金鑰、信用卡,並可取得確定性的沙箱回應:

# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs

# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com

# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only

用戶端設定

  • **Amp:**內建(Settings > Integrations),或使用下方的 "amp.mcpServers" 備援方式。
  • Claude Code:
    • 託管 HTTP(OAuth 2.1):claude mcp add --transport http synter-ads https://mcp.synterai.com
    • 本機 stdio:claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
  • OpenAI Codex:
    • codex mcp add synter-ads --url https://mcp.synterai.com
  • Claude.ai / Claude Desktop:
    • 前往 Settings -> Connectors -> Add custom connector,並輸入 https://mcp.synterai.com。
  • ChatGPT:
    • 自訂 MCP 連接器需要啟用 Developer mode(Settings -> Apps & Connectors -> Advanced -> Developer mode),然後新增 https://mcp.synterai.com。
  • Cursor / Windsurf (mcp.json):
    {
      "mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    
  • Gemini CLI:
    • gemini extensions install https://github.com/Synter-Media-AI/mcp-server

將 Synter 加入 Amp

  1. 在 Amp 中:Synter 是內建整合。請在 Amp 的 Settings > Integrations 中啟用。
  2. Claude、ChatGPT 和其他 MCP 用戶端,託管版(30+ 個廣告平台,唯一的 Agentic DSP):https://mcp.synterai.com
  3. 本機唯讀(npm 套件):
    {
      "amp.mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    

工具集、唯讀模式與示範模式

旗標 / 環境變數行為
預設 (full)提供全部 56 個直接 stdio 工具(核心平台的 32 個付費廣告工具 + 8 個自然社群 *_organic_post 工具 + 16 個外傳 prospector_* 工具)。
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)僅提供 32 個核心付費廣告工具,並從 tools/list 移除所有自然社群和外傳工具(若呼叫則會安全失敗)。
--read-only (SYNTER_READ_ONLY=true)在 tools/list 中僅提供唯讀工具(readOnlyHint: true),並在本機於任何網路呼叫前封鎖所有變更工具(destructiveHint: true)。
--demo (SYNTER_DEMO=true)在零憑證沙箱模式下執行,提供逼真且標準化的多平台廣告活動與成效資料(sandbox: true)。

平台涵蓋範圍與讀取/寫入能力矩陣(託管版 / 本機 Stdio)

託管 MCP (https://mcp.synterai.com) 和 REST 端點 (POST https://synterai.com/api/v1/tools/run) 涵蓋 30+ 個廣告平台。本機 stdio 套件 (@synterai/mcp-server@1.4.6) 透過 run_tool,為核心完整寫入與讀取平台提供直接的型別化 platform 列舉支援,並可使用所有 140+ 個後端指令碼:

平台(platform 列舉)直接讀取工具($0.00)直接寫入工具 + run_tool 指令碼(SOLO / SCALE / CUSTOM)
Google Ads (google)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback")create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT,涵蓋廣告活動/廣告群組/共用清單/帳戶), create_conversion, manage_audience, sync_audience, upload_image
Meta Ads (meta)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad")
LinkedIn Ads (linkedin)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_linkedin_campaign(需要 group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group")
Microsoft / Bing Ads (microsoft)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords")
Reddit Ads (reddit)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad")
TikTok Ads (tiktok)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup")
X Ads (x)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item")
Pinterest Ads (pinterest)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group")
Snapchat Ads (snapchat)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad")
Spotify Ads (spotify)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set")
Amazon Ads (amazon_ads)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords")
Amazon DSP (amazon_dsp)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item")
The Trade Desk (the_trade_desk)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group")
OpenAI Ads (openai)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign")
Google DV360 (dv360)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item")
StackAdapt (stackadapt)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign")
延伸平台(託管 MCP 與 run_tool)stdio 中的 run_tool(script_name="<platform>_*");https://mcp.synterai.com 上的直接 pull_*_performance / executeCM360、Walmart Connect、Instacart、Target Roundel、Criteo、FreeWheel、SA360、Apple Ads、Demandbase ABM、Taboola、Outbrain、AppLovin、Yahoo DSP、Teads、Viant、Basis、MediaMath、Magnite、PubMatic、Index Exchange、TripleLift、GumGum、Dianomi、Quora Ads、Nextdoor Ads、Twitch Ads、Yelp Ads、Samsung Ads、Roku Ads、impact.com

定價(100% 美元計價 — 廣告支出抽成 0%)

Synter 不抽取廣告支出(媒體費用由廣告網路直接收取),且所有自有帳戶讀取和 dry_run: true 預覽均免費($0.00)。完整資訊請參閱 https://synterai.com/pricing:

方案價格席位與工作區每月包含的用量價值與寫入費率
免費讀取權限$0.00 / 月1 個席位,1 個工作區所有自有帳戶讀取查詢均為 $0.00(list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance),所有 dry_run: true 預覽也免費。無需信用卡。
SOLO$20.00 / 月($200.00 / year)1 個席位,1 個工作區包含每月價值 $20.00 的可申領用量 — 可支付最多 400 次輕量寫入(每次 $0.05:pause_campaign、enable_campaign、update_campaign_budget)、80 次標準寫入(每次 $0.25:add_keywords、add_negative_keywords、sync_audience、create_conversion),或 4 次完整 MCP 廣告活動啟動(每次 $5.00)。可設定硬性支出上限,避免意外超支。
SCALE$500.00 / 月($5,000.00 / year)5 個席位,多工作區包含每月價值 $500.00 的可申領用量(每月最多包含 10,000 次輕量寫入或 2,000 次標準寫入)、多工作區客戶隔離、全天候 Autonomous Loop / Autopilot 排程、CRM/資料倉儲同步,以及專屬並行處理能力。
CUSTOM企業合約自訂席位與工作區自訂每月用量額度、代理商/企業多工作區管理、自訂 SLA、SSO 和發票付款。

安全態勢、寫入防護措施與多租戶架構

四層寫入防護

  1. 本機硬性唯讀模式(--read-only / SYNTER_READ_ONLY=true):從 tools/list 移除所有 destructiveHint: true 工具,並在任何網路請求離開您的電腦之前,於本機封鎖變更操作。
  2. 伺服器強制執行的範圍限定 API 金鑰(POST /api/v1/keys):建立唯讀金鑰(reporting:read、campaigns:read、intel:read)或具方向性安全限制的金鑰(budget:decrease — 允許緊急暫停行銷活動及降低預算,但會以 HTTP 403 拒絕提高預算)。
  3. Agent Shield 伺服器端政策閘道:強制每個新行銷活動預設為建立時啟用 PAUSED,設定單次呼叫預算增加上限 2.0x、$5,000/day 工作區速度斷路器、dry_run: true($0.00)預覽、寫入後必須向提供者讀回確認(get_ad_readback),以及不可變的工作區稽核記錄。
  4. 自架 MIT 開源 BYO-Credential 執行模式:在您自己的 VPC/容器中執行 @synterai/mcp-server@1.4.6,透過環境變數直接傳入您自己的平台 OAuth 權杖,讓 Synter 託管雲端完全不持有您的廣告帳戶憑證。

多租戶與嵌入式 SaaS 模式(docs.synterai.com/api/multi-tenant-auth)

  1. 模式 1 — 託管式工作區隔離金鑰與連線連結:
    • 透過 POST https://synterai.com/api/v1/keys 建立固定於工作區且具範圍限制的子 API 金鑰(scopes:["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"]、rate_limit_rpm:1–600、expires_in_days)。
    • 透過 POST https://synterai.com/api/v1/connections/start 產生廣告主自助式 OAuth 交接 URL(回傳單一平台的 authUrl),或透過 POST https://synterai.com/api/v1/connections/request(向客戶傳送有效期 7 天的多平台連線連結)。
    • 透過 get_workspaces 和 update_active_workspace,在多工作區金鑰上切換作用中的工作區。
  2. 模式 2 — 自架 BYO-Credential 模式(MIT 開源):
    • 管理自有 OAuth 應用程式,並將客戶權杖儲存在自有 KMS/保存庫中的多租戶 SaaS 應用程式,可在隔離的工作程序中呼叫 @synterai/mcp-server 或 synter CLI,並透過環境變數傳入各租戶的平台權杖(GOOGLE_ADS_REFRESH_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_DEVELOPER_TOKEN、META_ACCESS_TOKEN、LINKEDIN_ACCESS_TOKEN 等)。

REST API 與官方多語言 SDK

  • 託管式 MCP(Streamable HTTP):https://mcp.synterai.com — 透過 OAuth 2.1 瀏覽器登入或 X-Synter-Key: syn_... 標頭進行驗證。請勿將 Authorization: Bearer syn_... 傳送至託管式 MCP;REST/SDK 使用 Bearer。
  • REST 端點:POST https://synterai.com/api/v1/tools/run,搭配 Authorization: Bearer syn_...(或 X-Synter-Key: syn_...)及 JSON 主體 {"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}。
  • TypeScript / JavaScript SDK:npm install @synterai/sdk-js
  • Python SDK:pip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...);指標透過 client.analytics.get_performance(...) 提供
  • Rust SDK:cargo add synter (crates.io/crates/synter)
  • Java SDK:Maven ai.syntermedia:synter-sdk

授權條款

MIT License — 請參閱 LICENSE。