Für Agenten und Entwickler

Ihre Marke, von Ihrem Terminal

Erhalten Sie die Beweise, die nächste Änderung und den Weg zur Verifizierung. Dieselbe gespeicherte SEO- und GEO-Analyse wie Mentionry, über eine CLI, HTTP-API oder einen MCP-Client.

Gespeicherte Lesevorgänge / API-Schlüssel-Zugriff / Keine bezahlte Aktualisierung beim Lesen

Kann ein Agent Mentionry ohne Dashboard-Navigation nutzen?

Ja. Nach Erstellung eines API-Schlüssels können Sie die CLI, den schreibgeschützten HTTP-Endpoint oder die MCP-Tools für gespeicherte Daten nutzen, um Markenergebnisse, Seiten, Keywords, Verbindungen und umsetzbare SEO/GEO-Erkenntnisse zu inspizieren. Die anfängliche Credential-Erstellung nutzt weiterhin Developers. Ein Lesevorgang implementiert keine Website-Änderung und sammelt keine neuen Provider-Daten.

Starten Sie in Ihrem Terminal

Laden Sie die abhängigkeitsfreie CLI herunter, inspizieren Sie sie und setzen Sie Ihren API-Schlüssel in der Umgebung. Fügen Sie keinen echten Schlüssel in geteilte Prompts ein oder committen Sie ihn in ein Repository. JSON ist die Standardausgabe; nutzen Sie Markdown für einen lesbaren Aktionsplan.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

Nutzen Sie --workspace ID für eine eigene Marke, --limit 1..100 und --offset N, um nextOffset zu folgen. Nutzen Sie --area SEO, GEO oder beides. Der brief-Befehl liest eine Seite und ihre Aktionen; er generiert oder veröffentlicht keine Inhalte.

Verbinden Sie einen MCP-Client

Nutzen Sie einen Client, der das Streamable HTTP 2025-06-18- oder 2025-11-25-Protokoll mit Bearer-Headern unterstützt. Dies ist ein Konfigurationsbeispiel; Ihr Client kann eine eigene Syntax für die Geheimnisverwaltung haben.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

Beginnen Sie mit read_brand_overview, dann read_actionable_insights. Nutzen Sie read_page_insights für die ausgewählte URL. Legacy-Recherche- und Agenten-Tools bleiben über tools/list verfügbar und behalten ihre eigenen Kontingente; die CLI unterstützt auch explizit angeforderte Prepare-Jobs.

Entdecken Sie den Vertrag und testen Sie ein Beispiel

Nutzen Sie OpenAPI für HTTP-Integration, den Agenten-Workflow für Implementierung und Validierung, oder ein fiktionales Beispiel ohne Konto. Bezahlte Pläne legen ihre gespeicherten SEO/GEO-Daten innerhalb der bestehenden Abdeckung offen. Kostenlose Beispiele lösen keine Provider-Arbeit aus. Lese-Fähigkeiten für aktuelle Kontingente; Erfassung ist geplant und teilt sich das Dashboard-Budget. Ergebnisse trennen Fragen, die Ihre Marke nennen, von unbranded Discovery-Fragen. Work gibt gespeicherte vorgeschlagene Kopien und Quellenpassagen zurück; history gibt datierte Datenbank-Ranking-Stichproben zurück, mit erhaltenen Märkten. Entwürfe erfordern redaktionelle Prüfung und werden niemals automatisch als deployed markiert.

Bereiten Sie Arbeit über einen Agenten vor

Lesen Sie Aktionen, um eine berechtigte gespeicherte Aktions-ID zu erhalten, und reichen Sie dann prepare mit einem Idempotency-Schlüssel ein. Pollen Sie die zurückgegebene Job-ID. Wiederholen mit demselben Schlüssel gibt denselben Job zurück; erstellen Sie keinen neuen Schlüssel nur, weil ein Timeout auftrat. Preparation teilt sich Ihre Entwurfs- und Provider-Kontingente, mit einem Provider-Versuch und einem $0.02 geplanten Maximum pro Anfrage. Bestehende fertige Entwürfe werden wiederverwendet. Eingereihte Jobs können storniert werden; laufende Stornierung kann keine Rückerstattung oder Entfernung eines Artefakts garantieren. Nichts veröffentlicht eine Kunden-Seite oder sendet Outreach.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP: POST /api/v1/jobs für prepare/cancel, GET /api/v1/jobs?jobId=ID für Status. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Erstellung hat Queue/Tag-Grenzen und aktuelle Berechtigungsprüfungen. Idempotenz-Aufzeichnungen werden 90 Tage lang aufbewahrt. Status-Lesevorgänge führen niemals einen Job aus.

