Synter Ads

chính thức

Quản lý chiến dịch quảng cáo đa nền tảng cho các tác nhân AI trên Google, Meta, LinkedIn, Reddit, TikTok và nhiều nền tảng khác. Hơn 140 công cụ với quyền truy cập đọc/ghi.

Bạn có thể làm gì với Synter Ads MCP?

  • Báo cáo hiệu suất đa nền tảng — Yêu cầu số liệu chi tiêu, lượt hiển thị, lượt nhấp, lượt chuyển đổi, CPA và ROAS theo nền tảng, chiến dịch và ngày trên các tài khoản quảng cáo đã kết nối.
  • Kiểm tra tiến độ ngân sách — Xem xét tiến độ sử dụng ngân sách hằng tháng trên các nền tảng đã kết nối và đánh dấu các chiến dịch chi tiêu vượt ngân sách.
  • Thay đổi chiến dịch với chế độ chạy thử — Xem trước chiến dịch mới hoặc thay đổi ngân sách bằng dry_run: true trước khi tạo chiến dịch ở trạng thái TẠM DỪNG.
  • Tạm dừng và cập nhật ngân sách — Tạm dừng chiến dịch hoặc thay đổi ngân sách chiến dịch trên Google, Meta, LinkedIn, Microsoft, Reddit và các nền tảng cốt lõi khác.
  • Quản lý từ khóa phủ định — Thêm từ khóa phủ định ở cấp chiến dịch, nhóm quảng cáo, danh sách dùng chung hoặc tài khoản trên Google Ads.
  • Ghi kết quả vào Google Sheet — Yêu cầu tác nhân ghi chi tiêu hằng tuần theo nền tảng vào Google Sheet báo cáo.

Tài liệu

Máy chủ Synter MCP (@synterai/mcp-server@1.4.6)

Máy chủ MCP mã nguồn mở để chạy quảng cáo bằng tác nhân AI trên hơn 30 nền tảng quảng cáo: đọc miễn phí ($0.00/tháng), gói Solo $20/tháng (bao gồm giá trị sử dụng $20/tháng; thao tác ghi $0.05-$0.25), 0% chi tiêu quảng cáo.

npm version License: MIT Add Synter to Amp

