Yapay zekâ ve API

Verinizi yapay zekâ asistanlarına ve kendi araçlarınıza güvenle açın

LLMsTrack, Search Console arşivinizi iki salt-okunur yolla sunar: yapay zekâ asistanları için bir MCP sunucusu ve uygulamalarınız için bir REST API. İkisi aynı rapor katmanını kullanır ve aynı sonuçları döner.

MCP sunucusu
REST API
Erişim güvenliği

MCP sunucusu

Asistanınız Search Console verinize doğrudan bağlansın

Model Context Protocol (MCP), yapay zekâ asistanlarının dış veri kaynaklarına ve araçlara standart bir yolla bağlanmasını sağlayan açık bir protokoldür. LLMsTrack'in MCP sunucusu sayesinde Claude gibi MCP destekleyen bir asistan, yetki verdiğiniz mülklerin verisini kendisi sorgular; siz yalnızca sorunuzu yazarsınız.

Sunucu, verinin nasıl okunacağını da asistana anlatır: günlerin Pasifik saatine göre olduğunu, en güncel kesin günün yaklaşık üç gün önce olduğunu, toplamların veri türleri arasında farklı olabileceğini ve işe mülk listesiyle başlanması gerektiğini. Böylece yanıtlar doğru yorumlanır.

Sunucu adresi: https://panel.llmstrack.com/mcp
Aktarım: Streamable HTTP (JSON-RPC 2.0), durumsuz
Kimlik doğrulama: Authorization: Bearer <token>
Yetki: Bütün araçlar salt okunurdur (readOnlyHint)

Yapay zekâ asistanıMCP · LLMsTrack

Siz

blog.ornek.com'un son 28 gününü geçen yılın aynı dönemiyle karşılaştırır mısın?

list_propertiessalt okunur

get_summarysalt okunurcompare: year

Asistan

Geçen yılın aynı 28 gününe göre:

Ölçü	Değişim
Tıklama	+%18
Gösterim	+%9
Ortalama konum	6,2 → 5,4

Not: Veriler kesinleşmiş günlere göredir; en güncel gün yaklaşık üç gün öncesidir.

Temsili örnek; gerçek veri içermez.

MCP araçları

Araç	Ne yapar	Başlıca girdiler
`list_properties`	Erişebildiğiniz mülkleri listeler; asistan işe bununla başlar.	—
`get_summary`	Mülk özeti: toplamlar, günlük seri ve isteğe bağlı karşılaştırma.	`property_id`, `start_date`, `end_date`, `compare`
`top_queries`	En iyi sorgular; filtre, sıralama ve sayfalama.	`property_id`, tarih aralığı, `limit`, `sort`, `query_contains`
`top_pages`	En iyi sayfalar; adres filtreleriyle.	`property_id`, tarih aralığı, `url_contains`
`top_query_pages`	Sorgu–sayfa eşleşmeleri.	`property_id`, tarih aralığı, sorgu ve adres filtreleri
`query_detail`	Tek bir sorgunun günlük seyri ve en çok tıklanan 100 sayfası.	`property_id`, `query`, tarih aralığı
`page_detail`	Tek bir sayfanın günlük seyri ve en çok tıklanan 100 sorgusu.	`property_id`, `url`, tarih aralığı
`compare_periods`	Sorgu ya da sayfa bazında iki dönemi karşılaştırır.	`property_id`, `dataset`, tarih aralığı, `compare`

Bağlantı örnekleri

Claude Code ile bağlanmabash

claude mcp add --transport http llmstrack \
  https://panel.llmstrack.com/mcp \
  --header "Authorization: Bearer $LLMSTRACK_TOKEN"

Proje yapılandırması (.mcp.json)json

{
  "mcpServers": {
    "llmstrack": {
      "type": "http",
      "url": "https://panel.llmstrack.com/mcp",
      "headers": {
        "Authorization": "Bearer ${LLMSTRACK_TOKEN}"
      }
    }
  }
}

Başka bir MCP istemcisi kullanıyorsanız sunucu adresini, Streamable HTTP aktarımını ve Authorization başlığını tanımlamanız yeterlidir. Bağlantıyı istemci olmadan da sınayabilirsiniz:

Araç listesini doğrudan isteme (JSON-RPC)bash

curl -s https://panel.llmstrack.com/mcp \
  -H "Authorization: Bearer $LLMSTRACK_TOKEN" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

REST API

Kendi araçlarınız için sade bir JSON API

Raporların tamamı /api/v1 altında, token ile korunan salt-okunur uçlar olarak sunulur. Yanıtlar data ve meta alanlarından oluşur; meta.note verinin nasıl yorumlanacağını belirtir.

Taban adres: https://panel.llmstrack.com/api/v1
Kimlik doğrulama: Authorization: Bearer <token>
Biçim: JSON; tarihler YYYY-MM-DD, günler Pasifik saatine göre
Hız sınırı: İstemci başına dakikada 60 istek (REST ve MCP birlikte)

Uçlar