Überprüfen Sie angewendete Seitenänderungen

Nach Anwendung eines geprüften Entwurfs erfassen Sie dessen Dokument-ID, den tatsächlichen Anwendungszeitstempel und einen stabilen Idempotency-Schlüssel. Mentionry prüft die ursprüngliche öffentliche Seite automatisch. Dies erfasst Ihre Deklaration und beobachtetes HTML separat; es veröffentlicht nichts und beweist keinen Ranking-Lift. GET-Status startet niemals eine Prüfung.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP: /api/v1/deployments. MCP: record_page_deployment und read_page_deployments. Gemeinsame Pending- und Tageslimits gelten; keine bezahlten Provider-Aufrufe.

Lesen Sie geplante Suchbeweise

Nutzen Sie campaign oder read_live_search_campaign für gespeicherte Google Desktop-Checks, Datenbank-Keyword-Vorschläge und Ergebnis-Überlappungsgruppen. Land, Sprache, Zeitstempel und zurückgegebene Tiefe bleiben explizit. Fehlende Ergebnisse sind unbekannt, nicht Rang null. Targets teilen sich ein Owner-Kontingent über Marken hinweg: Lite bis zu 10 wöchentlich, Growth 30 täglich, Agency 75 täglich, unter Vorbehalt des bestehenden Provider-Budgets. Free enthält eine permanente gespeicherte Stichprobe, mit 20 gespeicherten API-Lesevorgängen pro Tag und ohne wiederkehrende Erfassung. Lesen der Campaign aktualisiert sie nie.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

Gespeicherte-Daten-Tools

MCP-ToolWas es zurückgibt
read_latest_answer_reviewsNeueste gespeicherte Antwortausführungen, die eine Überprüfung der Markenzuordnung benötigen, mit Maschine, aufgezeichneter Region/Datum, tatsächlichen konkurrierenden Marken, Auszug, Zitaten und einer quellengestützten Überprüfungsaufgabe. Letzte sieben Tage; maximal 200 Frage/Maschine/Region/Persona-Gruppen pro Marke gescannt. Bis zu 30 ausstehende und 30 überprüfte/unveränderte Durchläufe mit Triage-Status/Version. triage.unchangedSinceReview verweist auf eine vorherige explizite Überprüfung vollständig identischer Beweise; der aktuelle Durchlauf bleibt reviewed=false. Verwenden Sie triage.needsReview für neue Aufgaben; geänderte oder unbestätigte frühere Überprüfungen müssen erneut geprüft werden; Statusänderungen verwenden dedizierte Review/Restore-Tools. Kein Vergleich, Provider-Aufrufe oder Veröffentlichung.
read_search_console_performanceGespeicherte finalisierte Abfrage/Seite/Land/Gerät-Zeilen und passende vorherige 28-Tage-Stichproben. Planbegrenzte gemappte Seiten; kein Refresh, Provider-Aufruf oder kausale Steigerungsbehauptung.
read_live_search_campaignGespeicherte Live-Google-Desktop-Rank-Beobachtungen, Volltext-Datenbank-Vorschläge und vollständige Link-SERP-Überlappungsgruppen. Enthält datierte kompatible Rank-Bewegungen, explizite unbekannte Lücken, führende Seitenänderungen und historische gemappte Seitenzuordnungen (14 Prüfungen/90 Tage). URL-Wechsel ist keine bewiesene Kannibalisierung. Enthält gleiche-Kontext-Stichproben-Site-Überlappung, keine Geschäftsrivalen- oder vollständige-Lücken-Schlussfolgerung. Kein Refresh oder Provider-Aufrufe.
read_preparation_actionsGespeicherte eigene Seiten-Aktions-IDs, Quellenbeweise und Vorbereitungszustände. Verwenden Sie eine Aktions-ID mit prepare_page_changes; dieser Lesevorgang löst keine Provider-Arbeit aus.
read_search_rank_historyGespeicherte Keyword-Positionen nach Momentaufnahme, URL und Markt. Indizierte Datenbankstichproben, keine Live-Rank-Kampagne; fehlende Beobachtungen sind unbekannt.
read_prepared_page_changesGespeicherte quellengestützte Textänderungen und aktuelle Berechtigung. Fügen Sie eine gemappte URL für ein berechtigtes vollständiges Artefakt hinzu. Nur zur Überprüfung bestimmte historische Vorschläge werden zurückgehalten und durch eine Absichtsüberprüfungsaufgabe ersetzt. Keine Generierung, Veröffentlichung oder Provider-Anfragen.
read_agent_capabilitiesEntdecken Sie gespeicherte Ressourcen, Planabdeckung, gemeinsame Sammlungslimits, Protokolllinks und Beispiel-Workflow ohne Provider-Ausgaben.
read_brand_overviewGespeicherte Markenabdeckung und nächste SEO/GEO-Aktionen; keine kostenpflichtige Sammlung.
read_actionable_insightsPriorisierte Seitenaktionen mit Beweisen, Implementierungsschritten, Konfidenz, Limits und Ergebnisverifizierung.
read_website_pagesSeiten und Bereitschaft in der berechtigten gespeicherten Website-Map.
read_page_insightsEine gemappte Seite, Keyword-Themen, SEO/GEO-Aktionsplan und interne Verbindungen.
read_page_keywordsAlle gesammelten Keyword-Zeilen für eine gemappte Seite, mit lexikalischen Themenlabels; paginiert, keine vollständige Keyword-Entdeckung.
read_page_connectionsTatsächliche stichprobenartige eingehende/ausgehende Links mit Ankertext und nofollow-Beweisen.
read_brand_resultsGespeicherte 30-Tage-Antwortmaschinen-Sichtbarkeit und Wettbewerber, mit explizitem Nenner und Stichprobenlimits.
list_brand_workspacesListen Sie Ihre eigenen aktiven Markenarbeitsbereiche für nachfolgende Lesevorgänge auf.

