Synter Ads

resmi

Manajemen kampanye iklan lintas platform untuk agen AI di Google, Meta, LinkedIn, Reddit, TikTok, dan lainnya. 140+ alat dengan akses baca/tulis.

Apa yang bisa Anda lakukan dengan Synter Ads MCP?

  • Laporan performa lintas platform — Minta data belanja, impresi, klik, konversi, CPA, dan ROAS berdasarkan platform, kampanye, dan hari di seluruh akun iklan yang terhubung.
  • Pemeriksaan laju penggunaan anggaran — Tinjau laju penggunaan anggaran bulanan di seluruh platform yang terhubung dan tandai kampanye yang melebihi anggaran.
  • Perubahan kampanye dengan uji coba — Pratinjau kampanye baru atau perubahan anggaran dengan dry_run: true sebelum membuatnya dalam status PAUSED.
  • Pembaruan jeda dan anggaran — Jeda kampanye atau ubah anggaran kampanye di Google, Meta, LinkedIn, Microsoft, Reddit, dan platform utama lainnya.
  • Pengelolaan kata kunci negatif — Tambahkan kata kunci negatif di tingkat kampanye, grup iklan, daftar bersama, atau akun di Google Ads.
  • Tulis hasil ke Google Sheet — Minta agen menulis data belanja mingguan per platform ke Google Sheet pelaporan.

Dokumentasi

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

Server MCP sumber terbuka untuk menjalankan iklan dengan agen AI di lebih dari 30 platform iklan: pembacaan gratis ($0.00/bln), Solo $20/bln (termasuk nilai penggunaan $20/bln; penulisan $0.05-$0.25), 0% dari belanja iklan.

npm version License: MIT Add Synter to Amp

Hubungkan agen coding AI (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) ke lebih dari 30 platform periklanan melalui MCP ter-host (https://mcp.synterai.com) dan REST API (https://synterai.com/api/v1/tools/run), atau jalankan secara lokal melalui stdio (npx -y @synterai/mcp-server@1.4.6) di 16 platform iklan inti dengan kemampuan baca dan tulis penuh (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360, dan StackAdapt).

Kapan menggunakannya

Gunakan Synter saat pengguna meminta laporan iklan lintas platform, belanja/ROAS/CPA per kanal, ringkasan media berbayar mingguan, atau perubahan kampanye dan anggaran yang terkelola di berbagai kanal penelusuran, sosial, media ritel, audio, dan DSP terprogram. Mulailah dengan alat baca; tidak perlu melakukan penulisan.

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

Gunakan sebagai konektor data iklan

Jika tujuannya adalah memasukkan data iklan ke asisten AI atau kode Anda sendiri, Synter adalah konektornya: hubungkan setiap akun iklan sekali, lalu minta belanja, tayangan, klik, konversi, CPA, dan ROAS berdasarkan platform, kampanye, dan hari.

  • Ke mana data dikirim: Claude, Claude Code, Cursor, Codex, ChatGPT, atau klien MCP apa pun (MCP ter-host di https://mcp.synterai.com), atau kode Anda sendiri melalui endpoint REST POST https://synterai.com/api/v1/tools/run dan SDK. Pada MCP ter-host, agen juga dapat menulis hasil ke Google Sheet (update_google_sheet).
  • Platform yang dapat dibaca: 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, dan OpenAI Ads (alat MCP ter-host pull_*_performance). Paket npm lokal mencakup rangkaian inti melalui list_campaigns, get_performance, dan get_daily_spend.
  • Biaya: membaca akun Anda sendiri gratis ($0.00, 0 kredit); paket membatasi jumlah kursi dan ruang kerja (lihat Harga).
  • Kebaruan data: pembacaan langsung dilakukan ke API setiap platform saat diminta; tidak perlu menunggu sinkronisasi malam.
  • Per klien: agensi menyimpan setiap klien di ruang kerjanya sendiri, sehingga laporan tidak pernah mencampur akun.
  • Selain pelaporan: koneksi yang sama dapat menjeda kampanye, mengubah anggaran, dan menambahkan kata kunci negatif, dengan persetujuan dan uji coba terlebih dahulu. Konektor khusus pelaporan tidak dapat melakukannya.
  • Kapan sebaiknya menggunakan alat lain: jika Anda perlu memuat data iklan ke BigQuery atau Snowflake secara terjadwal untuk dasbor BI, gunakan alat ELT gudang data. Synter membaca data langsung ke agen, bukan memuatnya ke gudang data.
"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."

Mulai Cepat (Sandbox Tanpa Kredensial dalam 30 Detik)

Coba Synter sekarang juga tanpa kunci API, tanpa kartu kredit, dan dengan respons sandbox deterministik:

# 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

Penyiapan Klien

  • Amp: sudah terintegrasi (Settings > Integrations), atau gunakan alternatif "amp.mcpServers" di bawah.
  • Claude Code:
    • HTTP ter-host (OAuth 2.1): claude mcp add --transport http synter-ads https://mcp.synterai.com
    • stdio lokal: 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:
    • Buka Settings -> Connectors -> Add custom connector dan masukkan https://mcp.synterai.com.
  • ChatGPT:
    • Konektor MCP kustom memerlukan Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), lalu tambahkan 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

Tambahkan Synter ke Amp

  1. Di Amp: Synter adalah integrasi bawaan. Aktifkan di Amp melalui Settings > Integrations.
  2. Claude, ChatGPT, dan klien MCP lainnya, ter-host (lebih dari 30 platform iklan, satu-satunya DSP Agentic): https://mcp.synterai.com
  3. Lokal hanya-baca (paket 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}"
          }
        }
      }
    }
    

