Cómo configurar la analítica con Hermes Agent y el plugin de Flowsery

La analítica con Hermes Agent se configura con dos comandos de terminal y un inicio de sesión en el navegador, usando el plugin de Flowsery del catálogo de plugins de Hermes. Después, Hermes responde preguntas sobre su sitio web con sus datos reales de Flowsery: quién lo visitó, de dónde llegó, qué convirtió, qué generó ingresos y qué se rompió.

Hermes Agent, el agente de Nous Research, se ejecuta en su terminal y puede ejecutar tareas programadas por su cuenta. De serie no tiene forma de leer la analítica de su sitio web. El plugin de Flowsery añade eso. Flowsery guarda los datos, Hermes le pregunta a Flowsery y usted aprueba todo lo que cambie una cifra.

La versión corta: añada su sitio web en flowsery.com e instale el fragmento de seguimiento, ejecute hermes plugins install flowsery y hermes plugins enable flowsery, inicie una sesión nueva de Hermes y entre cuando se abra el navegador. Después pregunte a Hermes: "¿Cómo va mi tráfico esta semana comparado con la semana pasada?" Si responde con sus visitantes, el plugin funciona.

¿Qué es el plugin de Flowsery para Hermes Agent?

El plugin de Flowsery es una entrada del catálogo de plugins de Hermes, publicada en el Hermes Marketplace en la categoría Tools, que conecta Hermes Agent con el servidor MCP de Flowsery en https://mcp.flowsery.com/mcp. El paquete contiene tres cosas: un manifiesto plugin.json, una configuración de servidor mcp.json y una skill que enseña a Hermes a responder preguntas de analítica con Flowsery. No incluye código propio.

El servidor es el mismo que usan Claude Code, ChatGPT y Cursor, así que Hermes lee las mismas cifras que muestra su panel de Flowsery. Flowsery incluye Hermes en la página de agentes de IA y en la pestaña AI Agents de la página API Tokens de la aplicación.

Hermes nunca guarda una contraseña de Flowsery. Usted inicia sesión una vez en el navegador, y el plugin conserva un token OAuth que renueva por sí mismo.

¿Qué necesita antes de instalarlo?

Necesita Hermes Agent 0.21.6 o posterior, Node.js 20.18.1 o posterior con npx en su PATH y una cuenta de Flowsery con al menos un sitio web que tenga instalado el fragmento de seguimiento de Flowsery. El plan Team de Flowsery (250 $ al mes) y el plan Pro (500 $ al mes) incluyen el servidor MCP, y ambos empiezan con una prueba gratuita de 14 días que no pide tarjeta.

El requisito de Node.js es el que más se pasa por alto. El plugin ejecuta un pequeño puente de inicio de sesión, mcp-remote, mediante npx, así que una instalación de Hermes en un equipo sin Node falla en el paso de inicio de sesión.

¿Cómo se instala el plugin de Flowsery en Hermes Agent?

Flowsery se instala por su nombre desde el catálogo de plugins de Hermes, y usted inicia sesión una vez en el navegador:

1. Ejecute hermes plugins install flowsery. Hermes muestra el resumen de capacidades de la entrada antes de clonar nada y después descarga el commit exacto que revisó el catálogo.
2. Ejecute hermes plugins enable flowsery. La instalación deja el plugin en el disco, y activarlo hace que Hermes lo cargue. En una terminal, el paso de instalación también pregunta "Enable now?", así que responder que sí cubre ambos pasos.
3. Inicie una sesión nueva de Hermes. La primera vez que arranca el servidor, su navegador abre la página de inicio de sesión de Flowsery.
4. Entre con el correo que usa en Flowsery y apruebe el acceso.
5. Pregunte a Hermes: "Muestre mis sitios web de Flowsery."

hermes plugins install flowsery
hermes plugins enable flowsery

El token se guarda y se renueva, así que inicia sesión una sola vez. Si las herramientas no aparecen después de iniciar sesión, ejecute /reload-mcp en la sesión.

También puede instalarlo directamente desde GitHub con hermes plugins install Flowsery/claude-plugin --no-enable y después hermes plugins enable flowsery. Elija la ruta del catálogo, porque instala el commit que revisó una persona.

¿Qué instala el plugin en su equipo?

El plugin de Flowsery instala una configuración, no un programa. mcp.json ejecuta la versión fijada mcp-remote@0.1.49 mediante npx, que la descarga de npm en el primer uso, abre un puerto local de retorno para el inicio de sesión y guarda los tokens OAuth en ~/.mcp-auth. El paquete no envía telemetría.

