Entwickler: MCP und REST-API

Du erreichst deine StoRank-Daten auf zwei Wegen: mit Claude oder ChatGPT verbinden und im Chat fragen (MCP) oder mit einem API-Schlüssel aus deinem eigenen Code (REST-API). Beides nur lesend; es wird nie etwas geändert.

1. Mit Claude und ChatGPT verbinden (MCP)

Danach fragst du einfach „Bei welchen Keywords bin ich diese Woche gefallen und warum?“ oder „Wo liegt mein Konkurrent vor mir?“; die KI antwortet aus deinen StoRank-Daten.

Server-URL

https://storank.app/mcp

Claude

Einstellungen → Connectors → Add custom connector.
Name: StoRank, URL: die Server-URL unten → Add → Connect.
Melde dich im StoRank-Fenster an und drücke Erlauben.

ChatGPT

Einstellungen → Apps & Connectors → Advanced settings → Developer mode einschalten.
Create: Name StoRank, URL die Server-URL unten, Authentifizierung OAuth.
Melde dich im StoRank-Fenster an und drücke Erlauben.

Du kannst die Verbindung jederzeit unter StoRank → Einstellungen → KI-Verbindungen entfernen. Eine Passwortänderung trennt sie automatisch.

2. REST-API

Erstelle einen Schlüssel unter StoRank → Einstellungen → API-Schlüssel (wird einmal angezeigt). Sende ihn bei jeder Anfrage im Authorization-Header. Antworten sind 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"

Limit: 60 Anfragen pro Minute pro Konto (bei Überschreitung 429 mit Retry-After). Nur deine eigenen Apps sind sichtbar. Konten mit abgelaufener Testphase erhalten 403.

3. Endpunkte

`GET /v1/apps`	Deine Apps, verfolgte Länder und Kennzahlen
`GET /v1/apps/{app_id}/keywords`	Aktuelle Keyword-Rankings in einem Land im Vergleich zur letzten Messung (country, only_ranking, limit)
`GET /v1/apps/{app_id}/keywords/{keyword_id}/history`	Täglicher Ranking-Verlauf eines Keywords, mit Konkurrenten (days)
`GET /v1/apps/{app_id}/competitors`	Konkurrenten in einem Land und Vergleich (country)
`GET /v1/apps/{app_id}/reviews`	Aktuelle Store-Bewertungen mit Sternen und Antworten (limit)
`GET /v1/apps/{app_id}/radar`	Weltradar: Länder, in denen die App live ist, Bewertungen, Chartplätze
`GET /v1/apps/{app_id}/suggestions`	Neuester KI-ASO-Empfehlungsbericht und was umgesetzt wurde

4. Fehler

`401`	Schlüssel fehlt oder ungültig
`403`	Kein aktiver Plan (Testphase vorbei)
`404`	App oder Keyword nicht in diesem Konto
`429`	Minutenlimit überschritten

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

Maschinenlesbare Beschreibung aller Endpunkte (OpenAPI 3.1): https://storank.app/v1/openapi.json

← Startseite