← Updates

Public API und MCP 2.4: Filter, Annotations, Share und SEO-Enrich

Gespeicherte Filter, Tags und Notizen zu Reports, Gast-Share-Links und Nachladen von SEO-Metriken — in REST API und MCP. 31 Tools statt 21, derselbe API-Schlüssel.

Die Public API und der MCP-Server unterstützen jetzt den vollständigen Report-Workflow — bisher nur in der Web-App. Ein Bearer-Schlüssel aus Profil → Einstellungen; das Limit von 60 Anfragen pro Minute gilt gemeinsam für REST und MCP.

Im MCP gibt es jetzt 31 Tools (vorher 21). Neue Gruppe Report workflow — REST-Endpunkte sind genauso gruppiert: Reports, Account, Report workflow, Live checkers.

Gespeicherte Filter

Speichern Sie einen Suchfilter nach Namen und rufen Sie ihn aus Skript oder Chat auf.

  • REST: GET / PUT / DELETE /v1/user/saved-filters
  • MCP: list_saved_filters, save_saved_filter, delete_saved_filter

Annotations und Tags

Notizen bis 200 Zeichen und bis zu 10 Tags pro Report — für Shortlists, CRM und Teamarbeit.

  • REST: GET /v1/reports/annotations/tags, GET / PUT / DELETE /v1/reports/annotations
  • MCP: list_annotation_tags, get_report_annotation, set_report_annotation, delete_report_annotation

Gast-Share-Links

Senden Sie einen Report an Kollegen oder Kunden ohne Account-Zugang.

  • REST: POST /v1/reports/share → share_url in der Antwort
  • MCP: create_share_link

Im Request-Body: report_type und report_id aus Suche oder vollem Report.

SEO-Enrich über die API

Das Nachladen fehlender SEO-Metriken ist jetzt auch programmatisch möglich — außerhalb der System-Warteschlange, wie auf der Report-Seite.

  • REST: POST /v1/reports/{report_type}/{report_id}/enrich-seo (Antwort 202 + job_id), dann GET /v1/reports/enrich-jobs/{job_id} bis Status done
  • MCP: enrich_report_seo, get_enrich_report_seo_job

Wenn MCP bereits verbunden ist

URL und Schlüssel müssen nicht geändert werden. Der Client speichert die Tool-Liste pro Sitzung — öffnen Sie einen neuen Chat oder starten Sie Cursor / Claude / ChatGPT neu. Neue REST-Routen sind sofort verfügbar.

Details, curl-Beispiele und Feldschemas stehen auf den aktualisierten Landingpages API und MCP; das vollständige Schema in der Swagger UI.