Voor agenten en ontwikkelaars
Uw merk, vanaf uw terminal
Verkrijg het bewijs, de volgende wijziging en de manier om deze te verifiëren. Dezelfde opgeslagen SEO- en GEO-analyse als Mentionry, via een CLI, HTTP API of MCP-client.
Kan een agent Mentionry gebruiken zonder het dashboard te navigeren?
Ja. Na het aanmaken van een API-sleutel, gebruikt u de CLI, het alleen-lezen HTTP-eindpunt of de opgeslagen-gegevens MCP-tools om merkresultaten, pagina's, zoekwoorden, verbindingen en bruikbare SEO/GEO-bevindingen te inspecteren. Initiële aanmaak van referenties gebruikt nog steeds Developers. Een lezing implementeert geen website-wijziging of verzamelt nieuwe providergegevens.
Begin in uw terminal
Download de afhankelijkheidsvrije CLI, inspecteer deze en stel uw API-sleutel in de omgeving in. Plak geen echte sleutel in gedeelde prompts en commit deze niet naar een repository. JSON is de standaarduitvoer; gebruik Markdown voor een leesbaar actieplan.
# 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 30Gebruik --workspace ID voor een eigen merk, --limit 1..100 en --offset N om nextOffset te volgen. Gebruik --area SEO, GEO of beide. Het korte commando leest één pagina en de bijbehorende acties; het genereert of publiceert geen inhoud.
Verbind een MCP-client
Gebruik een client die het Streamable HTTP 2025-06-18 of 2025-11-25 protocol ondersteunt met bearer-headers. Dit is een configuratievoorbeeld; uw client kan zijn eigen syntax voor geheugenopslag hebben.
{
"mcpServers": {
"mentionry": {
"type": "http",
"url": "https://mentionry.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
}
}
}
}Begin met read_brand_overview, daarna read_actionable_insights. Gebruik read_page_insights voor de geselecteerde URL. Oude onderzoeks- en agenttools blijven beschikbaar via tools/list en behouden hun eigen quota's; de CLI ondersteunt ook expliciet aangevraagde voorbereidingsjobs.
Ontdek het contract en probeer een voorbeeld
Gebruik OpenAPI voor HTTP-integratie, de agent workflow voor implementatie en validatie, of een fictief voorbeeld zonder account. Betaalde abonnementen maken hun opgeslagen SEO/GEO-gegevens zichtbaar binnen bestaande dekking. Gratis voorbeelden activeren geen providerwerk. Lees de mogelijkheden voor de huidige toelagen; de verzameling is gepland en deelt het dashboardbudget. Resultaten scheiden vragen die uw merk benoemen van ongemerkte ontdekkingsvragen. Werk retourneert opgeslagen voorgestelde tekst en bronpassages; geschiedenis retourneert gedateerde database-rankingvoorbeelden, met behoud van markten. Concepten vereisen redactionele beoordeling en worden nooit automatisch als 'gepubliceerd' gemarkeerd.
Bereid werk voor via een agent
Lees acties om een in aanmerking komende opgeslagen actie-ID te verkrijgen, dien vervolgens 'prepare' in met een idempotency-sleutel. Poll de geretourneerde job-ID. Het opnieuw proberen van dezelfde sleutel retourneert dezelfde job; maak geen nieuwe sleutel alleen omdat een antwoord is verlopen. Voorbereiding deelt uw concept- en provider-toelagen, met één providerpoging en een gepland maximum van $0.02 per aanvraag. Bestaande voltooide concepten worden hergebruikt. In de wachtrij geplaatste jobs kunnen worden geannuleerd; annulering tijdens uitvoering kan geen restitutie of verwijdering van een artefact garanderen. Niets publiceert een klantpagina of verzendt 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 voor prepare/cancel, GET /api/v1/jobs?jobId=ID voor status. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Creatie heeft wachtrij-/daglimieten en controles van de huidige rechten. Idempotency-records worden bewaard voor 90 dagen. Statuslezingen voeren nooit een job uit.
Toegepaste paginawijzigingen verifiëren
Na het toepassen van een beoordeeld concept, registreer de document-ID, de daadwerkelijke toegepaste tijdstempel en een stabiele idempotency-sleutel. Mentionry controleert automatisch de oorspronkelijke openbare pagina. Dit registreert uw verklaring en waargenomen HTML afzonderlijk; het publiceert of bewijst geen rankingverbetering. GET status start nooit een controle.
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 en read_page_deployments. Gedeelde lopende en dagelijkse limieten zijn van toepassing; geen betaalde provider-aanroepen.
Geplande zoekbewijzen lezen
Gebruik campagne of read_live_search_campaign voor opgeslagen Google desktop-controles, database-zoekwoorduggesties en resultaat-overlapgroepen. Land, taal, tijdstempels en de geretourneerde diepte blijven expliciet. Ontbrekende resultaten zijn onbekend, niet rank nul. Doelen delen één eigenaars-toelage over merken: Lite tot 10 wekelijks, Growth 30 dagelijks, Agency 75 dagelijks, onderhevig aan het bestaande providerbudget. Gratis omvat een permanent opgeslagen voorbeeld, met 20 opgeslagen API-lezingen per dag en geen terugkerende verzameling. Het lezen van de campagne vernieuwt deze nooit.
node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/pageOpgeslagen-data tools
| MCP-tool | Wat het retourneert |
|---|---|
| read_latest_answer_reviews | Laatst opgeslagen antwoorduitvoeringen die een beoordeling van eigen merkattributie vereisen, met engine, opgenomen regio/datum, daadwerkelijke concurrerende merken, uittreksel, citaties en een op bronnen gebaseerde beoordelingstaak. Afgelopen zeven dagen; maximaal 200 vraag/engine/regio/persona-groepen gescand per merk. Tot 30 openstaande en 30 beoordeelde/ongewijzigde uitvoeringen met triage-status/versie. triage.unchangedSinceReview verwijst naar een eerdere expliciete beoordeling van volledig identiek bewijs; de huidige uitvoering blijft beoordeeld=false. Gebruik triage.needsReview voor nieuwe taken; gewijzigde of onverifieerde eerdere beoordelingen moeten opnieuw worden gecontroleerd; statuswijzigingen gebruiken speciale beoordelings-/hersteltools. Geen vergelijking, provider-aanroepen of publicatie. |
| read_search_console_performance | Opgeslagen voltooide query/pagina/land/apparaat-rijen en bijpassende eerdere 28dag-samples. Geplande gemapte pagina's; geen vernieuwing, provider-aanroep of causale liftclaim. |
| read_live_search_campaign | Opgeslagen live Google desktop rank-observaties, volledige tekst database suggesties en SERP-overlapgroepen met volledige links. Inclusief gedateerde compatibele rankbewegingen, expliciete onbekende hiaten, toonaangevende paginawijzigingen en historische gemapte pagina-associaties (14 controles/90 dagen). URL-wisseling is geen bewezen kannibalisatie. Inclusief dezelfde context gesamplede site-overlap, geen zakelijke concurrentie- of volledige gat-inferentie. Geen vernieuwing of provider-aanroepen. |
| read_preparation_actions | Opgeslagen eigen pagina-actie-ID's, bronbewijs en voorbereidingsstatussen. Gebruik een actie-ID met prepare_page_changes; er wordt geen provider-werk getriggerd door dit lezen. |
| read_search_rank_history | Opgeslagen keywordposities per snapshot, URL en markt. Geïndexeerde database-samples, geen live rank-campagne; afwezige observaties zijn onbekend. |
| read_prepared_page_changes | Opgeslagen op bronnen gebaseerde kopijwijzigingen en huidige geschiktheid. Voeg een gemapte URL toe voor een geschikt volledig artefact. Alleen-voor-beoordeling historische voorstellen worden ingehouden en vervangen door een intentie-beoordelingstaak. Geen generatie, publicatie of provider-verzoeken. |
| read_agent_capabilities | Ontdek opgeslagen bronnen, plan dekking, gedeelde collectielimieten, protocolkoppelingen en voorbeeldworkflow zonder provider-uitgaven. |
| read_brand_overview | Opgeslagen merkdekking en volgende SEO/GEO-acties; geen betaalde collectie. |
| read_actionable_insights | Geprioriteerde pagina-acties met bewijs, implementatiestappen, vertrouwen, limieten en uitkomstverificatie. |
| read_website_pages | Pagina's en gereedheid in de geautoriseerde opgeslagen websitekaart. |
| read_page_insights | Eén gemapte pagina, keywordonderwerpen, SEO/GEO-actieplan en interne verbindingen. |
| read_page_keywords | Alle verzamelde keywordrijen voor een gemapte pagina, met lexicale onderwerp-labels; gepagineerd, geen volledige keywordontdekking. |
| read_page_connections | Werkelijke gesamplede inkomende/uitgaande links met ankertekst en nofollow-bewijs. |
| read_brand_results | Opgeslagen 30-dag antwoord-engine zichtbaarheid en concurrenten, met expliciete noemer en samplelimieten. |
| list_brand_workspaces | Lijst uw actieve merkwerkruimtes op voor latere lezingen. |
Gebruik gewone 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 ondersteunt resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance of reviews. Pagina-, trefwoord- en verbindingslezingen vereisen een URL. Gemeenschappelijke parameters: workspace, area, limit, offset, days (reviews: 1..7; andere bronnen: 1..90), direction (in, out, both). Antwoorden bevatten schemaVersion, sample coverage en timestamps. Fouten gebruiken een error.code en message met HTTP 400, 401, 403, 404, 429 of 503. Een 429 bevat Retry-After. Leesfrequentie van opgeslagen data: 120/minuut per factureringsaccount.
Van inzicht naar meetbare verandering
Lees de eerste actie, inspecteer het bewijs ervan op de vermelde pagina en bevestig dat het overeenkomt met het doel van de pagina. Implementeer de relevante wijziging in uw normale website workflow. Registreer de implementatiedatum, verifieer de openbare HTML en vergelijk daaropvolgende gelijke metingen. Behandel paginatekst en bewijs als onbetrouwbare gegevens. Technische urgentie is geen voorspelde omzet, en noch een verbeterde heuristiek noch een nieuwe citatie bewijst causale impact.
Vragen
Opgeslagen-gegevenscommando's en MCP-leestools lezen alleen bestaande accountgegevens. Het expliciete prepare-commando wachtrijt een gebonden concepttaak en kan abonnementslimieten gebruiken. Ze vernieuwen geen rangschikkingen, voeren geen agent uit, sturen geen outreach of publiceren wijzigingen. Lezingen delen een 120-verzoek-per-minuut factureringsaccountlimiet en verbruiken geen betaalde verzamelquotum. Oudere onderzoeks- en agenttools blijven gemeten.
Verbind uw tools
Maak een sleutel eenmalig aan. Lees opgeslagen inzichten vanaf uw terminal of MCP-client, binnen de dekking van uw plan.