Synter Ads
官方跨平台广告活动管理,支持AI代理在Google、Meta、LinkedIn、Reddit、TikTok等平台操作,提供140余个读写工具。
你可以用 Synter Ads MCP 做什么?
- 跨平台效果报告 — 按平台、广告系列和日期,查询已连接广告账户的花费、展示次数、点击次数、转化次数、CPA 和 ROAS。
- 预算进度检查 — 查看已连接平台的月度预算进度,并标记超支的广告系列。
- 先试运行再更改广告系列 — 创建广告系列或更改预算前,使用
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%。
通过托管 MCP (https://mcp.synterai.com) 和 REST API (https://synterai.com/api/v1/tools/run),或通过 stdio (npx -y @synterai/mcp-server@1.4.6) 在本地运行,将 AI 编程代理(Claude Code、OpenAI Codex、Cursor、Windsurf、Amp、Gemini CLI)连接到 30 多个广告平台,覆盖 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 秒启动零凭据沙盒)
无需 API 密钥、无需信用卡,即可立即试用 Synter,并获得确定性的沙盒响应:
# 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
- 托管 HTTP(OAuth 2.1):
- 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。
- 前往 Settings -> Connectors -> Add custom connector,然后输入
- ChatGPT:
- 自定义 MCP 连接器需要启用 Developer mode(Settings -> Apps & Connectors -> Advanced -> Developer mode),然后添加
https://mcp.synterai.com。
- 自定义 MCP 连接器需要启用 Developer mode(Settings -> Apps & Connectors -> Advanced -> Developer mode),然后添加
- 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
- 在 Amp 中:Synter 是内置集成。在 Amp 的 Settings > Integrations 中启用。
- Claude、ChatGPT 和其他 MCP 客户端,托管版(30 多个广告平台,唯一的 Agentic DSP):https://mcp.synterai.com
- 本地只读(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_budget | create_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_budget | create_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_budget | pause_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_budget | create_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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_budget | pause_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 / execute | CM360、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 和发票结算。 |
安全态势、写入保护措施与多租户架构
四层写入防护
- 本地硬性只读模式(
--read-only/SYNTER_READ_ONLY=true):从tools/list中移除所有destructiveHint: true工具,并在任何网络请求离开你的机器之前于本地阻止变更操作。 - 服务器强制执行的范围限定 API 密钥(
POST /api/v1/keys):创建只读密钥(reporting:read、campaigns:read、intel:read)或定向安全密钥(budget:decrease— 允许紧急暂停广告系列和降低预算,同时拒绝提高预算的请求,并返回 HTTP403)。 - Agent Shield 服务器端策略关卡:强制为每个新广告系列默认启用
PAUSED,设置单次预算增幅上限2.0x、$5,000/day工作区速率熔断器、dry_run: true($0.00)预览、强制写入后从平台读取数据进行核验(get_ad_readback),以及不可变的工作区审计日志。 - 自托管 MIT 开源 BYO-Credential 执行:在你自己的 VPC/容器中运行
@synterai/mcp-server@1.4.6,通过环境变量直接传入你自己的平台 OAuth 令牌,使 Synter 托管云完全不持有你的广告账户凭据。
多租户与嵌入式 SaaS 模式(docs.synterai.com/api/multi-tenant-auth)
- 模式 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 — 自托管 BYO-Credential 模式(MIT 开源):
- 管理自己的 OAuth 应用并将客户令牌存储在自有 KMS/保险库中的多租户 SaaS 应用,可以在隔离的工作进程中调用
@synterai/mcp-server或synterCLI,并通过环境变量传入每个租户的平台令牌(GOOGLE_ADS_REFRESH_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_DEVELOPER_TOKEN、META_ACCESS_TOKEN、LINKEDIN_ACCESS_TOKEN等)。
- 管理自己的 OAuth 应用并将客户令牌存储在自有 KMS/保险库中的多租户 SaaS 应用,可以在隔离的工作进程中调用
REST API 与官方多语言 SDK
- 托管 MCP(Streamable HTTP):
https://mcp.synterai.com— 通过 OAuth 2.1 浏览器登录或X-Synter-Key: syn_...标头进行身份验证。暂时不要向托管 MCP 发送Authorization: Bearer syn_...;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。