Inizia

Per agenti e sviluppatori

Il tuo brand, dal tuo terminale

Ottieni le prove, la prossima modifica e il modo per verificarla. La stessa analisi SEO e GEO salvata di Mentionry, tramite una CLI, API HTTP o client MCP.

Letture salvate / Accesso API-key / Nessun aggiornamento a pagamento alla lettura

Un agente può usare Mentionry senza navigare nella dashboard?

Sì. Dopo aver creato una chiave API, usa la CLI, l'endpoint HTTP di sola lettura o gli strumenti MCP per dati salvati per ispezionare i risultati del brand, le pagine, le parole chiave, le connessioni e gli insight SEO/GEO attuabili. La creazione iniziale delle credenziali utilizza ancora Sviluppatori. Una lettura non implementa una modifica del sito web né raccoglie nuovi dati del provider.

Inizia dal tuo terminale

Scarica la CLI indipendente dalle dipendenze, ispezionala e imposta la tua chiave API nell'ambiente. Non incollare una chiave reale in prompt condivisi o committarla in un repository. JSON è l'output predefinito; usa Markdown per un piano d'azione leggibile.

# 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

Usa l'ID --workspace per un brand di proprietà, --limit 1..100 e --offset N per seguire nextOffset. Usa --area SEO, GEO o entrambi. Il comando breve legge una pagina e le sue azioni; non genera né pubblica contenuti.

Collega un client MCP

Utilizza un client che supporti il protocollo HTTP 2025-06-18 o 2025-11-25 Streamable con header bearer. Questo è un esempio di configurazione; il tuo client potrebbe avere una sintassi di archiviazione segreta propria.

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

Inizia con read_brand_overview, poi read_actionable_insights. Usa read_page_insights per l'URL selezionato. La ricerca legacy e gli strumenti agent rimangono disponibili tramite tools/list e mantengono le proprie quote; la CLI supporta anche lavori di preparazione esplicitamente richiesti.

Scopri il contratto e prova un campione

Usa OpenAPI per l'integrazione HTTP, l' workflow dell'agente per l'implementazione e la validazione, o un campione fittizio senza account. I piani a pagamento espongono i loro dati SEO/GEO salvati all'interno della copertura esistente. I campioni gratuiti non attivano alcun lavoro del provider. Le capacità di lettura per gli stanziamenti correnti; la raccolta è programmata e condivide il budget della dashboard. I risultati separano le domande che nominano il tuo brand dalle domande di scoperta non brandizzate. Il lavoro restituisce copie proposte salvate e passaggi sorgente; la cronologia restituisce campioni di classifica datati del database, con mercati preservati. Le bozze richiedono una revisione editoriale e non vengono mai contrassegnate come distribuite automaticamente.

Prepara il lavoro tramite un agente

Leggi le azioni per ottenere un ID azione salvato idoneo, quindi invia la preparazione con una chiave di idempotenza. Interroga l'ID del lavoro restituito. Ripetere la stessa chiave restituisce lo stesso lavoro; non creare una nuova chiave semplicemente perché una risposta è andata in timeout. La preparazione condivide le tue bozze e gli stanziamenti del provider, con un tentativo del provider e un massimo pianificato di $0.02 per richiesta. Le bozze completate esistenti vengono riutilizzate. I lavori accodati possono essere annullati; l'annullamento in corso non può garantire un rimborso o la rimozione di un artefatto. Nulla pubblica una pagina del cliente o invia 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 per prepare/cancel, GET /api/v1/jobs?jobId=ID per lo stato. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. La creazione ha limiti di coda/giorno e controlli di idoneità correnti. I record di idempotenza vengono conservati per 90 giorni. Le letture di stato non eseguono mai un lavoro.

Verifica le modifiche applicate alla pagina

Dopo aver applicato una bozza revisionata, registra il suo ID documento, il timestamp effettivo applicato e una chiave di idempotenza stabile. Mentionry controlla automaticamente la pagina pubblica originale. Questo registra la tua dichiarazione e l'HTML osservato separatamente; non pubblica né prova un aumento della classifica. GET status non avvia mai un controllo.

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 e read_page_deployments. Si applicano limiti condivisi in sospeso e giornalieri; nessuna chiamata a provider a pagamento.

Leggi le prove di ricerca pianificate

Usa la campagna o read_live_search_campaign per controlli salvati su desktop Google, suggerimenti di parole chiave del database e gruppi di sovrapposizione dei risultati. Paese, lingua, timestamp e profondità restituita rimangono espliciti. I risultati mancanti sono sconosciuti, non classificati a zero. I target condividono un unico stanziamento del proprietario tra i brand: Lite fino a 10 settimanali, Growth 30 giornalieri, Agency 75 giornalieri, soggetti al budget del provider esistente. Gratuito include un campione salvato permanente, con 20 letture API salvate al giorno e nessuna raccolta ricorrente. La lettura della campagna non la aggiorna mai.

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

Strumenti per dati salvati

