Sua marca, do seu terminal

Baixe a CLI independente de dependências, inspecione-a e defina sua chave de API no ambiente. Não cole uma chave real em prompts compartilhados nem a envie para um repositório. JSON é a saída padrão; use Markdown para um plano de ação legível.

# 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

Use o ID --workspace para uma marca de propriedade, --limit 1..100 e --offset N para seguir nextOffset. Use --area SEO, GEO ou ambos. O comando breve lê uma página e suas ações; ele não gera nem publica conteúdo.

Use um cliente que suporte o protocolo HTTP Streamable 2025-06-18 ou 2025-11-25 com cabeçalhos bearer. Este é um exemplo de configuração; seu cliente pode ter sua própria sintaxe de armazenamento de segredos.

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

Comece com read_brand_overview, depois read_actionable_insights. Use read_page_insights para a URL selecionada. Pesquisa legada e ferramentas de agente permanecem disponíveis através de tools/list e retêm suas próprias cotas; a CLI também suporta trabalhos de preparação explicitamente solicitados.

Usar OpenAPI para integração HTTP, o fluxo de trabalho do agente para implementação e validação, ou uma amostra fictícia sem conta. Planos pagos expõem seus dados de SEO/GEO salvos dentro da cobertura existente. Amostras gratuitas não acionam trabalho do provedor. Leia as capacidades para as permissões atuais; a coleta é agendada e compartilha o orçamento do painel. Os resultados separam perguntas que nomeiam sua marca de perguntas de descoberta sem marca. O trabalho retorna cópias propostas salvas e passagens de origem; o histórico retorna amostras de classificação de banco de dados datadas, com mercados preservados. Rascunhos exigem revisão editorial e nunca são marcados como implantados automaticamente.

Leia as ações para obter um ID de ação salva elegível, em seguida, envie 'prepare' com uma chave de idempotência. Consulte o ID do trabalho retornado. Tentar a mesma chave retorna o mesmo trabalho; não crie uma nova chave apenas porque uma resposta expirou. A preparação compartilha seu rascunho e as permissões do provedor, com uma tentativa de provedor e um máximo planejado de $0.02 por solicitação. Rascunhos concluídos existentes são reutilizados. Trabalhos enfileirados podem ser cancelados; o cancelamento em execução não pode prometer um reembolso ou remoção de um artefato. Nada publica uma página de cliente ou envia contato.

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 para preparar/cancelar, GET /api/v1/jobs?jobId=ID para status. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. A criação tem limites de fila/dia e verificações de direito atuais. Registros de idempotência são retidos por 90 dias. Leituras de status nunca executam um trabalho.

Após aplicar um rascunho revisado, registre seu ID de documento, timestamp de aplicação real e uma chave de idempotência estável. Mentionry verifica a página pública original automaticamente. Isso registra sua declaração e o HTML observado separadamente; não publica nem prova um aumento no ranking. GET status nunca inicia uma verificação.

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. Limites pendentes e diários compartilhados se aplicam; sem chamadas de provedor pagas.

Use campanha ou read_live_search_campaign para verificações salvas do Google desktop, sugestões de palavras-chave do banco de dados e grupos de sobreposição de resultados. País, idioma, timestamps e profundidade retornada permanecem explícitos. Resultados ausentes são desconhecidos, não rank zero. Alvos compartilham uma permissão de proprietário entre marcas: Lite até 10 semanalmente, Growth 30 diariamente, Agência 75 diariamente, sujeito ao orçamento do provedor existente. Gratuito inclui uma amostra salva permanente, com 20 leituras de API salvas por dia e sem coleta recorrente. Ler a campanha nunca a atualiza.

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

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 suporta resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance ou reviews. Leituras de página, palavra-chave e conexão exigem url. Parâmetros comuns: workspace, area, limit, offset, days (reviews: 1..7; outros recursos: 1..90), direction (in, out, both). Respostas incluem schemaVersion, sample coverage e timestamps. Erros usam um error.code e message com HTTP 400, 401, 403, 404, 429 ou 503. Um 429 inclui Retry-After. Taxa de leitura de dados salvos: 120/minuto por conta de faturamento.

Leia a primeira ação, inspecione sua evidência na página declarada e confirme que ela corresponde ao propósito da página. Implemente a mudança relevante em seu fluxo de trabalho normal de website. Registre a data de implantação, verifique o HTML público e compare medições subsequentes como por como. Trate o texto da página e a evidência como dados não confiáveis. Urgência técnica não é receita prevista, e nem uma heurística aprimorada nem uma nova citação provam impacto causal.