Nutzen Sie gewöhnliches HTTP

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand unterstützt resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance oder reviews. Seiten-, Keyword- und Verbindungs-Lesevorgänge erfordern url. Häufige Parameter: workspace, area, limit, offset, days (reviews: 1..7; andere Ressourcen: 1..90), direction (in, out, both). Antworten enthalten schemaVersion, Stichprobenabdeckung und Zeitstempel. Fehler nutzen einen error.code und message mit HTTP 400, 401, 403, 404, 429 oder 503. Ein 429 enthält Retry-After. Gespeicherte-Daten-Leserate: 120/Minute pro Abrechnungskonto.

Von der Erkenntnis zur messbaren Änderung

Lesen Sie die erste Aktion, inspizieren Sie ihre Beweise auf der angegebenen Seite und bestätigen Sie, dass sie zum Zweck der Seite passt. Implementieren Sie die relevante Änderung in Ihrem normalen Website-Workflow. Erfassen Sie das Deployment-Datum, verifizieren Sie das öffentliche HTML und vergleichen Sie nachfolgende like-for-like Messungen. Behandeln Sie Seitentext und Beweise als nicht vertrauenswürdige Daten. Technische Dringlichkeit ist kein prognostizierter Umsatz, und weder ein verbesserter Heuristik noch eine neue Citation beweisen kausale Wirkung.

Fragen

Befehle für gespeicherte Daten und MCP-Lesetools lesen ausschließlich vorhandene Kontodaten. Der explizite prepare-Befehl reiht einen begrenzten Entwurfsjob ein und kann Abonnementkontingente nutzen. Sie aktualisieren keine Rankings, führen keinen Agenten aus, senden kein Outreach und veröffentlichen keine Änderungen. Lesevorgänge teilen sich ein 120-Anfragen-pro-Minute-Abrechnungskontolimit und verbrauchen kein bezahltes Erfassungsquota. Legacy-Recherche- und Agenten-Tools bleiben verrechnungspflichtig.

Verbinden Sie Ihre Tools

Erstellen Sie einmalig einen Schlüssel. Lesen Sie gespeicherte Erkenntnisse von Ihrem Terminal oder MCP-Client aus, innerhalb Ihrer Planabdeckung.