Entwicklerdokumentation
API-Schlüssel und Berechtigungen
Ein Schlüssel ist der Zugriff einer Person, eingegrenzt auf Websites und Scopes. Machen Sie ihn so klein, wie die Aufgabe es braucht.
Zwei Arten von Schlüsseln
| Schlüssel | Erstellt in | Gilt für | Präfix |
|---|---|---|---|
| Workspace-Schlüssel | Settings → Developer access → New key | alle Websites oder die, die Sie anhaken | mr_ws_… |
| Website-Schlüssel | entsteht, wenn sich das WordPress-Plugin verbindet | eine Website | mr_site_… |
Settings gelten für Ihre eigenen Websites. Für einen Workspace, den jemand mit Ihnen teilt, öffnen Sie dessen Einstellungen über ⋯ an seiner Gruppe in der Websites-Liste (nur wenn Sie sie ändern dürfen). Nutzen Sie einen Workspace-Schlüssel für Ihre eigenen Skripte und Assistenten, und haken Sie nur die Websites an, die er braucht. Beide Arten stehen unter Settings → Developer access mit ihrer letzten Nutzung, damit Sie ungenutzte erkennen. Jeder Schlüssel wird nur einmal angezeigt und ist auf 1.200 Anfragen pro Stunde begrenzt.
Scopes
Wenn Sie einen Schlüssel erstellen oder bearbeiten, listet die App die Scopes unter What it may do, mit der hier gezeigten Bezeichnung.
| Scope | Bezeichnung in der App | Erlaubt |
|---|---|---|
sites:read |
Read website details and scores | Website-Übersicht, Werte und Verlauf, Geschwindigkeitsergebnisse, das Portfolio aller Websites des Schlüssels, Audits |
pages:read |
Read pages and findings | gecrawlte Seiten, Befunde pro Seite und Seitenverlauf |
issues:read |
Read issues and actions | Probleme mit Belegen, KI-Erklärungen, vorgeschlagene Werte, priorisierte Aktionen |
search:read |
Read search performance | Search-Console-Zusammenfassung und Zeilen, Themen, Keywords, Wettbewerber und Keyword-Lücken, Backlinks sowie Outreach-Ziele |
analytics:read |
Read Google Analytics conversions and revenue | Conversions und Umsatz pro Einstiegsseite aus Google Analytics (GA4) der Website |
ai:read |
Read AI visibility and AI readiness | KI-Sichtbarkeit, Antwortlücken, Zugriff von KI-Crawlern, llms.txt und Ergebnisse von Agentic Browsing |
content:write |
Send content and change alerts | wird vom WordPress-Plugin genutzt, um Inhalte zu senden; nicht für Ihre eigenen Skripte |
issues:recheck |
Start rechecks | eine erneute Prüfung einplanen oder die Agentic-Browsing-Prüfung für eine Seite neu ausführen |
audits:run |
Start audits | ein vollständiges Audit starten (Audits lesen braucht sites:read) |
actions:apply |
Apply approved fixes to the website | Änderungen an SEO-Titel, Beschreibung, Canonical oder noindex, llms.txt und Regeln für KI-Crawler genehmigen, geschrieben über den WordPress-Connector; Status und Notiz eines Outreach-Ziels setzen; Wettbewerber auswählen, ausblenden oder hinzufügen |
Der Schlüssel, den das WordPress-Plugin nutzt, hat content:write sowie sites:read und pages:read, damit er auch die Werte dieser Website für die eigenen Bildschirme zurücklesen kann.
Einen Schlüssel ändern
Edit am Schlüssel ändert seinen Namen, seine Scopes und, bei einem Workspace-Schlüssel, seine Websites. Der Schlüssel selbst bleibt gleich, also braucht nichts eine neue Kopie. Ein Website-Schlüssel bleibt bei seiner Website. Ein Schlüssel, den das WordPress-Plugin nutzt, behält seinen Namen und die Scopes, die er braucht. Schlüssel, die erstellt wurden, bevor es einen Scope gab (zum Beispiel ai:read, audits:run oder analytics:read), haben ihn nicht: Fügen Sie ihn mit Edit hinzu.
OAuth-Tokens
Wenn ein MCP-Client Sie anmeldet, statt einen Schlüssel zu nehmen (zum Beispiel ChatGPT), genehmigen Sie seinen Zugriff einmal. Er kann nur diese Scopes anfragen: sites:read, pages:read, issues:read, search:read, analytics:read, ai:read und issues:recheck. Er kann also lesen und erneute Prüfungen einplanen, aber nie Audits starten, Änderungen an Ihrer Website schreiben, Outreach-Ziele ändern oder Wettbewerber ändern (audits:run, actions:apply und content:write werden auf diesem Weg nie vergeben).
Hinter dem Token steht ein Workspace-Schlüssel, benannt nach dem Client, zum Beispiel „ChatGPT (OAuth)“. Er erscheint in derselben Liste unter Settings → Developer access und wird auf dieselbe Weise widerrufen. Zugriffstokens gelten eine Stunde und werden vom Client erneuert; nutzen Sie den Client 30 Tage lang nicht, bittet er Sie, sich erneut anzumelden. Eine Verbindung, die vor analytics:read entstanden ist, hat diesen Scope nicht: Verbinden Sie den Client erneut, um ihn hinzuzufügen.
Widerrufen
Settings → Developer access → Revoke am Schlüssel. Anfragen damit scheitern ab diesem Moment mit 401. Auch der Schlüssel des WordPress-Plugins lässt sich dort widerrufen; das Plugin zeigt dann „getrennt“ und sendet nichts mehr.
Häufige Fragen
Ich habe einen Schlüssel verloren. Kann ich ihn noch einmal sehen?
Nein. MonoRanks speichert nur einen Fingerabdruck. Widerrufen Sie ihn und erstellen Sie einen neuen.
Kann ich einem bestehenden Schlüssel mehr Zugriff geben?
Ja. Edit am Schlüssel ändert Name, Scopes und Websites. Der Schlüssel selbst bleibt gleich, also braucht nichts, das ihn nutzt, eine neue Kopie.
Wer kann Schlüssel erstellen?
Jeder, für die eigenen Websites. In einem geteilten Workspace nur der Inhaber und Mitglieder, die alle Websites sehen. Ein Schlüssel reicht nie weiter, als sein Ersteller sehen kann, und funktioniert nicht mehr, wenn dieser Kundenbetrachter wird oder den Workspace verlässt.