El catálogo fija un commit de 40 caracteres, y las instalaciones descargan ese commit en lugar de la punta de una rama. Esa fijación no cubre la lista de herramientas. El servidor de Flowsery decide las herramientas en tiempo de ejecución, así que una herramienta nueva en el servidor llega a Hermes sin una nueva revisión del catálogo. La ficha lo dice en su aviso, y el README del plugin también.

¿Qué analítica puede leer Hermes Agent a través de Flowsery?

Hermes Agent recibe 28 herramientas de Flowsery a través del plugin, y 23 de ellas solo leen. Cada informe acepta un intervalo de fechas, una zona horaria y filtros por país, región, ciudad, dispositivo, navegador, sistema operativo, página, hostname, referente, canal y parámetros UTM. Esto es lo que cubre, por tarea:

• Tráfico. Visitantes, sesiones, tasa de rebote, duración de la sesión, ingresos, ingresos por visitante y tasa de conversión para cualquier periodo, y las mismas métricas por hora, día, semana o mes.
• Visitantes en directo. Cuántas personas estuvieron activas en los últimos 5 minutos, y un mapa de esas personas por ciudad.
• Desgloses. Visitantes por página, referente, canal, campaña UTM, país, región, ciudad, dispositivo, navegador, sistema operativo y hostname. Otra herramienta agrupa visitantes por cualquiera de 25 dimensiones, incluidas la página de entrada y todos los parámetros UTM. Los referentes nombran fuentes conocidas como Google, ChatGPT y Reddit.
• Objetivos e ingresos. Conversiones de cada objetivo, incluidos los objetivos automáticos de pago y de prueba gratuita.
• Un visitante. La ubicación, el dispositivo, la fuente, las visitas, los objetivos, los ingresos y la cronología de un solo visitante.
• Problemas de sesión. Los errores, flujos rotos y problemas de UX que la IA de Flowsery encontró en las grabaciones de sesiones, ordenados por gravedad, con los pasos para reproducirlos y cualquier ticket de Linear o Jira vinculado.

Ninguna herramienta devuelve direcciones IP ni datos de facturación, y el mapa en directo redondea las coordenadas a 0,1 grados. Hermes ve lo que muestra su panel de Flowsery para sus propios sitios web y nada más.

¿Qué herramientas MCP de Hermes Agent piden aprobación?

Hermes Agent le pide aprobación antes de cada una de las cinco herramientas de Flowsery que cambian datos, porque el plugin.json del plugin marca el servidor de Flowsery como untrusted. Esas cinco son track_goal, que registra una conversión de un objetivo, delete_goals, que borra para siempre las conversiones que coinciden con sus filtros, track_payment, que registra un pago, una renovación o un reembolso para atribuir ingresos, delete_payments, que borra para siempre los registros de pagos que coinciden con sus filtros, y update_issue_status, que pone un problema en abierto, en curso, resuelto o suspendido. Las herramientas de pagos solo cambian registros de analítica y nunca cobran ni reembolsan a nadie. Las otras 23 herramientas llevan una marca de solo lectura y se ejecutan sin preguntar.

Hermes también rechaza esas cinco herramientas en las tareas cron y en otras ejecuciones desatendidas. Una tarea programada de Hermes puede leer el tráfico de anoche a las 7 de la mañana, pero no puede borrar datos de objetivos ni de pagos a las 7 de la mañana sin nadie mirando. Para la analítica, ese es el valor por defecto correcto. Una lectura equivocada le cuesta una respuesta confusa. Un borrado equivocado le cuesta un historial que no puede recuperar.

Su rol en el espacio de trabajo es el segundo límite, porque Hermes actúa como usted. Las cinco escrituras necesitan el permiso flowsery.write, que tienen los roles Admin y Editor. Si su rol no lo tiene, Flowsery responde permission_denied y Hermes le dice que un administrador del espacio de trabajo tiene que cambiar su rol.

¿Qué prompts puede probar primero?

Estos prompts vienen del README del plugin, aquí traducidos. Debajo de cada uno está lo que Hermes hace en Flowsery.

"¿Cómo va mi tráfico esta semana comparado con la semana pasada?"

Hermes lista sus sitios web, lee la zona horaria del sitio y consulta el resumen dos veces, una por semana. Obtiene visitantes, sesiones, tasa de rebote, ingresos y tasa de conversión uno al lado del otro. Si tiene varios sitios web, nombre el dominio, o Hermes le preguntará a cuál se refiere.

"¿Qué canales y campañas trajeron clientes de pago este mes?"

