Hızlı başlangıç
- Panelde Ayarlar > API (MCP) sekmesinden bir anahtar üretin. Anahtar adv_ ile başlar ve yalnız bir kez gösterilir.
- İstemcinizi aşağıdaki adrese, Authorization: Bearer <anahtar> başlığıyla bağlayın.
- İ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/mcpKimlik doğrulama
Her istek Authorization: Bearer adv_… başlığı taşır. Anahtar kişiseldir ve bir çalışma alanına bağlıdır; ekip üyesi olduğunuz sürece çalışı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; Sahip ve Yönetici rolleri ekibin anahtarlarını görür ve iptal eder.
Her araç çağrısı denetim kaydına yazılır; kayıtlar 180 gün tutulur.
Yazma araçları her çağrıda rolünüzü yeniden okur: kategori ve grup atama ile URL'den rakip ekleme Sahip, Yönetici ve Üye rollerine; rakip sınıfı, sosyal hesap ve taksonomiye ekleme Sahip ve Yönetici rollerine açıktır. İzleyici (viewer) yazamaz, gizli çalışma alanında yazma yapılmaz.
İstemci kurulumu
Claude Code
Terminalde tek komut:
claude mcp add --transport http adversee https://adversee.com/api/mcp \
--header "Authorization: Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"Cursor
~/.cursor/mcp.json (ya da projede .cursor/mcp.json) dosyasına:
{
"mcpServers": {
"adversee": {
"url": "https://adversee.com/api/mcp",
"headers": { "Authorization": "Bearer adv_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" }
}
}
}Claude Desktop
Claude Desktop'ın ayar dosyası uzak sunucuya doğrudan bağlanmaz; mcp-remote köprüsüyle bağlanır (Node.js gerekir). claude_desktop_config.json dosyasına ekleyip uygulamayı yeniden başlatın. Anahtarın ortam değişkeninde durması Windows'taki boşluk sorununu önler.
{
"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" }
}
}
}Doğrudan HTTP
Herhangi bir MCP istemcisi ya da test için JSON-RPC isteği:
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
adversee_set_, adversee_add_, adversee_update_ ve adversee_close_ ile başlayan araçlar ve adversee_undo_change yazar, diğerleri yalnız okur. Parametre adları API'de olduğu gibidir. Rakip süzgeçleri çoğu araçta slug ya da ad kabul eder; adversee_list_campaigns ve adversee_get_banner_history yalnız slug kabul eder. Slug'lar adversee_list_competitors'tan gelir.
adversee_list_competitors
İzlenen rakipler: ad, slug, site, sizin markanız olup olmadığı (kendiMarkamiz), aktif ve arşiv kampanya sayısı ve izleme durumu (durum).
Parametre yok.
adversee_list_campaigns
Kampanyalar: başlık, bağlantı, durum, sitenin yazdığı tarihler, ilk ve son görülme (sonGorulme), kalkış tespiti (kaldirilmaTespiti), görsel adresi (gorselAdresi), kategori, grup ve kategorinin nasıl atandığı (kategoriElle: true elle, false model, null henüz yorumlanmadı). gorselAdresi rakibin sitesindeki adrestir; görsel bizde saklanmaz ve adversee_get_image ile alınmaz. Her öğede rakipSlug vardır; liste toplam, offset, kayit ve devamiVar alanlarıyla sarılıdır.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | slug | Rakip slug'ı; ad kabul edilmez. |
durum | aktif · yakinda · pasif · kaldirildi | Kampanya durumu. |
baslangic | ISO tarih-saat, saat dilimli | Bu andan sonra sitede görülmüş kampanyalar. |
bitis | ISO tarih-saat, saat dilimli | Bu andan önce sitede görülmeye başlamış kampanyalar. İkisi birlikte, sitede görüldüğü dönem aralıkla kesişen kampanyaları seçer. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_get_campaign
Tek kampanya: okunan alanlar (limit, çevrim, oran), şartlar ve tüm anlık görüntüler (en yeni önce, her birinde kodSurumu).
| Parametre | Tip | Açıklama |
|---|---|---|
id | uuid | adversee_list_campaigns'ten. |
adversee_list_events
Hareketler, en yeni önce: kampanya, banner, Meta, sosyal paylaşım, kesinti ve geçilme olayları. Değişen alanların önceki ve yeni değeri 'ayrinti'dedir; banner olaylarında ayrinti görselin gorselId'sini de taşır.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad; izlemeden çıkarılmış marka için slug. |
tip | metin | Virgülle birden çok olay tipi. Geçerli tipler: new_campaign, changed_campaign, changed_field, ended_campaign, reactivated_campaign, banner_eklendi, banner_kalkti, banner_guncellendi, meta_reklam_yeni, meta_reklam_bitti, meta_reklam_dondu, sosyal_paylasim_yeni, google_reklam_yeni, site_down, site_up, overtaken, regained, brand_ready. Bilinmeyen tip hata döner. |
baslangic | ISO tarih-saat, saat dilimli | Bu andan (dahil) sonrası. |
bitis | ISO tarih-saat, saat dilimli | Bu andan öncesi. |
cursor | metin | Önceki yanıtın sonrakiCursor değeri. |
limit | 1-100 (25) | Sayfa boyu. |
adversee_get_digest
Günlük (09:00) ya da haftalık (pazartesi 09:00) özet: rakip başına banner, Meta ve sosyal paylaşım sayıları. Ölçülmeyen yüzey null gelir ve nedeni (olculmedi ya da eksik) ayrıca verilir.
| Parametre | Tip | Açıklama |
|---|---|---|
donem | gun · hafta (gun) | Özet dönemi. |
adet | 1-14 (1) | Kaç dönem, en yeni önce. Günde en çok 14, haftada en çok 8 dönem döner. |
adversee_list_homepage_banners
Anasayfa banner'ları (masaüstü/mobil): kalıcı kimlik, sıra, hedef, ilk/son görülme, kalkma zamanı, önceki sürüm, görünüm başına son tur ve sınıflama.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
durum | aktif · kalkan (aktif) | Yayındakiler ya da son 30 günde kalkanlar. |
tur | teklif · icerik · marka_geneli | Sınıflama süzgeci. Süzgeç verilince sınıflanmamış görsel listede çıkmaz. |
kategori | metin | Kategori anahtarı ya da adı. |
grup | metin | Oyun grubu anahtarı ya da adı. |
oyun | metin | Görselde yazan oyun adında geçen metin. |
adversee_get_banner_history
Bir rakibin banner sırasının tur tur listesi (2 saatte bir tur). Turlar eskiden yeniye ve sayfalıdır; yanıtta toplamTur, limit, offset, devamiVar ve her turda kodSurumu bulunur.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | slug | Zorunlu; ad kabul edilmez. |
gorunum | masaustu · mobil | Zorunlu. |
baslangic | ISO tarih-saat, saat dilimli | Yoksa bitişten 24 saat önce. |
bitis | ISO tarih-saat, saat dilimli | Yoksa şimdi. Pencere en çok 366 gün. |
limit | 1-500 (100) | Sayfadaki tur sayısı. |
offset | ≥0 (0) | Atlanacak tur. |
adversee_list_meta_ads
Meta (Facebook/Instagram) reklamları: kütüphane kodu ve bağlantısı, başlangıç, ilk/son görülme, bitti zamanı, metin, hedef, aynı görselle yayındaki reklam sayısı (ayniGorselleReklam), video, görselden okunan yazı (gorseldenOkunan), gorselId, gorselLinki, sınıflama ve marka bazında kapsam. durum: biten tüm geçmişi verir; en yeni 2000 biten reklam içinde sayfalanır.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
durum | aktif · biten (aktif) | Aktif ya da biten reklamlar. |
tur | teklif · icerik · marka_geneli | Sınıflama süzgeci. Süzgeç verilince sınıflanmamış görsel listede çıkmaz. |
kategori · grup · oyun | metin | Banner aracındaki sınıflama süzgeçleri. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_get_image
Banner ya da reklam görseli, MCP görüntüsü olarak (png, jpeg, gif, webp; en çok 3,7 MB). Video reklamda görsel kapak karesidir. Daha büyük ya da başka türde görselde panel bağlantısı döner.
| Parametre | Tip | Açıklama |
|---|---|---|
tur | banner · meta | Görselin geldiği yüzey. |
gorselId | uuid | Banner ya da Meta aracının çıktısından. |
adversee_get_scan_status
Verinin tazeliği: her rakip için kampanya taraması, banner (masaüstü/mobil) ve her Meta sayfası için son tur, son başarılı tur, son turu koşan yazılımın sürümü (sonTurKodSurumu) ve son 7 günün durum dağılımı; kampanya taramasında son başarılı turda bulunan kampanya sayısı (sonBasariliTurdaBulunan). Her rakibin açık sağlık arızaları acikArizalar'da, banner ve Meta takibinin açık olup olmadığı yuzeyTakibi'nde. Devam eden tur sayılmaz; Meta'da eksik okunan (kismi) tur başarılı sayılmaz. Zamanlar ISO 8601 (UTC).
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
adversee_list_competitor_notifications
Bildirim Köprüsü'yle yakalanan rakip push ve SMS'leri: gönderen, metin, ilk/son görülme, kaç kez geldiği ve sizin köprünüzün her alımının zamanı (06.10.2026'dan itibaren).
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
baslangic | ISO tarih-saat, saat dilimli | Bu andan sonra en az bir kez görülenler. |
bitis | ISO tarih-saat, saat dilimli | Bu andan önce ilk görülenler. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_get_overtakes
Rakiplerin sizi geçtiği alanlar (ör. üst limit, oran): açık geçilmeler ve son kapananlar.
Parametre yok.
adversee_list_taxonomy
Aktif taksonomi: kampanya kategorileri (key, ad, açıklama, agresiflik) ve oyun/ürün grupları. Kategori ve grup atama araçları bu key'leri ya da adları alır.
Parametre yok.
adversee_set_campaign_category
Yazar. Kampanyanın kategorisini elle atar ya da temizler; elle atanan kategori yapay zekânın sonraki yorumlarında korunur. Sahip, Yönetici, Üye. Yanıtta degisiklikId ile önceki ve yeni hâl gelir.
| Parametre | Tip | Açıklama |
|---|---|---|
kampanyaId | uuid | adversee_list_campaigns'ten. |
kategori | metin | null | Kategori key'i ya da adı; null temizler. |
adversee_set_campaign_group
Yazar. Kampanyanın oyun/ürün grubunu elle atar ya da temizler. Sahip, Yönetici, Üye.
| Parametre | Tip | Açıklama |
|---|---|---|
kampanyaId | uuid | adversee_list_campaigns'ten. |
grup | metin | null | Grup key'i ya da adı; null temizler. |
adversee_set_competitor_class
Yazar. İzlenen markanın sınıfını rakip ya da bayi yapar; kendi markanız değişmez. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
sinif | rakip | bayi | Yeni sınıf. |
adversee_add_social_account
Yazar. Rakibe YouTube, Instagram, TikTok ya da X hesabı ekler; hesap platformda doğrulanır, gizli ya da bulunamayan hesap eklenmez. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
platform | youtube | instagram | tiktok | x | Platform. |
hesap | metin | Adres ya da kullanıcı adı, ör. @bilyoner. |
adversee_update_social_account
Yazar. Rakibin takip edilen sosyal medya hesabını başka bir hesapla değiştirir: eski takip kapanır, yeni hesap platformda doğrulanıp eklenir; doğrulanamazsa eski takip açık kalır. Yeni girdi aynı hesaba çıkarsa (yalnız adı değişmişse) takip sürer. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
platform | youtube | instagram | tiktok | x | Platform. |
eskiHesap | metin | Şu an takip edilen hesap. |
yeniHesap | metin | Yerine eklenecek hesap, ör. @bilyoner. |
adversee_add_meta_page
Yazar. Rakibe Meta Reklam Kütüphanesi'nde izlenecek Facebook sayfası ekler; sayfa yalnız bu çalışma alanı için eklenir ve sonraki Meta turunda okunur. Çalışma alanı başına en çok 5 ek sayfa. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
sayfa | metin | Sayfa kimliği ya da Reklam Kütüphanesi adresi (view_all_page_id=…). |
adversee_close_meta_page
Yazar. Çalışma alanının eklediği Meta sayfasının takibini kapatır; okunmuş reklamlar silinmez. Adversee'nin herkes için izlediği sayfa kapatılamaz. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | metin | Slug ya da ad. |
sayfa | metin | Sayfa kimliği ya da Reklam Kütüphanesi adresi. |
adversee_undo_change
Yazar. Aynı anahtarla son 24 saatte yapılmış bir yazmayı (taksonomi eklemesi hariç) geri alır; kayıt o arada yeniden değiştiyse geri almaz. Sosyal hesap ya da Meta sayfası eklemesini geri almak takibi kapatır, hesap silinmez; hesap değişikliğini geri almak eski takibi açar; sayfa kapatmayı geri almak sayfayı yeniden açar.
| Parametre | Tip | Açıklama |
|---|---|---|
degisiklikId | uuid | Yazma yanıtındaki kimlik. |
adversee_add_taxonomy_items
Yazar, iki adımlı. Taksonomiye kategori, oyun/ürün grubu ya da çıkarılacak alan ekler; silme ve yeniden adlandırma yapmaz. onayKodu olmadan çağrılınca hiçbir şey değişmez: eklenecekler, doğrulama uyarıları ve etki (yeniden yorumlanacak kampanya, yeniden sınıflanacak görsel, teyit üst sınırı, tahmini yapay zekâ çağrısı ve token) ile 10 dakika geçerli onay kodu döner. Kullanıcı onaylarsa aynı girdi ve onayKodu ile uygulanır; kampanyalar ve görseller arka planda yeniden işlenir, geri alınamaz. Tahmini çağrı tavanı aşan değişiklik uygulanmaz; çalışma alanı başına 24 saatte 1; önceki değişikliğin yeniden sınıflaması bitmeden yenisi yapılamaz. Sahip, Yönetici.
| Parametre | Tip | Açıklama |
|---|---|---|
kategoriler | liste (≤10) | ad, isteğe bağlı key, aciklama, agresiflik (0-1). |
gruplar | liste (≤10) | ad, isteğe bağlı key, aciklama. |
alanlar | liste (≤10) | ad, tur, aciklama (≥20 karakter), secenekler, birim, listedeGoster, izle, kiyas. Ölçülene kadar filtreye çıkmaz. |
onayKodu | metin | Önizlemenin verdiği kod; yalnız kullanıcı onayından sonra. |
adversee_add_competitor
Yazar, iki adımlı. Site adresinden yeni rakip ekler: izlemeye alır, kampanya listesi için tarifi yapay zekâyla çıkarır ve ilk taramayı yapar (arka planda). onayKodu olmadan çağrılınca hiçbir şey değişmez: site, kampanya yolu ve plan kotası ile 10 dakika geçerli onay kodu döner. Rakip plan kotasından düşer; adı site adresi olur. Yalnız kamusal http(s) adres; IP ve iç ağ adresi kabul edilmez. Rakip ekleme kapalıysa çalışmaz. Anahtar başına saatte 5, çalışma alanı başına günde 20. Geri alınamaz. Sahip, Yönetici, Üye.
| Parametre | Tip | Açıklama |
|---|---|---|
url | metin | Site ya da kampanya sayfası adresi. |
onayKodu | metin | Önizlemenin verdiği kod; yalnız kullanıcı onayından sonra. |
adversee_seo_keywords
SEO / GEO / ASO (ayrı satılan ürün). Takip edilen arama kelimeleri: Google organik ya da mağaza araması, grup, aylık hacim, son okuma günü, bizim en iyi sıramız, takip edilen rakiplerin en iyisi, 7 günlük sıra farkı (pozitif = yükseldi), SERP öğeleri ve AI Overview. hacim null = Google Ads hacim vermedi (0 değil); sonOkuma doluyken bizimSira null = ilk 'derinlik' sonuçta yok.
| Parametre | Tip | Açıklama |
|---|---|---|
kaynak | google · play · ios | Arama kaynağı. |
grup | metin | Kelime grubu (tam eşleşme). |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_sira_dagilimi
Takip edilen her alan ya da uygulama için en yeni okuma gününde kelimelerin sıra kovaları: 1-3, 4-10, 11-20, 21-50, 51-100, sıralanmadı (okumada görülen ilk K organik sonuçta yok; K = kapsam, 30 derinlikte ~26-30, 100 derinlikte ~90-100; her okumada kesin). K'nın ötesi ölçülmediği için 21-50 / 51-100 kovaları adet null ya da kismi (alt sınır, olculenUst..olculenUstEnCok = kovayı etkileyen okumaların K aralığı). Önceki gün ve 7 gün öncesine fark yalnız iki günde de okunan kelimelerde ve kelime başına iki günün küçük K'sıyla (ortak kapsam); bu kapsamla tam ölçülmeyen kovada fark null.
| Parametre | Tip | Açıklama |
|---|---|---|
kaynak | google · play · ios | Arama kaynağı (google). |
grup | metin | Kelime grubu (tam eşleşme). |
adversee_seo_kelime_tablosu
Kelime başına bizim sıra (sirada / disinda / okunmadi / tanimsiz), kova, URL, 1/7/30 günlük değişim (fark null iken girdi/cikti/belirsiz), takip edilen her rakibin sırası, rakipOnde ve SERP öğeleri. Süzgeç, sıralama ve sayfalama sunucuda.
| Parametre | Tip | Açıklama |
|---|---|---|
kaynak | google · play · ios | Arama kaynağı (google). |
grup | metin | Kelime grubu (tam eşleşme). |
kova | 1-3 · 4-10 · 11-20 · 21-50 · 51-100 · siralanmadi | Bizim sıramızın kovası. |
rakipOnde | true · false | Yalnız rakibin önde olduğu kelimeler. |
sirala | kelime · hacim · sira · g1 · g7 · g30 | Sıralama (sira). |
yon | artan · azalan | Yön; bilinmeyen değer her zaman sonda. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_youtube
Takip edilen YouTube kelimeleri (Türkiye, ilk 20 blok, varsayılan haftalık okuma): kendi kanalınızın ve takip edilen rakip kanalların en iyi video sırası, önceki okumaya göre fark, kanal görünürlük payı (her okunan kelimede kanal videolarının 1/sıra ağırlığı ÷ tüm videoların ağırlığı; kelimeler eşit ortalanır) ve kelime verilirse o okumanın videoları (başlık, kanal, görüntülenme, yayın zamanı, süre). sira null + okuma günü dolu = ilk 'kapsam' videoda yok; null değerler 0 değildir.
| Parametre | Tip | Açıklama |
|---|---|---|
kelime | uuid | Videoları istenen kelime (kelimeler[].id). |
adversee_seo_store_apps
Takip edilen Google Play ve App Store uygulamaları: son gözlem (kurulum yalnız Play'de kesin sayı), puan, puan sayısı, spor kategorisinde sıra (Play ilk 200, iOS ilk 100), sürüm, 30 günlük kategori sırası serisi ve en yeni iki yorum.
| Parametre | Tip | Açıklama |
|---|---|---|
platform | play · ios | Mağaza süzgeci. |
adversee_seo_changes
Takip edilen kelime, uygulama, alan ve AI sorularındaki değişimler (en yeni önce): değişen alan, önceki ve sonraki değer, önem ve çalışma alanına özel yapay zekâ yorumu. Sayfalama: sonrakiOffset null ise bitti.
| Parametre | Tip | Açıklama |
|---|---|---|
nesneTur | uygulama · kelime · alan · ai_soru · llm_marka | Nesne türü. |
onem | yuksek · orta · dusuk | Önem süzgeci. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_backlinks
alan verilmezse takip edilen alan adlarının özeti: son 12 ayın tahmini organik trafiği (etv), backlink özeti ve kayıtlı listede son 30 günde görülen yeni/kayıp backlink sayısı. alan verilirse o alanın yeni ya da kayıp backlink listesi.
| Parametre | Tip | Açıklama |
|---|---|---|
alan | metin | Takip edilen alan adı (ör. bitalih.com). |
tur | yeni · kayip (yeni) | Liste türü. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_ai_visibility
Takip edilen sorular × yapay zekâ modelleri (chatgpt, claude, gemini, perplexity): son yanıtta kendi alanınız ya da markanız anıldı mı, anılan takipli alanlar, kaynaklar ve yanıtın başı. yanit null = o model için yanıt yok (ölçülmedi).
Parametre yok.
adversee_seo_ajan_hazirligi
Ajan hazırlığı (GEO): takip edilen alan adlarında haftalık kendi taramamızla robots.txt ve Sitemap, 13 AI botunun izni tek tek (eğitim, arama, kullanıcı ajanı ayrımıyla), Content-Signal, /llms.txt, Markdown içerik müzakeresi, JavaScript'siz metin, JSON-LD türleri, MCP ve A2A ajan kartları. Her kontrol var · yok · kismi · okunamadi, kanıt ve HTTP koduyla; toplam puan yok. Kendi alanlarınız için efor sıralı öneriler ve bunu yapan rakipler. okunamadi = kaynak okunamadı ('yok' değil).
Parametre yok.
adversee_seo_icerik_boslugu
Takip edilen rakiplerin Google organik ilk 100'de sıralandığı, kendi alanınızın ilk 100'de olmadığı kelimeler; hacme göre (içerik önerisi). Grup: kendi kelime grubunuz ya da kurala dayalı tahmin (at yarışı, spor, şans oyunu). kesin false = kendi listemiz kesik, 'yok' doğrulanamadı. Alan başına ayda bir okuma.
| Parametre | Tip | Açıklama |
|---|---|---|
kesin | true · false (false) | Yalnız kesin boşluklar. |
limit | 1-100 (25) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_ai_kaynaklari
Yapay zekâ yanıtlarının kaynak gösterdiği siteler, alan adı bazında: kaç yanıtta ve soruda, hangi modellerde, o yanıtlarda sizin ve rakiplerin anılması. oneri true = kendi siteniz değil ve bu kaynağı veren hiçbir yanıtta anılmadınız. Ek istek yok.
Parametre yok.
adversee_seo_llm_anilma
AI'da anılma (DataForSEO LLM Mentions), haftalık: kendi markanız ve takip ettiğiniz rakiplerin AI yanıtlarında anılma sayısı (veritabanı toplamı, haftalık artış değil), izlenen markalar içindeki pay ve önceki haftaya göre fark, kaynak alanlar, örnek sorular (iki haftada bir) ve 12 haftalık seri. Türkiye'de yalnız Google AI Overview anılmaları; ChatGPT verisi yok. Takipteki Google kelimelerinin AI arama hacmi de döner.
Parametre yok.
adversee_seo_kurulum_hizi
Takip edilen Google Play uygulamalarının günlük kurulum hızı: kesin kurulum sayısının değiştiği iki okuma arasındaki fark, aradaki süreye bölünür. Değişmeyen okuma 0 kurulum değil, güncellenmedi sayılır. 7 ve 28 günlük ortalama, takip edilen uygulamalar içinde yeni kurulum payı ve 28 günlük seri. App Store için yalnız puan sayısı artışı (indirme değil). hız null = bilinmiyor.
Parametre yok.
adversee_seo_yorum_konulari
Mağaza yorumlarının konuları (kurala dayalı Türkçe sözlük, yapay zekâ yok): para çekme, para yatırma, giriş/şifre, hata/çökme, oranlar/ikramiye, müşteri hizmetleri, yayın, kampanya/bonus. Marka × konu × hafta adetleri, puandan duygu, son 7 gün ile önceki 7 gün eğilimi (bizde artan, rakipte azalan) ve sürüm değişimi öncesi/sonrası 7 gün.
Parametre yok.
adversee_seo_icgoruler
marka_koruma: kendi marka kelimelerinizin SERP'inde rakip reklamları ve ilk 3'teki şikâyet siteleri. cizelge: son 8 hafta, marka başına SEO hareketleri ile yeni banner, Meta reklamı ve kampanya olayları aynı haftada yan yana (neden-sonuç değil). magaza_etki: mağaza sayfası değişiminden önceki ve sonraki 7 günün kategori sırası ve kurulum hızı; veri azsa yetersiz veri.
| Parametre | Tip | Açıklama |
|---|---|---|
tur | marka_koruma · cizelge · magaza_etki | İçgörü türü. |
adversee_seo_uygulama_kelimeleri
Rakip uygulamaların mağaza başlık, alt başlık ve açıklamasından 1-3 kelimelik aday kelimeler: rakiplerde kullanım ağırlığı (başlık 3, alt başlık 2, açıklama 1), kendi uygulamanızda var mı, takipte mi, takipteyse son mağaza sırası. Talep puanı bir öneri sinyalidir (0-100, App Store ve Google Play arama önerilerinde göründüğü en kısa önek ve sırası, varsa Google hacmi), arama hacmi değildir; null = ölçülmedi, kismi = bir bileşen eksik. Marka adı içerenler ayrı listede.
| Parametre | Tip | Açıklama |
|---|---|---|
marka | true · false | true: yalnız marka adı içeren adaylar. |
limit | 1-100 | En çok kayıt (25). |
adversee_seo_inapp_eventler
Takip edilen App Store uygulamalarının sayfasındaki in-app event'ler (günde bir okunur): ad, açıklama, başlangıç, bitiş (sayfada yoksa boş), ilk ve son görülme, sayfadan kalktığı gün, durum. Son 120 gün. Google Play event'leri kapsam dışı.
| Parametre | Tip | Açıklama |
|---|---|---|
rakip | true · false | true: yalnız rakiplerin event'leri. |
adversee_seo_kelime_arastirmasi
Panelden yapılan Google kelime araştırmaları (Türkiye, Türkçe), yalnız önbellekten: kelime, hacim, CPC, rekabet, zorluk (0-100), arama niyeti, takipte mi ve takip edilen alanlardan bu kelimede sıralananlar (son SERP ya da aylık Labs listesi). Araç yeni araştırma yapmaz; yeni araştırma ücretlidir ve panelden yapılır.
| Parametre | Tip | Açıklama |
|---|---|---|
id | uuid | Listedeki araştırma. |
tohum | metin | Tohum kelimenin en yeni araştırması. |
yontem | fikir · oneri · ilgili | Araştırma yöntemi (fikir). |
limit | 1-100 (25) | Satır sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_teknik_sorunlar
Kendi alanınızın aylık tam teknik taraması (DataForSEO On-Page; rakipte tam tarama yok): alan başına son tarama, taranan sayfa, sorun türü başına sorunlu sayfa ve bir önceki taramayla kıyas; sorunlu sayfalar önem sırasıyla (kırık iç link, 4xx/5xx, yönlendirme zinciri, başlık ve meta açıklama, h1, noindex, canonical, yavaş ve büyük sayfa). Denetim alanı gelmeyen sayfa sorunsuz sayılmaz. Yeni ve düzelen sorunlar değişim günlüğünde. Her alanda sahiplik doğrulamasının durumu (onay, yöntem: DNS TXT, meta etiket, operatör; son deneme ve nedeni); doğrulama jetonu yalnız panelde.
| Parametre | Tip | Açıklama |
|---|---|---|
onem | yuksek · orta · dusuk | Önem süzgeci. |
tur | kirik_link · kod_4xx · … · buyuk | Sorun türü. |
limit | 1-100 (50) | Kayıt sayısı. |
offset | ≥0 (0) | Sayfalama. |
adversee_seo_arama_ilgisi
Arama ilgisine seçilen kelimelerin son 12 ay haftalık Google Trends eğrisi (Türkiye). Değer kelimenin kendi zirvesine göre 1-100; kelimeler arasında karşılaştırılmaz. Aynı haftalardaki yeni banner, Meta reklamı ve kampanya olayları yan yana (neden-sonuç değil).
Parametre yok.
adversee_seo_lighthouse
Ana sayfa ve seçtiğiniz önemli adreslerin (kendi alanda en çok 20, rakipte 5) haftalık mobil Lighthouse ölçümü: performans, erişilebilirlik, SEO ve en iyi uygulama puanları, LCP, CLS ve TBT; son ve önceki ölçüm ile seri, rakiplerle yan yana. INP laboratuvar ölçümünde yoktur (null). Tek ölçüm koşudan koşuya oynar.
| Parametre | Tip | Açıklama |
|---|---|---|
gun | 30 · 90 · 180 (90) | Seri penceresi. |
Örnek sorular
Aşağıdaki sorular bugünkü araçlarla cevaplanabilir. Her birinin altında asistanın hangi aracı nasıl kullandığı yazıyor.
- Teyitli kampanya eşleşmesi olan aktif banner'lar hangileri? adversee_list_homepage_banners (durum: aktif). Teyit için süzgeç yok; asistan siniflama.onerilenKampanya.teyit.durum değeri teyitli olanları ayıklar.
- Son 30 günde hangi kampanyalar kalktı, ne zaman? adversee_list_campaigns (baslangic: 30 gün önce); kaldirilmaTespiti dolu olanlar siteden kalkmıştır ve kalkış sonGorulme ile kaldirilmaTespiti arasında olmuştur. durum: kaldirildi yalnız bitiş tarihi geçmeden kalkanları verir; tarihi geçmiş olanlar pasif görünür.
- Ekibin reddettiği eşleşmeler hangileri? adversee_list_homepage_banners ve adversee_list_meta_ads; asistan teyit.durum değeri reddedildi, teyitEden değeri musteri olanları ayıklar.
- Dün eklenen banner'ın görselini göster. adversee_list_events (tip: banner_eklendi, baslangic ve bitis dünün aralığı) ayrinti.gorselId verir; adversee_get_image (tur: banner) görseli döndürür.
- Son 3 ayda 1. sıraya konan banner'lar hangileri? adversee_get_banner_history (rakip slug'ı, gorunum, baslangic: 3 ay önce). devamiVar true iken offset artırılarak tüm turlar alınır; asistan sira 1 olan öğeleri ayıklar.
- Şu an hangi rakiplere erişilemiyor? adversee_get_scan_status; acikArizalar listesi engelli ve erisilemiyor gibi arızaları verir.
- Rakiplerin son sosyal paylaşımları neler? adversee_list_events (tip: sosyal_paylasim_yeni). Sosyal medya için ayrı araç yok; hesap verisi MCP'de değil.
Örnek yanıtlar
Kısaltılmış yanıtlar; '…' kısaltılan değerdir. Alan adları API'nin döndürdüğü gibi Türkçedir; yalnız adversee_get_campaign İngilizce anahtarlar döndürür.
adversee_get_banner_history
{
"marka": { "slug": "rakip-a", "ad": "Rakip A" },
"gorunum": "mobil",
"kayitBaslangici": "2026-10-06 11:50:16+00",
"toplamTur": 2, "limit": 100, "offset": 0, "devamiVar": false,
"turlar": [
{ "turId": "…", "zaman": "2026-10-07T10:00:12Z", "durum": "tamam", "kodSurumu": "…",
"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", "kodSurumu": "…",
"liste": null, "listeYokNedeni": "olculemedi" }
]
}adversee_list_events
{
"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", "slideId": "…", "gorselId": "…", "url": "https://…" } }
],
"sonrakiCursor": "b2xheTo…"
}Banner ve Meta öğelerindeki sınıflama
"siniflama": {
"tur": "teklif",
"kategori": { "key": "hos_geldin", "ad": "Hoş Geldin" },
"grup": { "key": "spor_bonusu", "ad": "Spor Bonusu", "kaynak": "model" },
"oyun": "Rakip Slot",
"istemSurumu": 4,
"oyunTeyit": { "durum": "teyitli", "teyitEden": "ajan", "zaman": "…", "gerekce": "…" },
"onerilenKampanya": {
"id": "…", "baslik": "…", "guven": 85,
"teyit": { "durum": "aday", "teyitEden": null, "zaman": null, "gerekce": null }
},
"siniflandi": "2026-10-09T08:12:40.511Z"
}Sınırlar
- İstek sınırı: Anahtar başına dakikada 60 istek; aşılırsa 429.
- Yazma sınırı: Anahtar başına dakikada 10, kullanıcı başına saatte 50, çalışma alanı başına saatte 100 yazma; aşılırsa araç hata döner. Geri alma yalnız dakika sınırına tabidir.
- Toplu istek yok: JSON-RPC batch desteklenmez; her çağrı ayrı istek.
- Gövde boyutu: İstek gövdesi en çok 4 MiB.
- Görsel boyutu: Görüntü olarak en çok 3,7 MB; üstünde panel bağlantısı 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ı
| Durum | Anlamı |
|---|---|
401 | Anahtar yok, biçimi bozuk, iptal edilmiş ya da üyelik sona ermiş. |
429 | Dakikalık istek sınırı ya da geçersiz anahtar sınırı aşıldı. |
400 | Gövde geçerli JSON değil ya da toplu (batch) istek gönderildi. |
413 | Gövde 4 MiB'ı aşıyor. |
406 | Accept başlığı application/json ve text/event-stream değerlerini birlikte içermiyor. |
415 | Content-Type başlığı application/json değil. |
405 | Sunucu durumsuz; yalnız POST desteklenir. |
isError | Araç çalıştı ama sonuç vermedi (ör. 'Kayıt bulunamadı.', geçersiz tarih ya da bilinmeyen olay tipi); açıklama mesajdadır. |
Veriyi doğru okumak
- null 'yok' demek değildir, 'bilinmiyor' demektir. Ölçülemeyen değer 0 olarak verilmez.
- Banner sıra geçmişinde listesi bilinmeyen turun listesi null'dır ve listeYokNedeni nedenini söyler: olculemedi (tur başarısız), eksik, kayit_hatasi ya da kayit_oncesi.
- Banner sıra geçmişi 06.10.2026'dan itibaren birikiyor; daha önceki başarılı turlar kayit_oncesi, başarısız turlar olculemedi 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 güven puanlı öneridir. Her eşleşme aday, teyitli ya da reddedildi durumundadır; teyidi ikinci bir yapay zekâ denetimi (ajan) ya da çalışma alanı ekibi (musteri) verir ve ekibin kararı ajanınkini geçersiz kılar. Ekip modelin önerdiğinden farklı bir kampanyayı teyit ettiyse guven null'dır. Reddedildi durumundaki eşleşmeyi kanıt olarak kullanmayın.
- Bir Meta reklamı 'bitti' sayılmadan önce en az 12 saat ve en az 3 tam okunan turda görünmemiş olmalıdır.
- Meta olaylarında meta_reklam_yeni ilk kez görülen reklamdır; bitti denip yeniden görünen reklam ayrı tipte gelir (meta_reklam_dondu) ve yeni sayılmaz. Özetteki donen alanı bunu sayar.
- Rakip bildirimlerinde her alımın zamanı 06.10.2026'dan itibaren tutuluyor; daha eski alımlar için yalnız ilk/son görülme ve adet vardır (alimKaydiTam: false). alimlar yalnız sizin köprünüzün aldıklarıdır (kart başına en yeni 20, tamamı alimSayisi). Kartın kendisi markayı izleyen her çalışma alanının köprüsünden beslenir; adet hepsinin toplamıdır. sonGorulme, süzgece uyan kartların en son görülme zamanıdır.
- Sosyal medya olayı sosyal_paylasim_yeni, izlenen hesabın son 72 saatte yayınladığı ve ilk kez görülen paylaşımıdır. Hesabın ilk okumasında ya da 24 saatten uzun okuma boşluğundan sonra olay yazılmaz; özetteki sosyal alanı bu yüzden yalnız ölçülen hesapları sayar ve ölçülemeyenleri eksikKapsam'da adıyla verir.
- Bir yüzey hakkında 'yok' ya da 'değişmedi' demeden önce adversee_get_scan_status ile o yüzeyin son başarılı turuna bakın.
MCP ile yapamadıklarınız
- Silmek ya da ayar değiştirmek: rakibi bırakma, sosyal hesap takibini değiştirmeden kapatma, Adversee'nin herkes için izlediği Meta sayfasını kapatma, kategori silme; rakip ekleme kapalıyken rakip eklemek, taksonomiden silme ya da yeniden adlandırma, bildirim tercihleri, ekip yönetimi, eşleşme onayı.
- Tarama başlatmak ya da yenilemek; veri yalnız zamanlanmış turlarla tazelenir.
- Hareketleri okundu işaretlemek.
- Başka bir çalışma alanının verisine erişmek; anahtar tek çalışma alanına bağlıdır.
- Sosyal hesap verisi okumak; yeni paylaşımlar yalnız adversee_list_events'te sosyal_paylasim_yeni olarak gelir.
- Geçmişe dönük veri: banner sıra geçmişi ve bildirimlerin tek tek alım zamanları 06.10.2026'dan, kampanya geçmişi takip başladığından itibarendir.
- Panel ekran görüntüleri, sayfa anlık görüntülerinin tam HTML'i ve kampanya görselleri; banner ve reklam görselleri ise adversee_get_image ile alınabilir.
- Toplu (batch) istek; her araç çağrısı ayrı istektir.