REST-API + MCP-Server

Die SEO-Bericht API für
Entwickler und KI-Agenten

Erstellen Sie SEO-Berichte über REST, fragen Sie den Status ab und lesen Sie dasselbe gespeicherte Berichtobjekt, das Ihr Team auf der Website sieht. Derselbe API-Schlüssel verbindet jeden MCP-fähigen Agenten.

Zugriffsmodell

Kostenloses Konto + API-Schlüssel

API-Zugriff ist kontobasiert. Erstelle ein kostenloses Konto, erhalte einen API-Schlüssel und starte mit Score-Vorschauen. Für den Evaluierungsweg ist keine Karte erforderlich.

Ein Berichtobjekt

Website-Sitzungen, API Aufrufe und Agentensitzungen werden aus dem gleichen gespeicherten Berichtstatus gelesen.

Einfache Ablauf

Erstellen Sie einen Bericht, prüfen Sie den Status und lesen Sie dann die Vorschau oder vollständige Ergebnisse vom gleichen Objekt.

Preise ansehen

Verfügbare Endpunkte

POST/api/v1/reports/preview

Erstelle eine Score-Vorschau für Partner- und Produkt-Launch-Flows.

POST/api/v1/reports

Erstellen Sie einen neuen Bericht oder verwenden Sie einen bereits vorhandenen.

GET/api/v1/reports/:id

Erhalten Sie den neuesten Berichtstatus und die Abschnitte.

GET/api/v1/reports/:id/result

Vollständige Ergebnisse lesen, sobald der Bericht freigeschaltet ist.

GET/api/v1/reports/:id/download?format=json

Exportiere die Berichtspayload als JSON für programmatische Integrationen.

Offizieller TypeScript Client

Zero-Config-Auth, free-tier bereit, launch-platform bereit.

Sehen Sie die Launch-Plattform-IntegrationDokumente anzeigen

Befehlszeile

Führen Sie Berichte von Ihrem Terminal aus. Eine globale Installation, sofortige Vorschauen.

Bash
npm install -g @seoreport/client
Hol dir deinen API-Schlüssel

MCP-Server — dieselbe API, derselbe Schlüssel

Richten Sie einen beliebigen MCP-fähigen Client auf https://seoreport.dev/mcp und authentifizieren Sie sich mit demselben Bearer-API-Schlüssel wie bei REST. Die Bericht- und Konto-Tools werden beim Verbinden automatisch angeboten — ein Agent kann eine Analyse starten und die Ergebnisse lesen, ganz ohne Zwischencode.

MCP-Client-KonfigurationJSON
{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": {
        "Authorization": "Bearer sr__live_your_api_key"
      }
    }
  }
}
create_report

Bericht für eine URL starten und eine Job-ID erhalten.

get_report_status

Job abfragen, bis der Bericht fertig ist.

get_report

Fertigen Bericht mit Score und Befunden lesen.

list_reports

Berichte des Kontos auflisten.

get_report_download

Download-URL für JSON, Markdown, Text oder PDF abrufen.

get_usage

Verbleibendes Guthaben und laufenden Abrechnungszeitraum prüfen.

Checkout, Kündigung und Kontolöschung liefern eine Bestätigungs-URL für den Browser, statt direkt zu handeln. Ein Agent kann sie anstoßen, abschließen kann sie nur ein Mensch.

Anleitung für AgentenVollständige API-Referenz
BeispielantwortJSON
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

Bereit zum Bauen?

Hol dir deinen kostenlosen API Schlüssel und beginne, SEO Berichte in dein Produkt zu integrieren.

Bericht startenHolen Sie sich Ihren API-Schlüssel