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.
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 30Nutzen 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_IDHTTP: 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_IDHTTP: /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/pageGespeicherte-Daten-Tools
| MCP-Tool | Was es zurückgibt |
|---|---|
| read_latest_answer_reviews | Neueste 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_performance | Gespeicherte 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_campaign | Gespeicherte 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_actions | Gespeicherte 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_history | Gespeicherte Keyword-Positionen nach Momentaufnahme, URL und Markt. Indizierte Datenbankstichproben, keine Live-Rank-Kampagne; fehlende Beobachtungen sind unbekannt. |
| read_prepared_page_changes | Gespeicherte 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_capabilities | Entdecken Sie gespeicherte Ressourcen, Planabdeckung, gemeinsame Sammlungslimits, Protokolllinks und Beispiel-Workflow ohne Provider-Ausgaben. |
| read_brand_overview | Gespeicherte Markenabdeckung und nächste SEO/GEO-Aktionen; keine kostenpflichtige Sammlung. |
| read_actionable_insights | Priorisierte Seitenaktionen mit Beweisen, Implementierungsschritten, Konfidenz, Limits und Ergebnisverifizierung. |
| read_website_pages | Seiten und Bereitschaft in der berechtigten gespeicherten Website-Map. |
| read_page_insights | Eine gemappte Seite, Keyword-Themen, SEO/GEO-Aktionsplan und interne Verbindungen. |
| read_page_keywords | Alle gesammelten Keyword-Zeilen für eine gemappte Seite, mit lexikalischen Themenlabels; paginiert, keine vollständige Keyword-Entdeckung. |
| read_page_connections | Tatsächliche stichprobenartige eingehende/ausgehende Links mit Ankertext und nofollow-Beweisen. |
| read_brand_results | Gespeicherte 30-Tage-Antwortmaschinen-Sichtbarkeit und Wettbewerber, mit explizitem Nenner und Stichprobenlimits. |
| list_brand_workspaces | Listen 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.