Tu marca, desde tu terminal

Descarga la CLI sin dependencias, inspecciónala y establece tu clave API en el entorno. No pegues una clave real en prompts compartidos ni la guardes en un repositorio. JSON es la salida predeterminada; usa Markdown para un plan de acción legible.

# 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 --workspace ID para una marca propia, --limit 1..100 y --offset N para seguir nextOffset. Usa --area SEO, GEO o ambos. El comando brief lee una página y sus acciones; no genera ni publica contenido.

Usa un cliente que admita el protocolo Streamable HTTP 2025-06-18 o 2025-11-25 con encabezados bearer. Este es un ejemplo de configuración; tu cliente puede tener su propia sintaxis de almacenamiento de secretos.

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

Comienza con read_brand_overview, luego read_actionable_insights. Usa read_page_insights para la URL seleccionada. Las herramientas heredadas de investigación y agente siguen disponibles a través de tools/list y conservan sus propias cuotas; la CLI también admite trabajos de preparación solicitados explícitamente.

Usa OpenAPI para integración HTTP, el flujo de trabajo del agente para implementación y validación, o una muestra ficticia sin una cuenta. Los planes de pago exponen sus datos de SEO/GEO guardados dentro de la cobertura existente. Las muestras gratuitas no activan trabajo del proveedor. Capacidades de lectura para las asignaciones actuales; la recopilación está programada y comparte el presupuesto del panel. Los resultados separan preguntas que nombran tu marca de preguntas de descubrimiento sin marca. El trabajo devuelve copia propuesta guardada y pasajes fuente; el historial devuelve muestras de clasificación de base de datos fechadas, con mercados preservados. Los borradores requieren revisión editorial y nunca se marcan como implementados automáticamente.

Lee acciones para obtener un ID de acción guardada elegible, luego envía prepare con una clave de idempotencia. Sondea el ID de trabajo devuelto. Reintentar la misma clave devuelve el mismo trabajo; no crees una nueva clave solo porque una respuesta tardó. La preparación comparte tus asignaciones de borrador y proveedor, con un intento del proveedor y un máximo planificado de $0.02 por solicitud. Los borradores completados existentes se reutilizan. Los trabajos encolados se pueden cancelar; la cancelación en ejecución no puede prometer un reembolso o eliminación de un artefacto. Nada publica una página del cliente ni envía prospección.

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 prepare/cancel, GET /api/v1/jobs?jobId=ID para estado. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. La creación tiene límites de cola/día y verificaciones de derecho actual. Los registros de idempotencia se conservan durante 90 días. Las lecturas de estado nunca ejecutan un trabajo.

Después de aplicar un borrador revisado, registra su ID de documento, la marca de tiempo real de aplicación y una clave de idempotencia estable. Mentionry verifica la página pública original automáticamente. Esto registra tu declaración y el HTML observado por separado; no publica ni prueba mejora de clasificación. GET status nunca inicia una verificación.

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 y read_page_deployments. Se aplican límites pendientes y diarios compartidos; sin llamadas de pago al proveedor.

Usa campaign o read_live_search_campaign para verificaciones guardadas de Google en escritorio, sugerencias de palabras clave de base de datos y grupos de superposición de resultados. País, idioma, marcas de tiempo y profundidad devuelta permanecen explícitos. Los resultados faltantes son desconocidos, no rango cero. Los objetivos comparten una asignación de propietario entre marcas: Lite hasta 10 semanal, Growth 30 diario, Agency 75 diario, sujeto al presupuesto existente del proveedor. Gratis incluye una muestra guardada permanente, con 20 lecturas API guardadas por día y sin recopilación recurrente. Leer la campaña nunca la actualiza.

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 admite resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance o reviews. Las lecturas de page, keyword y connection requieren url. Parámetros comunes: workspace, area, limit, offset, days (reviews: 1..7; otros recursos: 1..90), direction (in, out, both). Las respuestas incluyen schemaVersion, cobertura de muestra y marcas de tiempo. Los errores usan un error.code y message con HTTP 400, 401, 403, 404, 429 o 503. Un 429 incluye Retry-After. Tasa de lectura de datos guardados: 120/minuto por cuenta de facturación.

Lee la primera acción, inspecciona su evidencia en la página indicada y confirma que coincide con el propósito de la página. Implementa el cambio relevante en tu flujo de trabajo normal del sitio web. Registra la fecha de implementación, verifica el HTML público y compara mediciones posteriores equivalentes. Trata el texto de la página y la evidencia como datos no confiables. La urgencia técnica no es ingresos previstos, y ni una heurística mejorada ni una nueva cita prueban impacto causal.