Synter Ads
resmiGoogle, Meta, LinkedIn, Reddit, TikTok ve daha fazlasında AI ajanları için çapraz platform reklam kampanyası yönetimi. Okuma/yazma erişimine sahip 140'tan fazla araç.
Synter Ads MCP ile neler yapabilirsiniz?
- Platformlar arası performans raporları — Bağlı reklam hesaplarında platform, kampanya ve gün bazında harcama, gösterim, tıklama, dönüşüm, CPA ve ROAS verilerini isteyin.
- Bütçe harcama hızı kontrolleri — Bağlı platformlardaki aylık bütçe harcama hızını inceleyin ve bütçeyi aşan kampanyaları işaretleyin.
- Deneme çalıştırmasıyla kampanya değişiklikleri — Yeni bir kampanya veya bütçe değişikliğini PAUSED olarak oluşturmadan önce
dry_run: trueile önizleyin. - Duraklatma ve bütçe güncellemeleri — Google, Meta, LinkedIn, Microsoft, Reddit ve diğer temel platformlardaki kampanyaları duraklatın veya kampanya bütçelerini değiştirin.
- Negatif anahtar kelime yönetimi — Google Ads'de kampanya, reklam grubu, paylaşılan liste veya hesap düzeyinde negatif anahtar kelimeler ekleyin.
- Sonuçları Google E-Tablolar'a yazma — Ajandan haftalık platform bazında harcamaları bir raporlama Google E-Tablolar dosyasına yazmasını isteyin.
Dokümantasyon
Synter MCP Sunucusu (@synterai/mcp-server@1.4.6)
30'dan fazla reklam platformunda AI ajanlarıyla reklam yayınlamak için açık kaynaklı MCP sunucusu: ücretsiz okuma ($0.00/ay), $20/ay Solo (kullanım değeri olarak $20/ay dahil; yazma işlemleri $0.05-$0.25), reklam harcamasından %0.
Barındırılan MCP (https://mcp.synterai.com) ve REST API (https://synterai.com/api/v1/tools/run) üzerinden AI kodlama ajanlarını (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) 30'dan fazla reklam platformuna bağlayın veya stdio (npx -y @synterai/mcp-server@1.4.6) üzerinden yerel olarak 16 temel tam yazma + okuma reklam platformunda çalıştırın (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 ve StackAdapt).
Ne zaman kullanılır?
Kullanıcı platformlar arası reklam raporu, kanala göre harcama/ROAS/CPA, haftalık ücretli medya özeti veya arama, sosyal medya, perakende medya, ses ve programatik DSP'lerde denetimli kampanya ve bütçe değişiklikleri istediğinde Synter'ı kullanın. Okuma araçlarıyla başlayın; yazma işlemi gerekmez.
"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."
Reklam verisi bağlayıcısı olarak kullanın
Amaç reklam verilerini bir AI asistanına veya kendi kodunuza aktarmaksa Synter bağlayıcı görevi görür: her reklam hesabını bir kez bağlayın, ardından platform, kampanya ve güne göre harcama, gösterim, tıklama, dönüşüm, CPA ve ROAS bilgilerini isteyin.
- Veriler nereye gider: Claude, Claude Code, Cursor, Codex, ChatGPT veya herhangi bir MCP istemcisi (barındırılan MCP:
https://mcp.synterai.com) ya da REST uç noktasıPOST https://synterai.com/api/v1/tools/runve SDK'lar aracılığıyla kendi kodunuz. Barındırılan MCP'de ajan, sonuçları bir Google E-Tablosu'na da yazabilir (update_google_sheet). - Okuduğu platformlar: Google Ads, Meta (Facebook ve 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 ve OpenAI Ads (barındırılan MCP
pull_*_performancearaçları). Yerel npm paketi, temel platform kümesinilist_campaigns,get_performanceveget_daily_spendüzerinden kapsar. - Maliyet: Kendi hesaplarınızı okumak ücretsizdir ($0.00, 0 kredi); planlar koltuk ve çalışma alanı sayısını sınırlar (Fiyatlandırma bölümüne bakın).
- Verilerin güncelliği: Okumalar, istek anında doğrudan her platformun API'sine gider; beklemeniz gereken bir gece senkronizasyonu yoktur.
- Müşteri başına: Ajanslar her müşteriyi kendi çalışma alanında tutar; böylece raporlarda hesaplar birbirine karışmaz.
- Raporlamanın ötesinde: Aynı bağlantı, önce onay ve deneme çalıştırmasıyla kampanyaları duraklatabilir, bütçeleri değiştirebilir ve negatif anahtar kelimeler ekleyebilir. Yalnızca raporlama yapan bir bağlayıcı bunu yapamaz.
- Başka bir araç ne zaman kullanılmalı: BI panoları için reklam verilerinin belirli bir programa göre BigQuery veya Snowflake'e aktarılması gerekiyorsa bir veri ambarı ELT aracı kullanın. Synter, veri ambarına yükleme yapmak yerine verileri canlı olarak ajana okur.
"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."
Hızlı Başlangıç (30 Saniyede Kimlik Bilgisi Gerektirmeyen Sandbox)
Synter'ı API anahtarı veya kredi kartı olmadan, deterministik sandbox yanıtlarıyla hemen deneyin:
# 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
İstemci Kurulumu
- Amp: yerleşik (Settings > Integrations) veya aşağıdaki
"amp.mcpServers"yedeğini kullanın. - Claude Code:
- Barındırılan HTTP (OAuth 2.1):
claude mcp add --transport http synter-ads https://mcp.synterai.com - Yerel stdio:
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- Barındırılan 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 bölümüne gidin ve
https://mcp.synterai.comgirin.
- Settings -> Connectors -> Add custom connector bölümüne gidin ve
- ChatGPT:
- Özel MCP bağlayıcıları için Developer mode gerekir (Settings -> Apps & Connectors -> Advanced -> Developer mode); ardından
https://mcp.synterai.comekleyin.
- Özel MCP bağlayıcıları için Developer mode gerekir (Settings -> Apps & Connectors -> Advanced -> Developer mode); ardından
- 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'e ekleyin
- Amp'te Synter yerleşik bir entegrasyondur. Amp'te Settings > Integrations bölümünden etkinleştirin.
- Claude, ChatGPT ve diğer MCP istemcileri için barındırılan sürüm (30'dan fazla reklam platformu, tek Agentic DSP): https://mcp.synterai.com
- Yerel, salt okunur (npm paketi):
{ "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}" } } } }
Araç Kümeleri, Salt Okunur Mod ve Demo Modu
| Bayrak / Ortam Değişkeni | Davranış |
|---|---|
Varsayılan (full) | Tüm 56 doğrudan stdio aracını sunar (temel platformlarda ücretli reklamlar için 32 araç + organik sosyal medya için 8 *_organic_post aracı + giden iletişim için 16 prospector_* aracı). |
--toolset ad-ops (SYNTER_TOOLSET=ad-ops) | Yalnızca temel ücretli reklamcılık için 32 aracı sunar ve tüm organik sosyal medya ve giden iletişim araçlarını tools/list içinden çıkarır (çağrıldıklarında güvenli biçimde kapalı kalır). |
--read-only (SYNTER_READ_ONLY=true) | tools/list içinde yalnızca salt okunur araçları (readOnlyHint: true) sunar ve tüm değişiklik yapan araçları (destructiveHint: true) herhangi bir ağ çağrısından önce yerel olarak engeller. |
--demo (SYNTER_DEMO=true) | Gerçekçi, normalleştirilmiş çok platformlu kampanya ve performans verileriyle (sandbox: true) kimlik bilgisi gerektirmeyen sandbox modunda çalışır. |
Platform Kapsamı ve Okuma/Yazma Yeteneği Matrisi (Barındırılan / Yerel Stdio)
Barındırılan MCP (https://mcp.synterai.com) ve REST uç noktası (POST https://synterai.com/api/v1/tools/run), 30'dan fazla reklam platformunu kapsar. Yerel stdio paketi (@synterai/mcp-server@1.4.6), temel tam yazma + okuma platformlarında doğrudan türlenmiş platform enum desteği sağlar ve run_tool üzerinden 140'tan fazla arka uç betiğinin tümüne erişir:
Platform (platform enum) | Doğrudan Okuma Araçları ($0.00) | Doğrudan Yazma Araçları + run_tool Betikleri (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 kampanya/reklam grubu/paylaşılan liste/hesap genelinde), 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 gerektirir), 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") |
Genişletilmiş Platformlar (Barındırılan MCP ve run_tool) | stdio'da run_tool(script_name="<platform>_*"); https://mcp.synterai.com üzerinde doğrudan 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 |
Fiyatlandırma (Tamamı USD — Reklam Harcamasından %0)
Synter, reklam harcamasından %0 ücret alır (medya harcamasını doğrudan reklam ağları faturalandırır) ve kendi hesaplarını okumak ve dry_run: true önizlemeleri için $0.00 ücret alır. Tüm ayrıntılar: https://synterai.com/pricing:
| Plan | Fiyat | Koltuklar ve Çalışma Alanları | Dahil Aylık Kullanım Değeri ve Yazma Ücretleri |
|---|---|---|---|
| Ücretsiz Okuma Erişimi | $0.00 / ay | 1 koltuk, 1 çalışma alanı | Kendi hesaplarınızdaki tüm okuma sorguları için $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) ve tüm dry_run: true önizlemeleri. Kredi kartı gerekmez. |
| SOLO | $20.00 / ay ($200.00 / year) | 1 koltuk, 1 çalışma alanı | Talep edilebilir kullanım değeri olarak ayda $20.00 dahildir — her biri $0.05 olan en fazla 400 hafif yazma işlemini (pause_campaign, enable_campaign, update_campaign_budget), her biri $0.25 olan 80 standart yazma işlemini (add_keywords, add_negative_keywords, sync_audience, create_conversion) veya her biri $5.00 olan 4 tam MCP kampanya başlatımını karşılar. Yapılandırılabilir katı harcama sınırları beklenmedik ek ücretleri önler. |
| SCALE | $500.00 / ay ($5,000.00 / year) | 5 koltuk, birden fazla çalışma alanı | Talep edilebilir kullanım değeri olarak ayda $500.00 dahildir (ayda en fazla 10.000 hafif yazma veya 2.000 standart yazma dahildir), birden fazla çalışma alanında müşteri izolasyonu, 7/24 Autonomous Loop / Autopilot zamanlamaları, CRM/veri ambarı senkronizasyonu ve özel eşzamanlılık. |
| CUSTOM | Kurumsal Sözleşme | Özel koltuk ve çalışma alanı sayısı | Özel aylık kullanım kotası, ajans/kurumsal çoklu çalışma alanı yönetimi, özel SLA, SSO ve faturalı ödeme. |
Güvenlik Durumu, Yazma İşlemi Güvenceleri ve Çok Kiracılı Mimari
Dört Katmanlı Yazma Savunması
- Yerel Kesin Salt Okunur Mod (
--read-only/SYNTER_READ_ONLY=true): TümdestructiveHint: truearaçlarınıtools/listiçinden çıkarır ve herhangi bir ağ isteği makinenizden ayrılmadan önce yerel olarak değişiklikleri engeller. - Sunucu Tarafından Uygulanan Kapsamlı API Anahtarları (
POST /api/v1/keys): Salt okunur anahtarlar (reporting:read,campaigns:read,intel:read) veya yönlü güvenlik anahtarları (budget:decrease— acil kampanya duraklatmalarına ve bütçe azaltmalarına izin verirken bütçe artışlarını HTTP403ile reddeder) oluşturun. - Agent Shield Sunucu Tarafı İlke Geçidi: Her yeni kampanya için varsayılan olarak
PAUSED-on-create uygular; tek bir çağrıda bütçe artışı için en fazla2.0xsınırı,$5,000/dayçalışma alanı hız devre kesicisi,dry_run: true($0.00) önizlemeleri, yazma işlemi sonrasında zorunlu sağlayıcıdan geri okuma (get_ad_readback) ve değiştirilemez bir çalışma alanı denetim günlüğü sağlar. - Kendi Kimlik Bilgilerinizi Kullanan, MIT Lisanslı Açık Kaynaklı Barındırılan Yürütme:
@synterai/mcp-server@1.4.6öğesini kendi VPC/konteynerlerinizde çalıştırın ve kendi platform OAuth belirteçlerinizi doğrudan ortam değişkenleri üzerinden iletin; böylece Synter'ın barındırılan bulutu reklam hesabı kimlik bilgilerinizin hiçbirini saklamaz.
Çok Kiracılı ve Gömülü SaaS Kalıpları (docs.synterai.com/api/multi-tenant-auth)
- Kalıp 1 — Barındırılan, Çalışma Alanı Yalıtımlı Anahtarlar ve Bağlantı Bağlantıları:
POST https://synterai.com/api/v1/keysaracılığıyla çalışma alanına sabitlenmiş, kapsamı belirlenmiş alt API anahtarları oluşturun (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/startaracılığıyla self-servis reklamveren OAuth devir URL'leri oluşturun (tek platformlu birauthUrldöndürür) veyaPOST https://synterai.com/api/v1/connections/requestaracılığıyla müşteriye 7 günlük çok platformlu bağlantı bağlantısı gönderin.- Çok çalışma alanlı anahtarlarda etkin çalışma alanlarını
get_workspacesveupdate_active_workspacearacılığıyla değiştirin.
- Kalıp 2 — Kendi Kimlik Bilgilerinizi Kullanan, Kendi Sunucunuzda Barındırılan Mod (MIT Lisanslı Açık Kaynak):
- Kendi OAuth uygulamalarını yöneten ve müşteri belirteçlerini kendi KMS/kasalarında saklayan çok kiracılı SaaS uygulamaları, kiracı başına platform belirteçlerini ortam değişkenleri üzerinden ileterek yalıtılmış çalışan süreçlerinde
@synterai/mcp-serverveyasynterCLI'yi çağırabilir (GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_DEVELOPER_TOKEN,META_ACCESS_TOKEN,LINKEDIN_ACCESS_TOKENvb.).
- Kendi OAuth uygulamalarını yöneten ve müşteri belirteçlerini kendi KMS/kasalarında saklayan çok kiracılı SaaS uygulamaları, kiracı başına platform belirteçlerini ortam değişkenleri üzerinden ileterek yalıtılmış çalışan süreçlerinde
REST API ve Resmî Çok Dilli SDK'lar
- Barındırılan MCP (Akışlı HTTP):
https://mcp.synterai.com— OAuth 2.1 tarayıcı oturum açma veyaX-Synter-Key: syn_...başlığıyla kimlik doğrulaması yapın. Henüz barındırılan MCP'yeAuthorization: Bearer syn_...göndermeyin; REST/SDK'lar Bearer kullanır. - REST Uç Noktası:
POST https://synterai.com/api/v1/tools/run,Authorization: Bearer syn_...(veyaX-Synter-Key: syn_...) ve{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}JSON gövdesiyle. - TypeScript / JavaScript SDK:
npm install @synterai/sdk-js - Python SDK:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...); ölçümler içinclient.analytics.get_performance(...) - Rust SDK:
cargo add synter(crates.io/crates/synter) - Java SDK: Maven
ai.syntermedia:synter-sdk
Lisans
MIT Lisansı — LICENSE dosyasına bakın.