Hermes lee sus canales y campañas UTM del mes con los ingresos al lado de cada uno. Los canales siguen grupos al estilo de GA4 como Organic Search, Paid Social, Email y Direct, así que la respuesta encaja con la forma en que la mayoría de los equipos ya informa.

"Los visitantes bajaron el martes. Revise páginas, referentes y dispositivos y dígame por qué."

Hermes compara el martes con los días de alrededor en tres desgloses y señala el que cambió, como un referente que dejó de enviar visitas o una página que dejó de recibirlas. Es el tipo de pregunta en la que un agente gana a un panel, porque consulta y compara los informes que usted revisaría uno a uno.

"¿Cuánto tráfico nos enviaron este mes ChatGPT, Perplexity y otros asistentes de IA?"

Hermes lee sus referentes del mes y separa los asistentes de IA. Flowsery nombra las fuentes conocidas, así que ChatGPT aparece como ChatGPT y no como un dominio sin más.

"¿Qué encontró Flowsery esta semana en las grabaciones de sesiones? Ponga el error del checkout en curso."

Hermes lista los problemas de esta semana por gravedad, abre el problema del checkout con sus apariciones y los pasos para reproducirlo, y le pide aprobación antes de cambiar el estado. Solo cambia el estado. El problema, sus sesiones y sus comentarios quedan como estaban.

"Muéstreme el recorrido del visitante que acaba de empezar una prueba gratuita."

Hermes encuentra al visitante entre las personas del mapa en directo y después lee su perfil: de dónde llegó, qué dispositivo usó, sus visitas, los objetivos que completó y una cronología de páginas, de la más reciente a la más antigua. Los nombres, correos, ID de usuario y direcciones IP nunca forman parte de la respuesta.

¿Puede Hermes Agent enviarle un informe diario de tráfico?

Hermes Agent puede enviarle un informe diario de tráfico con su programador cron, porque las herramientas de Flowsery que necesita solo leen. Pídalo con palabras normales, por ejemplo: "Cada mañana a las 9, deme los visitantes de ayer, los cinco principales referentes y cualquier problema nuevo de gravedad alta de Flowsery, y envíemelo por Telegram." Hermes crea la tarea con su propia herramienta cron, o usted añade una en el chat con /cron add.

El informe se ejecuta en una sesión nueva a la hora que usted fije y entrega el resultado en el chat desde el que lo pidió o en una plataforma que haya configurado. No puede registrar ni borrar objetivos ni pagos, ni cambiar el estado de un problema, porque Hermes rechaza las herramientas de escritura en ejecuciones desatendidas. Si quiere que el informe también marque problemas, deje ese paso para una sesión en la que usted esté presente para aprobarlo.

¿Cómo se ejecuta Hermes Agent sin navegador con una clave de API?

En un servidor o en cualquier equipo sin navegador, omita el plugin y añada el servidor MCP de Flowsery a ~/.hermes/config.yaml con una clave de API. El inicio de sesión OAuth necesita una ventana del navegador, y un equipo sin pantalla no la tiene.

mcp_servers:
  flowsery:
    url: 'https://mcp.flowsery.com/mcp'
    headers:
      Authorization: 'Bearer ${FLOWSERY_API_KEY}'

Cree la clave en flowsery.com/api-tokens y ponga FLOWSERY_API_KEY=... en ~/.hermes/.env. La clave funciona como una contraseña de su cuenta de Flowsery, así que manténgala fuera de los chats.

Esta ruta omite el plugin, así que también omite su skill y el ajuste untrusted de su plugin.json. Un token de espacio de trabajo lleva el rol que usted elige al crearlo, y el formulario Create Token marca el rol Contributor como "Recommended for AI agents". Un token Contributor lee su analítica y recibe permission_denied en las cinco escrituras, que es justo lo que debería tener un agente de analítica sin navegador.

¿Cuándo debería usar Claude Code, ChatGPT, Zapier o n8n en su lugar?

Use Hermes cuando ya trabaje en él. El mismo paquete de Flowsery se instala en Claude Code con /plugin install flowsery --marketplace Flowsery/claude-plugin, y ChatGPT tiene su propio plugin publicado, explicado en la guía del plugin de analítica para ChatGPT de Flowsery. Cursor, Claude Desktop y Gemini CLI también se conectan a https://mcp.flowsery.com/mcp, y un agente que solo acepta un token Bearer, como un conector personalizado de Manus, funciona con un token de espacio de trabajo, como muestra la guía del conector de Manus Cue para analítica web.