Kumpulan Alat, Mode Hanya-Baca & Mode Demo

Bendera / Variabel LingkunganPerilaku
Default (full)Menyediakan semua 56 alat stdio langsung (32 alat iklan berbayar di seluruh platform inti + 8 alat sosial organik *_organic_post + 16 alat outbound prospector_*).
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)Hanya menyediakan 32 alat periklanan berbayar inti dan menghapus semua alat sosial organik serta outbound dari tools/list (dan menolak panggilan jika digunakan).
--read-only (SYNTER_READ_ONLY=true)Hanya menyediakan alat hanya-baca (readOnlyHint: true) di tools/list dan memblokir semua alat yang mengubah data (destructiveHint: true) secara lokal sebelum panggilan jaringan apa pun.
--demo (SYNTER_DEMO=true)Berjalan dalam mode sandbox tanpa kredensial dengan data kampanye dan performa lintas platform yang realistis dan dinormalisasi (sandbox: true).

Cakupan Platform & Matriks Kemampuan Baca/Tulis (Hosted / Local Stdio)

MCP ter-host (https://mcp.synterai.com) dan endpoint REST (POST https://synterai.com/api/v1/tools/run) mencakup lebih dari 30 platform periklanan. Paket stdio lokal (@synterai/mcp-server@1.4.6) menyediakan dukungan enum platform bertipe langsung di seluruh platform inti dengan kemampuan baca dan tulis penuh, serta menjangkau semua 140+ skrip backend melalui run_tool:

Platform (enum platform)Alat Baca Langsung ($0.00)Alat Tulis Langsung + Skrip 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 di tingkat kampanye/grup iklan/daftar bersama/akun), 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 (memerlukan 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")
Platform Tambahan (MCP Ter-host & run_tool)run_tool(script_name="<platform>_*") di stdio; pull_*_performance / execute langsung di 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

Harga (100% USD — 0% dari Belanja Iklan)

Synter mengenakan 0% dari belanja iklan (jaringan iklan menagih belanja media secara langsung) dan $0.00 untuk semua pembacaan akun sendiri serta pratinjau dry_run: true. Detail lengkap tersedia di https://synterai.com/pricing:

PaketHargaKursi & Ruang KerjaNilai Penggunaan Bulanan Termasuk & Tarif Penulisan
Akses Baca Gratis$0.00 / bulan1 kursi, 1 ruang kerja$0.00 untuk semua kueri baca akun sendiri (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) dan semua pratinjau dry_run: true. Tidak perlu kartu kredit.
SOLO$20.00 / bulan ($200.00 / year)1 kursi, 1 ruang kerjaTermasuk nilai penggunaan yang dapat diklaim sebesar $20.00/bulan — mencakup hingga 400 penulisan ringan ($0.05 masing-masing: pause_campaign, enable_campaign, update_campaign_budget), 80 penulisan standar ($0.25 masing-masing: add_keywords, add_negative_keywords, sync_audience, create_conversion), atau 4 peluncuran kampanye MCP penuh ($5.00 masing-masing). Batas pengeluaran maksimum yang dapat dikonfigurasi mencegah biaya berlebih yang tidak terduga.
SCALE$500.00 / bulan ($5,000.00 / year)5 kursi, beberapa ruang kerjaTermasuk nilai penggunaan yang dapat diklaim sebesar $500.00/bulan (hingga 10.000 penulisan ringan atau 2.000 penulisan standar/bulan termasuk), isolasi klien multi-ruang kerja, jadwal Autonomous Loop / Autopilot 24/7, sinkronisasi CRM/gudang data, dan konkurensi khusus.
CUSTOMKontrak EnterpriseKursi & ruang kerja kustomKuota penggunaan bulanan kustom, pengelolaan multi-ruang kerja untuk agensi/perusahaan, SLA kustom, SSO, dan penagihan melalui faktur.

Postur Keamanan, Perlindungan Penulisan & Arsitektur Multi-Penyewa

Pertahanan Penulisan Empat Lapis

  1. Mode Hanya-Baca Keras Lokal (--read-only / SYNTER_READ_ONLY=true): Menghapus semua alat destructiveHint: true dari tools/list dan memblokir perubahan secara lokal sebelum permintaan jaringan apa pun meninggalkan mesin Anda.
  2. Kunci API Terbatas Cakupan yang Ditegakkan Server (POST /api/v1/keys): Buat kunci hanya-baca (reporting:read, campaigns:read, intel:read) atau kunci keselamatan terarah (budget:decrease — mengizinkan jeda kampanye darurat dan pengurangan anggaran, tetapi menolak kenaikan anggaran dengan HTTP 403).
  3. Gerbang Kebijakan Sisi Server Agent Shield: Menerapkan default PAUSED-on-create untuk setiap kampanye baru, batas maksimum kenaikan anggaran satu panggilan sebesar 2.0x, pemutus sirkuit kecepatan workspace $5,000/day, pratinjau dry_run: true ($0.00), pembacaan ulang wajib dari penyedia setelah penulisan (get_ad_readback), dan log audit workspace yang tidak dapat diubah.
  4. Eksekusi BYO-Credential Sumber Terbuka MIT yang Dihosting Sendiri: Jalankan @synterai/mcp-server@1.4.6 di dalam VPC/kontainer Anda sendiri dengan meneruskan token OAuth platform Anda sendiri secara langsung melalui variabel lingkungan, sehingga cloud Synter yang dihosting tidak menyimpan kredensial akun iklan Anda.

Pola SaaS Multi-Tenant & Tertanam (docs.synterai.com/api/multi-tenant-auth)

  1. Pola 1 — Kunci Terisolasi per Workspace yang Dihosting & Tautan Koneksi:
    • Buat kunci API turunan dengan cakupan dan terikat pada workspace melalui 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).
    • Buat URL serah-terima OAuth pengiklan mandiri melalui POST https://synterai.com/api/v1/connections/start (mengembalikan authUrl untuk satu platform) atau POST https://synterai.com/api/v1/connections/request (mengirim tautan koneksi multi-platform yang berlaku selama 7 hari kepada klien).
    • Beralih workspace aktif pada kunci multi-workspace melalui get_workspaces dan update_active_workspace.
  2. Pola 2 — Mode BYO-Credential yang Dihosting Sendiri (Sumber Terbuka MIT):
    • Aplikasi SaaS multi-tenant yang mengelola aplikasi OAuth sendiri dan menyimpan token pelanggan di KMS/vault sendiri dapat menjalankan CLI @synterai/mcp-server atau synter dalam proses worker terisolasi dengan meneruskan token platform per-tenant melalui variabel lingkungan (GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN, dll.).

REST API & SDK Resmi Multi-Bahasa

  • MCP yang Dihosting (Streamable HTTP): https://mcp.synterai.com — autentikasi melalui login browser OAuth 2.1 atau header X-Synter-Key: syn_.... Jangan kirim Authorization: Bearer syn_... ke MCP yang dihosting untuk saat ini; REST/SDK menggunakan Bearer.
  • Endpoint REST: POST https://synterai.com/api/v1/tools/run dengan Authorization: Bearer syn_... (atau X-Synter-Key: syn_...) dan isi 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=...); metrik melalui client.analytics.get_performance(...)
  • SDK Rust: cargo add synter (crates.io/crates/synter)
  • SDK Java: Maven ai.syntermedia:synter-sdk

Lisensi

Lisensi MIT — lihat LICENSE.