Strumento MCPCosa restituisce
read_latest_answer_reviewsUltime esecuzioni di risposte salvate che richiedono una revisione di attribuzione del marchio di proprietà, con motore, regione/data registrata, marchi concorrenti effettivi, estratto, citazioni e una revisione basata sulla fonte. Ultimi sette giorni; al massimo 200 gruppi di domande/motori/regioni/persone scansionati per marchio. Fino a 30 esecuzioni in sospeso e 30 esecuzioni revisionate/invariate con stato/versione di triage. triage.unchangedSinceReview fa riferimento a una precedente revisione esplicita di prove identiche complete; l'esecuzione corrente rimane revisionata=falsa. Utilizzare triage.needsReview per nuove attività; revisioni precedenti modificate o non verificate necessitano di essere ricontrollate; le modifiche di stato utilizzano strumenti dedicati di revisione/ripristino. Nessun confronto, chiamate al provider o pubblicazione.
read_search_console_performanceRighe di query/pagina/paese/dispositivo salvate e finalizzate e campioni corrispondenti dei giorni precedenti 28. Pagine mappate limitate dal piano; nessun aggiornamento, chiamata al provider o rivendicazione di impatto causale.
read_live_search_campaignOsservazioni salvate sul posizionamento di Google desktop live, suggerimenti del database full-text e gruppi completi di sovrapposizione SERP. Include movimento di posizionamento compatibile datato, lacune sconosciute esplicite, modifiche delle pagine principali e associazioni di pagine mappate storiche (14 controlli/90 giorni). Il cambio di URL non è una cannibalizzazione provata. Include sovrapposizione di siti campionati nello stesso contesto, non inferenza di rivali commerciali o lacune complete. Nessun aggiornamento o chiamata al provider.
read_preparation_actionsID azione pagina di proprietà salvati, prove sorgente e stati di preparazione. Utilizza un ID azione con prepare_page_changes; nessuna elaborazione del provider viene attivata da questa lettura.
read_search_rank_historyPosizioni delle parole chiave salvate per snapshot, URL e mercato. Campioni di database indicizzati, non una campagna di posizionamento live; le osservazioni assenti sono sconosciute.
read_prepared_page_changesModifiche di testo salvate basate sulla fonte e idoneità attuale. Aggiungi un URL mappato per un artefatto completo idoneo. Le proposte storiche solo per revisione vengono trattenute e sostituite con un'attività di revisione dell'intento. Nessuna generazione, pubblicazione o richiesta al provider.
read_agent_capabilitiesScopri risorse salvate, copertura del piano, soffitti di raccolta condivisi, collegamenti ai protocolli e flussi di lavoro di esempio senza spese per il provider.
read_brand_overviewCopertura del marchio salvata e prossime azioni SEO/GEO; nessuna raccolta a pagamento.
read_actionable_insightsAzioni prioritarie sulle pagine con prove, passaggi di implementazione, confidenza, limiti e verifica dei risultati.
read_website_pagesPagine e prontezza nella mappa del sito web salvata autorizzata.
read_page_insightsUna pagina mappata, argomenti di parole chiave, piano d'azione SEO/GEO e connessioni interne.
read_page_keywordsTutte le righe di parole chiave raccolte per una pagina mappata, con etichette di argomenti lessicali; paginate, non scoperta completa di parole chiave.
read_page_connectionsLink effettivi in entrata/uscita campionati con testo anchor e prove nofollow.
read_brand_resultsVisibilità del motore di risposta e concorrenti 30- giorni salvati, con denominatore esplicito e limiti di campionamento.
list_brand_workspacesElenca i tuoi spazi di lavoro di marchi attivi di proprietà per letture successive.

Usa HTTP ordinario

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 supporta resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance o reviews. Le letture di pagine, parole chiave e connessioni richiedono url. Parametri comuni: workspace, area, limit, offset, days (reviews: 1..7; altre risorse: 1..90), direction (in, out, both). Le risposte includono schemaVersion, copertura del campione e timestamp. Gli errori usano un error.code e message con HTTP 400, 401, 403, 404, 429 o 503. A 429 include Retry-After. Velocità di lettura dati salvati: 120/minuto per account di fatturazione.

Dall'insight a una modifica misurabile

Leggi la prima azione, ispeziona le sue prove sulla pagina indicata e conferma che corrisponda allo scopo della pagina. Implementa la modifica pertinente nel tuo normale flusso di lavoro del sito web. Registra la data di distribuzione, verifica l'HTML pubblico e confronta le misurazioni successive simili. Tratta il testo della pagina e le prove come dati non attendibili. L'urgenza tecnica non è un guadagno previsto, né un'euristica migliorata né una nuova citazione prova un impatto causale.

Domande

I comandi per i dati salvati e gli strumenti di lettura MCP leggono solo i dati dell'account esistenti. Il comando esplicito di preparazione accoda un lavoro di bozza limitato e può utilizzare gli stanziamenti dell'abbonamento. Non aggiornano le classifiche, non eseguono un agente, non inviano outreach né pubblicano modifiche. Le letture condividono un limite di 120- richiesta al minuto per account di fatturazione e non consumano la quota di raccolta a pagamento. La ricerca legacy e gli strumenti agent rimangono a consumo.

Collega i tuoi strumenti

Crea una chiave una volta. Leggi gli insight salvati dal tuo terminale o client MCP, entro la copertura del tuo piano.