Yalnızca tek bir panelde yaşayan veriye ayda bir bakılır. SOV Tracker aynı sayılara iki kapı açar: raporlama yığınınızı besleyen bir REST API ve Share of Voice verinizi Authorization başlığı destekleyen MCP istemcilerinde tek soru uzağınıza getiren bir MCP sunucusu. Tek anahtar ikisini de açar ve her MCP aracı salt okunurdur.
Uç nokta
https://sovtracker.com/api/mcp (Streamable HTTP)
Authorization: Bearer avt_live_••••••••••••Aynı Bearer anahtarı /api/v1 altındaki REST uç noktalarını da doğrular. Anahtarlar yalnızca oluşturulurken bir kez gösterilir.
Kurulacak bir SDK ya da ayrıca bakımı yapılacak bir entegrasyon yok. Panelde oluşturduğunuz anahtar, işin içindeki tek kimlik bilgisidir.
Anahtarlar panelde Ayarlar bölümünden oluşturulur. Her anahtar avt_live_ ile başlar ve bir okuma izni taşır; MCP sunucusu yalnızca bu izne sahip anahtarları yetkilendirir. API ve MCP erişimi Pro ve üzeri planların parçasıdır.
Herhangi bir MCP istemcisini aşağıdaki uç noktaya yönlendirin. Sunucu Streamable HTTP konuşur ve REST API ile aynı Bearer başlığıyla doğrulanır; yani ayrı bir hesap, ek bir kurulum ya da yönetilecek ikinci bir parola yoktur.
Asistanınıza görünürlüğünüzle ilgili bir soru sorun; ilgili salt okunur aracı çağırıp tahmin yürütmek yerine kendi tarama verinizden yanıtlasın. Aynı veriye betikleriniz de REST API üzerinden ulaşır.
claude mcp add --transport http sovtracker https://sovtracker.com/api/mcp --header "Authorization: Bearer avt_live_••••••••••••"Anahtarı panelde Ayarlar → API bölümünden üretirsiniz. Pro ve üstü planlarda.
Claude Code'da çalıştırın, ardından /mcp ile bağlantıyı kontrol edin. Maskeli örnek yerine kendi anahtarınızı kullanın.
ChatGPT: SOV Tracker Bearer anahtarıyla doğrudan bağlantı henüz doğrulanmadı. Bu örnekler Authorization başlığı gönderebilen istemciler içindir.
Tek veri kümesi üzerinde üç yüzey: asistanınız için araçlar, kodunuz için uç noktalar ve yeni verinin geldiğini sistemlerinize haber veren bir webhook.
Bu sürümdeki her araç salt okunurdur ve anahtarın ait olduğu organizasyona kapsanmıştır. Tarama başlatan bir araç bilinçli olarak yoktur: döngüye giren bir asistan tarama kotanızı yakamaz. Okuma yapısı gereği güvenlidir, bu yüzden bağlantıyı tüm ekibinize verebilirsiniz.
/api/v1 altında dört uç nokta: güncel puan için GET /api/v1/sov, taramaları listelemek için GET /api/v1/scans, kendi kodunuzdan tarama başlatmak için POST /api/v1/scans ve imleçle sayfalanan tarihli ham cevaplar için GET /api/v1/archive. Aynı Bearer anahtarı, JSON yanıtlar.
Bir tarama bittiğinde scan.completed olayı uç noktanıza iletilir; olay adı X-Sovtracker-Event başlığında, gövdenin HMAC-SHA256 imzası ise doğrulayabilmeniz için X-Sovtracker-Signature başlığında gelir. Uç noktalar panelde Ayarlar bölümünden yönetilir.
Liste bunun tamamı: 6 araç, hepsi salt okunur ve hepsi anahtarın ait olduğu organizasyona kapsanmış.
| Araç | Ne döndürür |
|---|---|
| get_visibility_summary | Son tamamlanan tarama: genel Share of Voice puanı, platform bazlı puan, markanın bahsedilip bahsedilmediği ve bir önceki taramaya göre trend. |
| list_keywords | Organizasyonunuzun yapay zeka cevaplarında takip ettiği anahtar kelimeler; durumları (aktif ya da duraklatılmış) ve oluşturulma tarihleriyle. |
| get_scan_results | Bir taramanın satır bazlı sonuçları: platform, anahtar kelime, bahsedilme, SOV puanı, duygu ve bahsedilme konumu; platforma veya anahtar kelimeye göre filtrelenebilir. |
| get_answer_archive | Geçmiş taramalardan tarihli ham yapay zeka cevapları; bir platformun o gün gerçekte ne söylediğini okursunuz. Uzun cevaplar kısaltılır ve imleçle sayfalanır. |
| get_business_card | Verified Entity Store kart durumu: güven puanı, alan grubu bazında tazelik ve faal işletme beyanının tarihi. Buradaki diğer araçlar gibi salt okunur. |
| get_ai_traffic | Son N gündeki yapay zeka araçlarıyla ilişkili insan ziyaretleri; iki ayrı sinyal sınıfında raporlanır: doğrudan yapay zeka yönlendirmesi ve yapay zeka etiketli. Bunlar tek bir yönlendirme sayısına asla toplanmaz. |
Tasarım gereği salt okunur: bu sürümdeki hiçbir araç veri yazmaz ya da tarama başlatmaz; döngüye giren bir asistan tarama kotanızı harcayamaz.
MCP sunucusunda anahtar başına dakikada 60 istek; GET /api/v1/archive için de aynı sınır geçerli. Sınır aşıldığında sessiz bir hata değil, 429 alırsınız.
İkisi tek bir kapıyı paylaşır: Pro ve üzeri planlar. Daha alt bir plana ait anahtar, herhangi bir veriye ulaşmadan önce reddedilir. Aynı anahtar hem REST uç noktalarında hem MCP sunucusunda geçerlidir; Pro planındaysanız ayrıca satın alınacak veya kurulacak bir şey kalmaz.
Hayır. MCP sunucusunun bu sürümü yalnızca okuma araçları sunar ve hiçbir araç tarama tetikleyemez. Bu bilinçli bir maliyet koruması. Taramalar sizin kontrolünüzde kalır: panelden ya da kendi kodunuzdan POST /api/v1/scans ile başlatırsınız; bu uç nokta saatte en fazla 30 tarama başlatmaya izin verir.
MCP sunucusu anahtar başına dakikada 60 isteğe izin verir; GET /api/v1/archive de aynı şekilde dakikada 60 istek uygular. Tarama başlatma ayrıca saatte 30 ile sınırlıdır. Sınırın aşılması sessizce başarısız olmak yerine 429 döndürür, böylece entegrasyonunuz bekleyip yeniden deneyebilir.
Kendi başına, her tarama bittiğinde ve ek bir ayar gerekmeden tetiklenen olay scan.completed. İsteğin gerçekten bizden geldiğini doğrulayabilmeniz için uç nokta gizli anahtarınızla imzalanır. Diğer olaylar uyarı kurallarınıza bağlıdır; tam liste ve gövdeler API referansındadır.
Panelde bir anahtar oluşturun, uç noktayı MCP istemcinize yapıştırın ve ilk sorunuzu sorun. API ve MCP erişimi Pro ve üzeri planların parçasıdır.