Adversee MCP sunucusu

Hızlı başlangıç

1. Panelde Ayarlar > API (MCP) sekmesinden bir anahtar üretin. Anahtar adv_ ile başlar ve yalnız bir kez gösterilir.
2. İstemcinizi aşağıdaki adrese, Authorization: Bearer <anahtar> başlığıyla bağlayın.
3. İstemcide araç listesini görüyorsanız bağlantı tamamdır. İlk deneme için asistandan rakip listesini isteyin.

Sunucu adresi

https://adversee.com/api/mcp

Kimlik doğrulama

Her istek Authorization: Bearer adv_… başlığı taşır. Anahtar kişiseldir ve bir çalışma alanına bağlıdır; asistan o çalışma alanının verisini sizin rolünüzle görür.

Her istekte anahtarın iptal edilmediği, hesabınızın aktif olduğu ve hâlâ ekipte olduğunuz yeniden sınanır. Ekipten çıkarılıp yeniden davet edilen kullanıcı yeni anahtar üretmelidir.

Kullanıcı başına çalışma alanında en çok 10 aktif anahtar olabilir. Anahtarlar panelden iptal edilir.

İstemci kurulumu

claude mcp add --transport http adversee https://adversee.com/api/mcp \
  --header "Authorization: Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

{
  "mcpServers": {
    "adversee": {
      "url": "https://adversee.com/api/mcp",
      "headers": { "Authorization": "Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

{
  "mcpServers": {
    "adversee": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://adversee.com/api/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${ADVERSEE_AUTH}"
      ],
      "env": { "ADVERSEE_AUTH": "Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

curl -s https://adversee.com/api/mcp \
  -H "Authorization: Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"adversee_list_competitors","arguments":{}}}'

Araçlar

Tüm araçlar salt okunurdur. Parametre adları API'de olduğu gibidir. Rakip süzgeçleri slug ya da ad kabul eder; slug'lar adversee_list_competitors'tan gelir.

Örnek yanıtlar

Kısaltılmış yanıtlar; '…' kısaltılan değerdir.

{
  "marka": { "slug": "rakip-a", "ad": "Rakip A" },
  "gorunum": "mobil",
  "kayitBaslangici": "2026-10-06 11:50:16+00",
  "turlar": [
    { "turId": "…", "zaman": "2026-10-07T10:00:12Z", "durum": "tamam",
      "liste": [
        { "sira": 1, "slideId": "…", "gorselId": "…", "hedef": "https://…", "gorselLinki": "https://adversee.com/app/panel-api/vitrin/gorsel/…" },
        { "sira": 2, "slideId": "…", "gorselId": "…", "hedef": null, "gorselLinki": "…" }
      ] },
    { "turId": "…", "zaman": "2026-10-07T12:00:09Z", "durum": "engel",
      "liste": null, "listeYokNedeni": "olculemedi" }
  ]
}

{
  "hareketler": [
    { "id": "…", "tip": "banner_eklendi", "baslik": "…", "rakip": "Rakip A",
      "rakipSlug": "rakip-a", "seviye": "hamle", "zaman": "2026-10-07T10:00:12.318Z",
      "kampanyaId": null, "ayrinti": { "gorunum": "mobil", "url": "https://…" } }
  ],
  "sonrakiCursor": "b2xheTo…"
}

"siniflama": {
  "tur": "teklif",
  "kategori": { "key": "ek_kazanc", "ad": "Ek Kazanç" },
  "grup": { "key": "bas_kazan", "ad": "Bas Kazan" },
  "oyun": "Efsane Mücevher Avcısı",
  "istemSurumu": 2,
  "onerilenKampanya": { "id": "…", "baslik": "…", "guven": 85 }
}

Sınırlar

• İstek sınırı: Anahtar başına dakikada 60 istek; aşılırsa 429.
• Toplu istek yok: JSON-RPC batch desteklenmez; her çağrı ayrı istek.
• Gövde boyutu: İstek gövdesi en çok 4 MB.
• Görsel boyutu: Görüntü olarak en çok 3,7 MB; üstünde panel linki döner.
• Geçersiz anahtar: Aynı adresten dakikada 20'den fazla geçersiz anahtar denemesi 429 alır; geçerli anahtarlar etkilenmez.
• Tazelenme: Banner 2 saatte, Meta 6 saatte bir taranır; daha sık çekmek yeni veri getirmez.

Hata kodları

Veriyi doğru okumak

• null 'yok' demek değildir, 'bilinmiyor' demektir. Ölçülemeyen değer 0 olarak verilmez.
• Banner sıra geçmişinde başarısız turun listesi null'dır ve listeYokNedeni nedenini söyler: olculemedi, eksik, kayit_hatasi ya da kayit_oncesi.
• Banner sıra geçmişi 06.10.2026'dan itibaren birikiyor; daha önceki turlar kayit_oncesi döner.
• Hareketleri düzenli çekerken baslangic'i son çekimden 15 dakika geriye alın ve kayıtları id ile tekilleştirin; aynı anda yazılan kayıtlar birkaç saniye geç görünebilir.
• Tarih parametreleri saat dilimiyle verilmelidir (ör. 2026-10-07T00:00:00Z ya da +03:00).
• Meta, giriş yapmamış ziyaretçiye büyük sayfalarda yalnız ilk sayfayı gösteriyor, bazı sayfaları hiç göstermiyor. 'kapsam' alanı bunu marka bazında söyler; sayılar farklı reklam görseli sayısıdır.
• Görsel sınıflama yapay zekâ tahminidir: emin olunmayan alan null kalır, oyun adı yalnız görselde yazıyorsa verilir, kampanya eşleşmesi kesin bağ değil güven puanlı öneridir.
• Bir Meta reklamı 'bitti' sayılmadan önce en az 12 saat ve en az 3 tam okunan turda görünmemiş olmalıdır.