Construye tus propias herramientas de visibilidad en IA. Ahórrate construir el recolector.
Hi, Moose pregunta a los motores de búsqueda con IA cada día, guarda cada respuesta con sus fuentes y mide menciones, citas y competidores. Conecta Claude Code, Codex o Cursor por MCP y deja que tu agente construya sobre esos datos, o llama a la API REST desde la app que entregas.
Qué tiene que existir primero
Hi, Moose devuelve respuestas reales guardadas, así que tiene que haber algo recogido antes de que un agente pueda construir sobre ello. Si eres un agente leyendo esto, repasa estos cuatro puntos con tu usuario antes de empezar.
-
1
Una cuenta de Hi, MooseLa gratuita sirve para MCP. La API REST necesita un plan de pago.Crear una cuenta
-
2
La app de escritorio, instalada y con sesión iniciadaLa recogida se ejecuta en la app, en tu ordenador o en un host que controlas. Para los trabajos MCP tiene que estar abierta y con sesión iniciada. Las lecturas REST se sirven desde la nube y funcionan con la app cerrada.Descargar la app
-
3
Un proyecto con prompts seguidosUn proyecto por marca. Añade los prompts que quieres seguir, elige motores y deja que se complete al menos una ejecución. El historial empieza en la primera ejecución, así que añade los prompts pronto.
-
4
Para la app terminada, una clave de APIEl propietario de la cuenta crea una clave de solo lectura en Ajustes, Claves de API. Vive en HIMOOSE_API_KEY en tu servidor, nunca en el navegador.
Añade Hi, Moose a tu agente de programación
Un comando o una entrada de configuración, y después un inicio de sesión en el navegador. MCP no necesita clave de API, y en el archivo no va nada que un compañero no pudiera subir al repositorio.
Ejecuta esto en tu terminal, luego inicia Claude Code y escribe /mcp. Elige himoose y después Authenticate.
claude mcp add --transport http himoose https://mcp.himoose.com/mcpTu navegador abre el inicio de sesión de Hi, Moose. Añade --scope user para tenerlo disponible en todos los proyectos.
Añade el servidor y luego inicia sesión. La CLI de Codex y la extensión del IDE comparten esta configuración.
codex mcp add himoose --url https://mcp.himoose.com/mcp
codex mcp login himooseEl comando de login abre el inicio de sesión de Hi, Moose en tu navegador.
Añade esto a ~/.cursor/mcp.json, o a .cursor/mcp.json para un solo proyecto.
{
"mcpServers": {
"himoose": { "url": "https://mcp.himoose.com/mcp" }
}
}Después abre Cursor Settings, Tools & MCP, e inicia sesión en Hi, Moose cuando te lo pida.
Cualquier agente que pueda añadir un servidor MCP remoto por HTTPS con inicio de sesión OAuth puede conectarse.
https://mcp.himoose.com/mcpDeja vacío cualquier campo de ID de cliente OAuth. Hi, Moose registra la app durante el inicio de sesión.
list_projects. Si devuelve tu proyecto, estás conectado. Las apps de chat como Claude y ChatGPT se conectan igual; los pasos están en Conecta un agente.Un primer vistazo en una sesión. Solo MCP, así que funciona en el plan gratuito.
Un panel que tu equipo abre en el navegador. MCP mientras construyes, API REST en la app terminada. La API REST necesita un plan de pago.
Enséñale Hi, Moose a tu agente una sola vez
Pon este archivo en tu proyecto y el agente sabrá qué herramientas llamar, en qué orden y qué hacer cuando faltan datos. Cubre tanto MCP durante el desarrollo como la API REST en la app terminada.
.claude/skills/himoose/SKILL.mdAGENTS.md.cursor/rules/himoose.mdcCodex y Cursor leen Markdown plano, así que pega el mismo contenido sin el front matter.
---
name: himoose
description: AI search visibility data from Hi, Moose. Use when the user asks how their brand appears in ChatGPT, Gemini, Perplexity, Claude or other AI search engines, or wants to build a report, dashboard or app on that data.
---
# Hi, Moose
Hi, Moose collects answers from AI search engines on a schedule, stores each one with its sources, and measures mentions, citations and competitor presence over time. Use it for that data. Do not query AI engines yourself.
## Two ways in
- MCP server: https://mcp.himoose.com/mcp (OAuth, every plan). Use during development and for work with the user present.
- REST API: https://api.himoose.com/v1 (API key, paid plans). Use in deployed apps and scheduled jobs. Call it from a server only, with the key in HIMOOSE_API_KEY. Schema: https://api.himoose.com/v1/openapi.json.
## Sign-in
Sign-in happens in the user's browser. Never ask for a password, token or API key in chat. Never put a key in client-side code.
## Order of operations
1. list_projects (MCP) or GET /v1/projects (REST). Ask the user which project to use.
2. Check what exists: tracked prompts, engines, firstAnswerDate and latestAnswerDate. History starts when a prompt is first tracked; there is no backfill.
3. Read data: visibility_check_topic for mentions, citations and competitors per engine over a window; visibility_get_answer for one stored answer with sources; visibility_list_opportunities for gaps. REST equivalents: /stats/daily, /stats/competitors, /answers, /answers/{id}.
4. Link every number you display to the answer ID behind it.
## When something is missing
If a tool reports no host device, host offline, no project, no tracked prompts or not enough history, relay the message to the user as written and say what to set up in the Hi, Moose desktop app. Do not estimate, backfill or invent visibility numbers.
## Limits
- MCP jobs run on the host device, so the desktop app must be open and signed in.
- REST reads work with the app closed. REST actions that start runs need a running app and the runs:execute scope.
- /stats/daily returns up to 366 days per request and reports incompleteDays; label those days rather than showing a dip.
- Month-over-month views need runs across both months.
Tu frontend, tu lógica, los datos de Moose
Tres formas habituales, con las llamadas que hace cada una. La interfaz, la marca, el hosting y todo lo específico de tu negocio es tuyo.
Panel interno
Visibilidad por tema y motor, cambio desde el mes pasado, competidores y las fuentes que cita cada motor.
GET /v1/projects/{id}/stats/dailyGET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers/{answerId}Resumen semanal en Slack
Un trabajo programado que compara esta semana con las últimas cuatro y publica la cuota de voz, una respuesta citada y cualquier fuente nueva.
GET /v1/projects/{id}/stats/competitorsGET /v1/projects/{id}/answers?mentioned=falsePortal de clientes para agencias
Un inicio de sesión por cliente, cada uno asociado a los proyectos de Hi, Moose que puede ver. Tu marca y exportación a PDF.
GET /v1/projectsGET /v1/projects/{id}/stats/dailyUn agente de programación puede escribir un recolector en una tarde. Lo que no puede hacer es mantenerlo funcionando. Esa es la parte que Hi, Moose te quita de encima.
MCP y REST, lado a lado
Herramientas MCP para datos de visibilidad
Servidor https://mcp.himoose.com/mcp. Las herramientas de briefs, borradores y auditoría están en Conecta un agente.
list_projectsProyectos de la cuenta con sesión iniciadavisibility_check_topicMenciones, citas y competidores por motor para un tema, ahora y en una ventanavisibility_get_answerUna respuesta guardada completa, con fuentesvisibility_list_opportunitiesHuecos priorizados, con las páginas que los motores citan en su lugarget_resultRecoger un trabajo terminado por IDEndpoints REST
URL base https://api.himoose.com/v1. Los esquemas exactos están en /v1/openapi.json.
GET /v1/projectsProyectos que la clave puede leerGET /v1/projects/{id}Un proyecto, con prompts seguidos, motores y fechas de historialGET /v1/projects/{id}/topicsTemas y los prompts que contienenGET /v1/projects/{id}/stats/dailyTasas de mención y cita por día y motor, hasta 366 díasGET /v1/projects/{id}/stats/competitorsCuota de voz para un rango de fechasGET /v1/projects/{id}/answersRespuestas guardadas, filtrables por motor, prompt, tema, ejecución, mencionado y citadoGET /v1/projects/{id}/answers/{answerId}Una respuesta completa, con fuentesPOST /v1/projects/{id}/run-requestsIniciar una ejecución (necesita runs:execute)Una petición desde tu servidor
curl "https://api.himoose.com/v1/projects/q7Rk2mBw/stats/daily?from=2026-10-05&to=2026-10-11&engine=gemini" \ -H "Authorization: Bearer $HIMOOSE_API_KEY"
{
"from": "2026-10-05",
"to": "2026-10-11",
"incompleteDays": 0,
"data": [
{
"date": "2026-10-05",
"engineId": "gemini",
"answers": 40,
"mentioned": 4,
"cited": 0,
"mentionRate": 0.1,
"citationRate": 0
},
{
"date": "2026-10-06",
"engineId": "gemini",
"answers": 40,
"mentioned": 3,
"cited": 0,
"mentionRate": 0.075,
"citationRate": 0
},
/* …five more days */
]
}
Una fila por día y motor. incompleteDays cuenta los días del rango que aún no están resumidos, para que tu app pueda etiquetarlos en lugar de mostrar una caída. Los valores son datos de ejemplo.
Preguntas sobre construir con Hi, Moose
¿Mi app debería usar MCP o la API REST?
Usa MCP cuando un agente hace el trabajo con una persona presente, en Claude Code, Codex, Cursor, Claude o ChatGPT. Usa la API REST cuando tu propia aplicación o un trabajo programado llama a Hi, Moose desde un servidor. Muchos proyectos usan ambos: MCP mientras el agente explora y construye, la API REST en la app que entrega.
¿Puede una app de navegador llamar a la API directamente?
No. La API no acepta llamadas desde navegadores, y una clave de API en código del lado del cliente quedaría expuesta. Llámala desde tu servidor, una función serverless o un trabajo programado, y envía a tu frontend solo los datos que necesita.
¿Cuánto historial necesita mi app?
Una instantánea por motor necesita una ejecución completada. Las comparaciones mes a mes necesitan ejecuciones en ambos meses. El historial empieza cuando un prompt se sigue por primera vez, así que añade pronto los prompts que te importan.
¿La app de escritorio tiene que seguir abierta?
Para MCP, sí: los trabajos se ejecutan en el dispositivo host que eliges en Ajustes, Agentes conectados. Para las lecturas REST, no: se sirven desde la nube. Las ejecuciones que necesitan tu host lo esperan hasta 24 horas.
¿Puedo ejecutar la app en otro sitio que no sea mi portátil?
Sí. Instálala en un hosting que controles y déjala funcionando, o deja que Hi, Moose la ejecute en un servidor dedicado en tu región. Ambas opciones se describen en la página de infraestructura.
¿Puedo construir una app para mis clientes?
Sí. Las agencias usan un proyecto por marca de cliente y limitan una clave de API a los proyectos que un portal debe leer. El portal, su marca y los inicios de sesión de sus clientes los construyes tú.