API ve MCP

Aynı salt okunur veriye iki kapı: YZ asistanları için MCP, kendi script'leriniz için REST. İkisi de Pro, Stüdyo ve Ajans planlarında kullanılabilir.

MCP — bir YZ asistanı bağlayın

MCP (Model Context Protocol), Claude, ChatGPT, Cursor ve benzeri asistanların Glimana verilerinizi okumasını ve "example.com'da bu hafta neyi düzeltmeliyim?" ya da "görevlerimden hangisinin ölçülmüş bir etkisi oldu?" gibi soruları yanıtlamasını sağlar.

MCP sekmesi: bağlayıcı adresi, giriş akışı ve adresin her uygulamada nereye yapıştırılacağı.

Bağlayıcı adresi https://glimana.com/api/mcp. Dinamik istemci kaydı ve PKCE ile OAuth 2.1 kullanır, bu yüzden anahtar gerekmez: uygulama bir Glimana penceresi açar, giriş yaparsınız (Google ya da e-posta), çalışma alanını seçer ve İzin ver'e tıklarsınız. Bağlantı ardından MCP sekmesinde görünür ve oradan istediğiniz zaman bağlantıyı kesebilirsiniz.

Claude (claude.ai · Desktop)ChatGPTClaude CodeCursor

Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → ad olarak Glimana verin, adresi yapıştırın → Bağlan. Açılan Glimana penceresinde onaylayın.

Ayarlar → Uygulamalar ve Bağlayıcılar → Gelişmiş → Geliştirici modu'nu açın → Oluştur → adresi yapıştırın, kimlik doğrulama OAuth → Bağlan.

claude mcp add --scope user --transport http glimana https://glimana.com/api/mcp

Ardından Claude Code içinde /mcp komutunu çalıştırın ve kimliğinizi doğrulayın. --scope user bağlayıcıyı her projede kullanılabilir yapar.

~/.cursor/mcp.json dosyasına (ya da projenin .cursor/mcp.json dosyasına) ekleyin ve Cursor'ı yeniden başlatın:

{ "mcpServers": { "glimana": { "url": "https://glimana.com/api/mcp" } } }

Asistanın okuyabildikleri

Araç	Döndürdüğü
`list_sites`	Siteleriniz, sağlık skoru ve son tarama.
`get_site_summary`	Son 28 günün Search Console tıklama, gösterim, CTR ve ortalama sıra verisi.
`get_priority_tasks`	Öncelik sırasına göre açık görevler; sebebi ve nasıl yapılacağıyla.
`get_open_issues`	Açık denetim sorunları, etkilenen sayfalar ve çözüm.
`get_impact_results`	Biten görevlerin ölçülmüş 28 günlük tıklama etkisi. `effect_clicks` ölçülen etkidir (değişiklikten sonraki tıklamalardan kontrol grubundan beklenen tıklamalar çıkarılır); yanında `effect_pct`, `expected_clicks`, `z_score` ve `outcome` bulunur. `clicks_change` ve `clicks_change_pct` ham önce/sonra farkıdır.
`get_top_queries`	En çok tıklanan Search Console sorguları.
`get_ai_bot_access`	YZ asistanlarının ve tarayıcıların siteyi okuyup okuyamadığı.

Her şey salt okunurdur: asistan hiçbir şeyi değiştiremez, silemez ya da yayımlayamaz. Sekmedeki Gelişmiş bölümünde OAuth yapamayan istemciler için başlık tabanlı bir anahtar yöntemi vardır; giriş akışını tercih edin.

REST API

API anahtarları: her kullanım için bir tane oluşturun, en son ne zaman kullanıldığını görün, iptal edin.

Hesap ayarları → API → anahtara bir ad verin (örneğin "Raporlama script'i") → API anahtarı oluştur. Anahtar (glm_…) yalnızca bir kez gösterilir; şifre gibi saklayın.
Başlıkta gönderin: Authorization: Bearer glm_…
Türkçe metin alanları için herhangi bir isteğe ?lang=tr ekleyin.

curl -H "Authorization: Bearer glm_…" https://glimana.com/api/v1/sites

Uç nokta	Döndürdüğü
`GET /api/v1/sites`	Çalışma alanındaki siteler.
`GET /api/v1/sites/{site}/summary`	28 günlük Search Console özeti.
`GET /api/v1/sites/{site}/tasks`	Sıralanmış açık görevler.
`GET /api/v1/sites/{site}/issues`	Etkilenen sayfa sayılarıyla açık sorunlar.
`GET /api/v1/sites/{site}/impacts`	Ölçülmüş etki sonuçları; `get_impact_results` ile aynı alanlar (`effect_clicks` kontrole göre düzeltilmiş sayıdır; `clicks_change` ham değerdir).
`GET /api/v1/sites/{site}/queries`	En çok tıklanan sorgular (28 gün).
`GET /api/v1/sites/{site}/ai-access`	YZ bot erişimi sonuçları.

İstek sınırları: Pro'da dakikada 60, Stüdyo'da 120, Ajans'ta 300 istek. Sınır çalışma alanı başınadır: bütün API anahtarları ve oturum açma (OAuth) ile bağlanan bütün uygulamalar aynı kotayı paylaşır. Sınır aşıldığında yanıt 429 olur; Retry-After başlığı ve "Rate limit: N requests per minute." iletisiyle döner (yani dakikada N istek sınırına ulaştınız). Ücretsiz planda her çağrı plan_required ve upgrade_url döndürür. Hatalar: 401 anahtar hatalı ya da eksik, 403 anahtar siteyi kapsamıyor, 404 site bilinmiyor. Anahtarlar çalışma alanındaki her siteyi kapsar ve salt okunurdur. İptal edilen bir anahtar anında geçersiz olur.

Bu sayfa tam başvuru kaynağıdır; yukarıdaki alan adları yanıt şemasıdır.