Uç	Açıklama
`GET /properties`	Kapsamdaki aktif mülkler
`GET /properties/{id}/summary`	Mülk özeti; isteğe bağlı `compare=previous` veya `year`
`GET /properties/{id}/queries`	Sorgular; `query_contains`, `query_not_contains`
`GET /properties/{id}/pages`	Sayfalar; `url_contains`, `url_not_contains`
`GET /properties/{id}/query-pages`	Sorgu–sayfa eşleşmeleri; dört metin filtresi
`GET /properties/{id}/query-detail`	Tek sorgu: toplamlar, günlük seri, en çok tıklanan 100 sayfa
`GET /properties/{id}/page-detail`	Tek sayfa: toplamlar, günlük seri, en çok tıklanan 100 sorgu
`GET /properties/{id}/compare`	Dönem karşılaştırma; `dataset=query` veya `page`

Örnek istekbash

curl -s -G "https://panel.llmstrack.com/api/v1/properties/3/queries" \
  -d start_date=2026-09-01 -d end_date=2026-09-30 \
  -d per_page=3 \
  -H "Authorization: Bearer $LLMSTRACK_TOKEN" \
  -H "Accept: application/json"

Örnek yanıtjson

{
  "data": [
    {
      "query": "ornek ürün fiyatı",
      "clicks": 182,
      "impressions": 4210,
      "ctr": 0.0432,
      "position": 5.87
    },
    {
      "query": "ornek kargo takibi",
      "clicks": 96,
      "impressions": 1580,
      "ctr": 0.0608,
      "position": 3.12
    },
    {
      "query": "ornek iade koşulları",
      "clicks": 41,
      "impressions": 930,
      "ctr": 0.0441,
      "position": 6.4
    }
  ],
  "meta": {
    "property_id": 3,
    "dataset": "query",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "page": 1,
    "per_page": 3,
    "has_more": true,
    "data_as_of": "2026-10-16T05:12:44Z",
    "note": "Sorgu raporu anonimleştirilmiş sorguları içermez; toplamı özet toplamından düşük olabilir."
  }
}

Temsili örnek; değerler gerçek veri değildir. ctr 0 ile 1 arasında bir orandır; position gösterime göre ağırlıklı ortalama konumdur.

Ortak liste parametreleri

Parametre	Açıklama
`start_date`, `end_date`	Zorunlu, `YYYY-MM-DD`; aralık en fazla 731 gün
`page`, `per_page`	Sayfa 1'den başlar; sayfa başına 1–500 satır (varsayılan 100)
`sort`, `direction`	`clicks`, `impressions`, `ctr` ya da `position`; `asc` veya `desc`
`data_as_of`	Sonraki sayfalarda ilk yanıttaki değer geri gönderilir

Sayfalama tutarlıdır: veri sayfalar arasında yenilenirse API 409 döner ve istemci ilk sayfadan başlar. Böylece satırlar sessizce tekrarlanmaz ya da atlanmaz.

Hata kodları

Kod	Anlamı
`401`	Token yok, geçersiz, süresi dolmuş ya da istemci iptal edilmiş
`403`	Token'da okuma yetkisi yok ya da istek yapılan IP adresi izinli değil
`404`	Mülk yok ya da istemcinin kapsamında değil
`409`	Veri sayfalar arasında yenilendi; ilk sayfadan başlayın
`422`	Doğrulama hatası
`429`	Hız sınırı aşıldı; `Retry-After` süresi kadar bekleyin

Erişim güvenliği

Her istemci yalnızca izin verdiğiniz kadarını görür

API ve MCP erişimi istemci bazında tanımlanır. Bir yapay zekâ asistanına ya da uygulamaya verdiğiniz token yalnızca seçtiğiniz mülkleri ve izin verdiğiniz adresleri kapsar.

Bir kez gösterilen token

Token, panelde istemci oluşturulurken yalnızca bir kez gösterilir ve sistemde açık metin olarak değil, özet (hash) olarak saklanır.

Mülk kapsamı

Her istemci yalnızca seçilen mülklere erişir. Kapsam dışındaki bir mülk, hiç yokmuş gibi yanıtlanır.

IP kısıtı

İzinli IP listesi tanımlıysa istekler yalnızca bu adreslerden (IPv4, IPv6 ya da CIDR aralığı) kabul edilir.

Hız sınırı

İstemci başına dakikada 60 istek; REST ve MCP birlikte sayılır. Sınır aşılırsa 429 ve Retry-After başlığı döner.

Yenileme ve iptal

Token yenilendiğinde eskisi hemen geçersiz olur. İstemciler iptal edilebilir ve bir bitiş tarihiyle sınırlandırılabilir.

Yalnızca okuma

Bütün uçlar ve MCP araçları salt okunurdur; veri ekleyemez, değiştiremez ya da silemez.

Asistanınıza giden veri: Bir yapay zekâ asistanını bağladığınızda, sorularınızı yanıtlamak için çektiği veriler o asistanın sağlayıcısına iletilir ve o sağlayıcının koşullarına tabidir. LLMsTrack veriyi yalnızca sizin yetkilendirdiğiniz istemciye ve sizin isteğinizle iletir. Ayrıntılar Gizlilik Politikası'nda.

Erken erişim

LLMsTrack'i kendi Search Console verinizle deneyin

Erken erişim döneminde hesapları davetle açıyoruz. Bize kısaca kim olduğunuzu ve LLMsTrack'i nasıl kullanmak istediğinizi yazın.

Erken erişim talep edin

ya da info@llmstrack.com adresine yazın