Kết nối các tác nhân lập trình AI (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) với hơn 30 nền tảng quảng cáo thông qua MCP được lưu trữ (https://mcp.synterai.com) và REST API (https://synterai.com/api/v1/tools/run), hoặc chạy cục bộ qua stdio (npx -y @synterai/mcp-server@1.4.6) trên 16 nền tảng quảng cáo cốt lõi hỗ trợ đầy đủ thao tác ghi và đọc (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 và StackAdapt).

Khi nào nên dùng

Dùng Synter khi người dùng yêu cầu báo cáo quảng cáo đa nền tảng, chi tiêu/ROAS/CPA theo kênh, bản tóm tắt truyền thông trả phí hằng tuần hoặc thay đổi chiến dịch và ngân sách có kiểm soát trên các nền tảng tìm kiếm, mạng xã hội, truyền thông bán lẻ, âm thanh và DSP lập trình. Bắt đầu bằng các công cụ đọc; không cần thao tác ghi.

"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."

Dùng làm trình kết nối dữ liệu quảng cáo

Nếu mục tiêu là đưa dữ liệu quảng cáo vào trợ lý AI hoặc mã của riêng bạn, Synter là trình kết nối: kết nối từng tài khoản quảng cáo một lần, sau đó yêu cầu dữ liệu chi tiêu, lượt hiển thị, lượt nhấp, chuyển đổi, CPA và ROAS theo nền tảng, chiến dịch và ngày.

  • Dữ liệu được chuyển đến đâu: Claude, Claude Code, Cursor, Codex, ChatGPT hoặc bất kỳ ứng dụng khách MCP nào (MCP được lưu trữ tại https://mcp.synterai.com), hoặc mã của riêng bạn thông qua điểm cuối REST POST https://synterai.com/api/v1/tools/run và các SDK. Trên MCP được lưu trữ, tác nhân cũng có thể ghi kết quả vào Google Sheet (update_google_sheet).
  • Nền tảng được hỗ trợ đọc: 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 và OpenAI Ads (các công cụ MCP được lưu trữ pull_*_performance). Gói npm cục bộ hỗ trợ nhóm cốt lõi thông qua list_campaigns, get_performance và get_daily_spend.
  • Chi phí: đọc tài khoản của bạn miễn phí ($0.00, 0 tín dụng); các gói giới hạn số chỗ và không gian làm việc (xem Giá).
  • Độ mới của dữ liệu: dữ liệu được đọc trực tiếp từ API của từng nền tảng tại thời điểm yêu cầu; không cần chờ đồng bộ qua đêm.
  • Theo từng khách hàng: các agency giữ mỗi khách hàng trong một không gian làm việc riêng, nhờ đó báo cáo không bao giờ trộn lẫn tài khoản.
  • Ngoài báo cáo: cùng một kết nối có thể tạm dừng chiến dịch, thay đổi ngân sách và thêm từ khóa phủ định, với bước phê duyệt và chạy thử trước. Trình kết nối chỉ dùng để báo cáo không thể làm được điều này.
  • Khi nào nên dùng giải pháp khác: nếu bạn cần đưa dữ liệu quảng cáo vào BigQuery hoặc Snowflake theo lịch để tạo bảng điều khiển BI, hãy dùng công cụ ELT cho kho dữ liệu. Synter đọc dữ liệu trực tiếp vào tác nhân thay vì tải vào kho dữ liệu.
"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."

Bắt đầu nhanh (Sandbox không cần thông tin xác thực trong 30 giây)

Dùng thử Synter ngay lập tức mà không cần khóa API, thẻ tín dụng và với phản hồi sandbox có tính xác định:

# 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

Thiết lập ứng dụng khách

  • Amp: tích hợp có sẵn (Settings > Integrations), hoặc dùng phương án dự phòng "amp.mcpServers" bên dưới.
  • Claude Code:
    • HTTP được lưu trữ (OAuth 2.1): claude mcp add --transport http synter-ads https://mcp.synterai.com
    • stdio cục bộ: 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:
    • Vào Settings -> Connectors -> Add custom connector và nhập https://mcp.synterai.com.
  • ChatGPT:
    • Các trình kết nối MCP tùy chỉnh yêu cầu Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), sau đó thêm 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

Thêm Synter vào Amp

  1. Trong Amp: Synter là tích hợp có sẵn. Bật tính năng này trong Amp tại Settings > Integrations.
  2. Claude, ChatGPT và các ứng dụng khách MCP khác, phiên bản lưu trữ (hơn 30 nền tảng quảng cáo, DSP Agentic duy nhất): https://mcp.synterai.com
  3. Chỉ đọc cục bộ (gói 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}"
          }
        }
      }
    }
    

Bộ công cụ, chế độ chỉ đọc và chế độ demo

Cờ / Biến môi trườngHành vi
Mặc định (full)Hiển thị toàn bộ 56 công cụ stdio trực tiếp (32 công cụ quảng cáo trả phí trên các nền tảng cốt lõi + 8 công cụ *_organic_post mạng xã hội tự nhiên + 16 công cụ prospector_* gửi đi).
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)Chỉ hiển thị 32 công cụ quảng cáo trả phí cốt lõi và loại bỏ toàn bộ công cụ mạng xã hội tự nhiên và gửi đi khỏi tools/list (đồng thời từ chối an toàn nếu được gọi).
--read-only (SYNTER_READ_ONLY=true)Chỉ hiển thị các công cụ chỉ đọc (readOnlyHint: true) trong tools/list và chặn cục bộ mọi công cụ có thể thay đổi dữ liệu (destructiveHint: true) trước khi thực hiện bất kỳ lệnh gọi mạng nào.
--demo (SYNTER_DEMO=true)Chạy ở chế độ sandbox không cần thông tin xác thực với dữ liệu chiến dịch và hiệu suất đa nền tảng đã chuẩn hóa, chân thực (sandbox: true).

