yanıt.
Dokümantasyon

Yanıt’ı en iyi şekilde kullanın.

Kurulum, skor yöntemi, ücretsiz araç uçları ve Public API. Public API yayında; webhooks ve veri export yakında.

Hızlı başlangıç

5 dakikada kayıt, kurulum ve ilk panel.

Skorlar ve yöntem

Görünürlük, Share of Voice, pozisyon, site araçlarının 0–100 skoru; sınırlamalar.

Kavramlar

Alias eşleşmesi, atıf, sahipsiz soru, hazırlık skoru.

En iyi pratikler

Etkili soru yazımı, alias ve rakip seçimi, trend okuma.

Ücretsiz araç uçları

Hesap gerektirmeyen /api/tools/* uçları: girdi, çıktı, sınırlar.

Public API

v1 — salt-okunur görünürlük verisi, Bearer token, 60 istek/dk.

yakında

Webhooks

Olay tabanlı entegrasyonlar — planlanıyor, henüz yok.

yakında

Veri export

CSV, Google Sheets ve Looker Studio bağlantısı — planlanıyor; bugün Public API kullanın.

Hızlı başlangıç

5 dakikada başlangıç.

01

Hesap oluşturun

/register adresine gidin. E-posta, şifre, şirket adı yeterli. Kart gerekmez; 14 gün boyunca tüm özellikler açık.

02

Kurulum (3 adım)

1) Marka adınızı + 3–5 alternatif yazımı (alias) girin. 2) 3–5 rakip ekleyin. 3) Sektörünüzü seçin; önerilen soruların 3–5’ini alın ya da kendi müşteri sorularınızı yazın. Süre: ~2 dakika. Kurulum bitince siteniz otomatik taranır.

03

İlk soruyu ekleyin

Panelde “Sorular” sekmesi. Müşterilerinizin satın almadan önce sorabileceği soruları yazın; örn. “Restoranlar için en iyi POS yazılımı”. “Şimdi çalıştır” ile 10–20 saniyede üç modelin cevabını görürsünüz.

04

Paneli okuyun

Görünürlük = soruların yüzde kaçında markanız geçti. Share of Voice = sizin + rakiplerin toplam bahsi içinde payınız. Trend = son 30 günde değişim. Modele göre = ChatGPT / Claude / Gemini kırılımı. Görünürlük boşluğu = rakip var, siz yoksunuz.

Skorlar ve yöntem

Her skorun formülü burada.

Açıklamasız 0–100 sahte kesinliktir. Panel, Public API, haftalık rapor ve uyarılar aynı fonksiyonları kullanır; farklı yüzeylerde farklı sonuç çıkmaz. Kaynak: packages/shared/src/metrics.ts ve docs/METRICS.md.

Görünürlük (visibility)

kendi markanın en az bir kez geçtiği SUCCESS çalıştırma sayısı
÷ SUCCESS çalıştırma sayısı × 100

Bir çalıştırma = bir soru × bir model × bir gün. Markanız aynı cevapta birden çok kez geçse de o çalıştırma bir kez sayılır. Hatalı (ERROR) çalıştırmalar paydaya girmez; ayrıca raporlanır. Paydası sıfırsa skor 0.

Share of Voice

kendi marka bahis sayısı
÷ (kendi + rakip bahis sayısı) × 100

Çalıştırma başına marka başına en fazla 1 bahis. Yalnızca panelde tanımlı rakipler hesaba girer; tanımlamadığınız marka “rakip” sayılmaz.

Pozisyon ve öneri oranı

Pozisyon: cevapta tanınan markaların (kendi + rakipler) ilk geçiş sırası; 1 en iyi. Ortalama pozisyon yalnızca markanızın geçtiği çalıştırmalar üzerinden hesaplanır. Öneri oranı: kendi bahislerinin yüzde kaçı “önerildi” bağlamında.

Site araçları (0–100)

eksen skoru = kazanılan / mümkün × 100
toplam = Σ(eksen skoru × eksen ağırlığı) / Σ ağırlık

Her kontrol geç (1) / uyar (0,5) / kal (0) üretir; yalnızca uygulanabilen kontroller sayılır. Deterministik, crawl-only: aynı girdi, aynı skor. LLM yok, JavaScript render yok. Skorun altında kontrol sayısı, tarih ve “hazırlık ölçer, AI davranışını değil” notu yazar. Eksen ağırlıkları docs/COMMERCE_SCORING.md’de.

Sınırlamalar (okuyun)
  • Yapay zekâ cevapları oturumdan oturuma değişir; tek sorguya hüküm bağlamayın, seriye bakın.
  • Site araçları hazırlığı ölçer; “ChatGPT sizi önerecek” anlamına gelmez.
  • JavaScript ile render edilen içerik ham HTML’de görünmeyebilir: hata değil, uyarı.
  • Çoklu H1, llms.txt yokluğu, X-XSS-Protection eksikliği gibi tartışmalı kontroller düşük ağırlıklı uyarıdır.
  • Hız verisi (PSI/CrUX) yoktur.
  • Yalnızca herkese açık web sitenizi tarıyoruz; kişisel verinizi yapay zekâ servislerine göndermiyoruz.
Kavramlar

Tespit nasıl çalışır?

Alias eşleşmesi

Marka adı ve alternatif yazımları cevap metninde kelime sınırlarıyla, Türkçe büyük/küçük harf duyarsız (İ/i, I/ı), NFC normalize aranır. Kesme işaretli ekler (“Acme’nin”) bahsi bozmaz; iç içe adlarda en uzun eşleşme kazanır. Deterministiktir; LLM yorumu yoktur.

Sentiment

Heuristik + LLM sınıflandırma; sağlayıcı anahtarı yoksa yalnızca heuristik. Skor: POZİTİF 100 / NÖTR 50 / NEGATİF 0. Beta olduğu için tek başına karar metriği değil, bağlam cümlesiyle birlikte okuyun.

En iyi pratikler

Doğru soru, doğru rakip, doğru okuma.

Hangi soruları izlemeli?

Alıcı niyeti taşıyan, marka içermeyen sorular: “KOBİ için en iyi CRM”, “İstanbul’da güvenilir saç ekimi kliniği”. “Acme iyi mi?” izlemek anlamsızdır; markanız zaten geçer. Sektör sayfalarındaki 5 soru iyi bir başlangıçtır.

Etkili alias listesi

Ana ad, kısaltma, alan adı, birleşik/ayrık yazımlar, eski marka adı. Çok genel kelimeleri (ör. “Yanıt”) tek başına eklemeyin; yanlış pozitif üretir.

Rakip seçimi

Müşterinin sizinle kıyasladığı 3–5 marka; pazar payı en büyük değil, aynı soruda çıkanlar. Rakip kıyas aracı ile toplantıda hızlıca doğrulayabilirsiniz.

Trend yorumlama

Tek günlük dalgalanma normaldir; cevaplar oturumdan oturuma değişir. 7 ve 30 günlük ortalamaya bakın; düşüş uyarısı bu yüzden tek güne değil seriye bağlıdır.

Ücretsiz araç uçları

/api/tools/* — hesap yok, e-posta yok.

Ücretsiz araçların arkasındaki uçlar herkese açıktır ve JSON döner. Kayıtsız kullanımda IP başına saatlik sınır ve küresel tavan vardır; 429’da Retry-After başlığı bekleme süresini verir. Yalnızca http/https ve herkese açık adresler; özel ağ adresleri 400 döner. Sonuçlar önbelleğe alınabilir: yeni site araçlarında 24 saate, eski araçlarda 10 dakikaya kadar.

Gövde (JSON)Ne döner / sınır
POST /api/tools/geo-audit{ url }GEO hazırlık denetimi: 5 eksen, 0–100, bulgular. IP başına 10/saat.
POST /api/tools/rank-check{ brand, prompt, provider: OPENAI|ANTHROPIC|GOOGLE }Tek soruda markanız anıldı mı, kaçıncı sırada, yerine kim önerildi. IP başına 8/saat; sağlayıcı yoksa 503.
POST /api/tools/ecommerce-visibility{ url }Mağaza AI görünürlük testi (6 eksen, 25 sn bütçe).
POST /api/tools/product-page{ url }Ürün sayfası testi: Product şeması, içerik, crawler erişimi.
POST /api/tools/ai-crawler{ url }AI crawler erişim testi: robots.txt, llms.txt, meta robots.
POST /api/tools/agency-preanalysis{ domains: string[] (≤3) }Ajans ön-analizi: skor + platform + 3 bulgu. IP başına 3/saat.
POST /api/tools/platform-detect{ url }E-ticaret platformu tespiti (Shopify, ikas, Ticimax…).

// Yeni site araçları (SEO karnesi, WhatsApp önizleme, güvenlik başlıkları, yönlendirme zinciri, kırık link, robots/sitemap, hreflang, şema denetimi, satın alma sorusu kapsama, güven sinyalleri, rakip kıyas) aynı kurallarla /api/tools/site/<araç> altında yayımlanır; tam liste /docs/api#tools.