Si quiere recibir cifras desde un flujo de trabajo en lugar de una conversación, use una herramienta de automatización. El nodo de Flowsery para n8n envía informes semanales y avisos de problemas nuevos desde su propio servidor, y la guía de analítica con Zapier monta los mismos flujos sin servidor. Ambos pueden además registrar un pago automáticamente cada vez que entra una venta, mientras que Hermes solo registra uno cuando usted se lo pide y lo aprueba.

Preguntas frecuentes

¿Puede Hermes Agent leer la analítica de mi sitio web?

Hermes Agent lee la analítica de su sitio web a través del plugin de Flowsery del catálogo de plugins de Hermes. Instálelo con hermes plugins install flowsery, actívelo y entre con su cuenta de Flowsery. Después, Hermes responde preguntas sobre visitantes, fuentes de tráfico, objetivos, ingresos, visitantes en directo y los problemas que Flowsery encontró en las grabaciones de sesiones.

¿Necesito una clave de API para usar Flowsery en Hermes Agent?

El plugin de Flowsery para Hermes Agent no necesita clave de API. Inicia sesión con OAuth en su navegador la primera vez que arranca el servidor y mantiene el token renovado. Solo necesita una clave de API para una instalación sin navegador, en la que añade el servidor a ~/.hermes/config.yaml con una clave de flowsery.com/api-tokens.

¿Qué versión de Hermes Agent necesita el plugin de Flowsery?

El plugin de Flowsery necesita Hermes Agent 0.21.6 o posterior y Node.js 20.18.1 o posterior con npx en su PATH. Node.js ejecuta mcp-remote, el puente que gestiona el inicio de sesión y se comunica con el servidor MCP de Flowsery.

¿Puede Hermes Agent cambiar mis datos de Flowsery sin preguntar?

Hermes Agent no cambia datos de Flowsery sin preguntar. Solo cinco herramientas escriben: track_goal, delete_goals, track_payment, delete_payments y update_issue_status. El plugin marca el servidor como untrusted, así que Hermes pregunta antes de cada una de esas cinco y las rechaza en cron y en otras ejecuciones desatendidas. Las otras 23 herramientas solo leen.

¿Puede una tarea cron de Hermes enviarme un informe de tráfico?

Una tarea cron de Hermes puede leer Flowsery y enviarle un informe, porque todas las herramientas de informes son de solo lectura. Pida a Hermes algo como "cada mañana a las 9, envíeme los visitantes de ayer y los principales referentes", y programará la tarea. La tarea cron no puede registrar ni borrar objetivos ni pagos, ni cambiar el estado de un problema.

¿Dónde guarda el plugin mi inicio de sesión de Flowsery?

El plugin de Flowsery guarda sus tokens OAuth en ~/.mcp-auth en su equipo. El puente mcp-remote los escribe ahí después de que usted inicia sesión y los renueva, así que inicia sesión una sola vez. El paquete no envía telemetría.

¿Por qué no aparecen las herramientas de Flowsery en Hermes después de iniciar sesión?

Ejecute /reload-mcp en la sesión de Hermes si faltan las herramientas de Flowsery después del inicio de sesión en el navegador. Compruebe también que el plugin esté activado, porque hermes plugins install lo deja en el disco y hermes plugins enable flowsery hace que Hermes lo cargue.

¿Puede Hermes Agent ver las direcciones IP de mis visitantes?

Hermes Agent nunca recibe direcciones IP ni datos de facturación a través de Flowsery, porque ninguna herramienta de Flowsery los devuelve. El perfil de un visitante muestra la ubicación aproximada, el dispositivo, la fuente, las visitas, los objetivos y los ingresos, y el mapa en directo redondea las coordenadas a 0,1 grados.

¿Funciona el plugin de Flowsery con varios sitios web?

El plugin de Flowsery funciona con todos los sitios web de todos los espacios de trabajo a los que llega su inicio de sesión. Hermes llama primero a list_websites y pregunta a qué sitio se refiere cuando hay varios. Nombre el dominio o el espacio de trabajo en su pregunta para saltarse ese paso.

¿Puede Hermes Agent registrar pagos en Flowsery?

Hermes Agent registra pagos en Flowsery con la herramienta track_payment, que añade un pago, una renovación o un reembolso a sus informes de ingresos. Hermes le pide aprobación antes de cada llamada y rechaza la herramienta en cron y en otras ejecuciones desatendidas. La herramienta nunca cobra a nadie ni mueve dinero, y rechaza un ID de transacción repetido. No la use si Stripe, Lemon Squeezy o Polar está conectado a Flowsery, porque Flowsery ya cuenta esos pagos y una segunda entrada cuenta los ingresos dos veces.