Geliştiriciler: MCP ve REST API

StoRank'teki kendi verine iki yoldan ulaşırsın: Claude ya da ChatGPT'ye bağlayıp sohbette sorarak (MCP) veya API anahtarıyla kendi kodundan (REST API). İkisi de yalnız okur; hiçbir şeyi değiştirmez.

1. Claude ve ChatGPT'ye bağla (MCP)

Bağladıktan sonra “bu hafta hangi kelimelerde düştüm, neden?” ya da “rakibim hangi kelimelerde benden önde?” diye sorman yeterli; yapay zekâ cevabı senin StoRank verinden çıkarır.

Sunucu adresi

https://storank.app/mcp

Claude

Ayarlar → Connectors → Add custom connector.
Ad: StoRank, adres: aşağıdaki sunucu adresi → Add → Connect.
Açılan StoRank ekranında giriş yap ve İzin Ver'e bas.

ChatGPT

Ayarlar → Apps & Connectors → Advanced settings → Developer mode'u aç.
Create: ad StoRank, adres aşağıdaki sunucu adresi, kimlik doğrulama OAuth.
Açılan StoRank ekranında giriş yap ve İzin Ver'e bas.

Bağlantıyı istediğin an StoRank → Ayarlar → Yapay Zekâ Bağlantıları'ndan kaldırabilirsin. Şifreni değiştirince bağlantılar kendiliğinden kopar.

2. REST API

StoRank → Ayarlar → API Anahtarları'nda bir anahtar oluştur (bir kez gösterilir). Her istekte Authorization başlığıyla gönder. Yanıtlar JSON.

curl -H "Authorization: Bearer srk_YOUR_KEY" https://storank.app/v1/apps

curl -H "Authorization: Bearer srk_YOUR_KEY" "https://storank.app/v1/apps/123/keywords?country=us&only_ranking=true"

Sınır: hesap başına dakikada 60 istek (aşılırsa 429 ve Retry-After). Yalnız kendi uygulamaların görünür. Deneme süresi biten hesapta 403.

3. Uçlar

`GET /v1/apps`	Uygulamaların, takip edilen ülkeler ve özet rakamlar
`GET /v1/apps/{app_id}/keywords`	Bir ülkede son kelime sıraları ve önceki ölçümle fark (country, only_ranking, limit)
`GET /v1/apps/{app_id}/keywords/{keyword_id}/history`	Bir kelimenin günlük sıra geçmişi, rakiplerle (days)
`GET /v1/apps/{app_id}/competitors`	Bir ülkedeki rakipler ve karşılaştırma (country)
`GET /v1/apps/{app_id}/reviews`	Son mağaza yorumları, puan ve yanıtlarla (limit)
`GET /v1/apps/{app_id}/radar`	Dünya radarı: yayında olduğu ülkeler, puanlar, liste yerleri
`GET /v1/apps/{app_id}/suggestions`	Son yapay zekâ ASO öneri raporu ve uygulananlar

4. Hatalar

`401`	Anahtar yok ya da geçersiz
`403`	Aktif plan yok (deneme bitti)
`404`	Uygulama ya da kelime bu hesapta değil
`429`	Dakikalık sınır aşıldı

{"error": {"code": "not_found", "message": "App not found in this StoRank account."}}

Bütün uçların makinece okunur tanımı (OpenAPI 3.1): https://storank.app/v1/openapi.json

← Ana Sayfa