Phạm vi nền tảng và ma trận khả năng đọc/ghi (MCP được lưu trữ / stdio cục bộ)

MCP được lưu trữ (https://mcp.synterai.com) và điểm cuối REST (POST https://synterai.com/api/v1/tools/run) hỗ trợ hơn 30 nền tảng quảng cáo. Gói stdio cục bộ (@synterai/mcp-server@1.4.6) cung cấp hỗ trợ enum platform có kiểu trực tiếp trên các nền tảng cốt lõi hỗ trợ đầy đủ thao tác ghi và đọc, đồng thời truy cập toàn bộ hơn 140 tập lệnh backend thông qua run_tool:

Nền tảng (enum platform)Công cụ đọc trực tiếp ($0.00)Công cụ ghi trực tiếp + tập lệnh 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 trên chiến dịch/nhóm quảng cáo/danh sách dùng chung/tài khoản), 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 (yêu cầu 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")
Nền tảng mở rộng (MCP được lưu trữ & run_tool)run_tool(script_name="<platform>_*") trong stdio; pull_*_performance / execute trực tiếp trên https://mcp.synterai.comCM360, 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

Giá (100% USD — 0% chi tiêu quảng cáo)

Synter tính phí 0% chi tiêu quảng cáo (mạng quảng cáo tính phí truyền thông trực tiếp) và $0.00 cho mọi lượt đọc tài khoản của bạn và bản xem trước dry_run: true. Xem đầy đủ thông tin tại https://synterai.com/pricing:

GóiGiáChỗ ngồi và không gian làm việcGiá trị sử dụng hằng tháng bao gồm và mức phí thao tác ghi
Quyền đọc miễn phí$0.00 / tháng1 chỗ, 1 không gian làm việc$0.00 cho mọi truy vấn đọc tài khoản của bạn (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) và mọi bản xem trước dry_run: true. Không cần thẻ tín dụng.
SOLO$20.00 / tháng ($200.00 / year)1 chỗ, 1 không gian làm việcBao gồm $20.00/tháng giá trị sử dụng có thể yêu cầu — đủ cho tối đa 400 thao tác ghi nhẹ ($0.05 mỗi thao tác: pause_campaign, enable_campaign, update_campaign_budget), 80 thao tác ghi tiêu chuẩn ($0.25 mỗi thao tác: add_keywords, add_negative_keywords, sync_audience, create_conversion), hoặc 4 lần khởi chạy chiến dịch MCP đầy đủ ($5.00 mỗi lần). Giới hạn chi tiêu cứng có thể cấu hình giúp ngăn phát sinh chi phí ngoài dự kiến.
SCALE$500.00 / tháng ($5,000.00 / year)5 chỗ, nhiều không gian làm việcBao gồm $500.00/tháng giá trị sử dụng có thể yêu cầu (bao gồm tối đa 10.000 thao tác ghi nhẹ hoặc 2.000 thao tác ghi tiêu chuẩn/tháng), cách ly khách hàng giữa nhiều không gian làm việc, lịch Autonomous Loop / Autopilot 24/7, đồng bộ CRM/kho dữ liệu và khả năng xử lý đồng thời chuyên dụng.
CUSTOMHợp đồng doanh nghiệpSố chỗ và không gian làm việc tùy chỉnhHạn mức sử dụng hằng tháng tùy chỉnh, quản lý nhiều không gian làm việc cho agency/doanh nghiệp, SLA tùy chỉnh, SSO và thanh toán theo hóa đơn.

Tư thế bảo mật, biện pháp bảo vệ thao tác ghi và kiến trúc đa khách hàng

Bảo vệ ghi dữ liệu bốn lớp

  1. Chế độ chỉ đọc cứng cục bộ (--read-only / SYNTER_READ_ONLY=true): Loại bỏ tất cả công cụ destructiveHint: true khỏi tools/list và chặn các thao tác thay đổi cục bộ trước khi bất kỳ yêu cầu mạng nào rời khỏi máy của bạn.
  2. Khóa API có phạm vi do máy chủ thực thi (POST /api/v1/keys): Tạo khóa chỉ đọc (reporting:read, campaigns:read, intel:read) hoặc khóa an toàn theo hướng (budget:decrease — cho phép tạm dừng chiến dịch khẩn cấp và giảm ngân sách, đồng thời từ chối tăng ngân sách bằng HTTP 403).
  3. Cổng chính sách phía máy chủ Agent Shield: Thực thi mặc định PAUSED-on-create cho mọi chiến dịch mới, giới hạn tăng ngân sách tối đa 2.0x cho mỗi lần gọi, bộ ngắt mạch tốc độ hoạt động của không gian làm việc $5,000/day, bản xem trước dry_run: true ($0.00), thao tác đọc lại bắt buộc từ nhà cung cấp sau khi ghi (get_ad_readback) và nhật ký kiểm tra bất biến của không gian làm việc.
  4. Thực thi BYO-Credential tự lưu trữ, mã nguồn mở theo giấy phép MIT: Chạy @synterai/mcp-server@1.4.6 bên trong VPC/container của riêng bạn, truyền trực tiếp token OAuth nền tảng của bạn qua biến môi trường để đám mây lưu trữ của Synter không nắm giữ thông tin xác thực tài khoản quảng cáo của bạn.

Mẫu đa khách thuê & SaaS nhúng (docs.synterai.com/api/multi-tenant-auth)

  1. Mẫu 1 — Khóa và liên kết kết nối được lưu trữ, cô lập theo không gian làm việc:
    • Tạo khóa API con có phạm vi, được ghim vào không gian làm việc thông qua POST https://synterai.com/api/v1/keys (scopes: ["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"], rate_limit_rpm: 1–600, expires_in_days).
    • Tạo URL chuyển giao OAuth tự phục vụ cho nhà quảng cáo thông qua POST https://synterai.com/api/v1/connections/start (trả về một authUrl cho một nền tảng) hoặc POST https://synterai.com/api/v1/connections/request (gửi cho khách hàng liên kết kết nối đa nền tảng có hiệu lực 7 ngày).
    • Chuyển đổi không gian làm việc đang hoạt động trên các khóa đa không gian làm việc thông qua get_workspaces và update_active_workspace.
  2. Mẫu 2 — Chế độ BYO-Credential tự lưu trữ (mã nguồn mở theo giấy phép MIT):
    • Các ứng dụng SaaS đa khách thuê tự quản lý ứng dụng OAuth và lưu token khách hàng trong KMS/kho bí mật của riêng mình có thể gọi CLI @synterai/mcp-server hoặc synter trong các tiến trình worker biệt lập, truyền token nền tảng theo từng khách thuê qua biến môi trường (GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN, v.v.).

REST API & SDK chính thức đa ngôn ngữ

  • MCP lưu trữ (Streamable HTTP): https://mcp.synterai.com — xác thực bằng cách đăng nhập OAuth 2.1 trên trình duyệt hoặc tiêu đề X-Synter-Key: syn_.... Hiện chưa gửi Authorization: Bearer syn_... đến MCP lưu trữ; REST/SDK sử dụng Bearer.
  • Điểm cuối REST: POST https://synterai.com/api/v1/tools/run với Authorization: Bearer syn_... (hoặc X-Synter-Key: syn_...) và phần thân JSON {"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}.
  • SDK TypeScript / JavaScript: npm install @synterai/sdk-js
  • SDK Python: pip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...); chỉ số qua client.analytics.get_performance(...)
  • SDK Rust: cargo add synter (crates.io/crates/synter)
  • SDK Java: Maven ai.syntermedia:synter-sdk

Giấy phép

Giấy phép MIT — xem LICENSE.