Si llevas las analíticas de varios clientes, puedes hacer que sus sitios reporten en una misma instalación de WordPress como sitios conectados. Con Vireo Pro, un solo asistente de IA conectado a esa instalación puede responder entonces sobre todos ellos: qué clientes suben o bajan este mes y qué hay detrás en cualquiera de los sitios.
Para quién es
Agencias y freelancers con sitios de clientes que reportan en una misma instalación de Vireo, normalmente con el plan de 25 sitios o el ilimitado. Cada sitio conectado ocupa un sitio de tu plan, así que el tamaño del plan decide cuántos clientes caben en una instalación. Consulta Cuántos sitios.
Los sitios de los clientes no tienen por qué ser WordPress. Cualquier sitio al que puedas añadir una etiqueta script puede ser un sitio conectado: un sitio estático, una landing page, un sitio de documentación.
Si ya gestionas los sitios WordPress de tus clientes con MainWP, no necesitas sitios conectados para ellos. Ejecuta Vireo Pro en el dashboard de MainWP y el asistente lee cada sitio hijo a través de MainWP. Consulta Con un dashboard de MainWP.
Antes de empezar
- En el sitio WordPress de tu agencia, instala Vireo Pro y activa la licencia.
- Añade cada sitio de cliente en Vireo Analytics, Ajustes, Otros sitios, Sitios conectados, y pega su etiqueta en ese sitio. Consulta Sitios conectados.
- Conecta tu asistente de IA a esta instalación, una sola vez. Todos los sitios de clientes son accesibles a través de esa única conexión.
Pregunta por todos los sitios
Empieza con algo amplio:
¿Qué sitios de mis clientes suben o bajan este mes?
El asistente llama a get-sites-overview. Devuelve todos los sitios, del más visitado al menos, con las páginas vistas y los visitantes de este periodo junto a los del periodo anterior de la misma duración, la variación en porcentaje y el último día en que cada sitio registró una visita:
{
"start": "2026-09-12", "end": "2026-10-11",
"prior_start": "2026-08-13", "prior_end": "2026-09-11",
"sites": [
{"id": 0, "name": "Agency site", "this_site": true, "last_data": "2026-10-11", "pageviews": 3000, "prior_pageviews": 2384, "pageviews_change_pct": 25.8},
{"id": 2, "name": "Client B", "this_site": false, "last_data": "2026-10-11", "pageviews": 1500, "prior_pageviews": 745, "pageviews_change_pct": 101.3},
{"id": 1, "name": "Client A", "this_site": false, "last_data": "2026-10-11", "pageviews": 300, "prior_pageviews": 596, "pageviews_change_pct": -49.7},
{"id": 3, "name": "Client C", "this_site": false, "last_data": "2026-09-11", "pageviews": 0, "prior_pageviews": 894, "pageviews_change_pct": -100}
]
}
Está recortado por espacio: cada sitio también tiene su url, visitors, prior_visitors y visitors_change_pct.
Una fecha last_data bastante antigua, como la del Client C, suele significar que la etiqueta del sitio se quitó o se rompió. Merece una pregunta directa:
¿Ha dejado de registrar visitas algún sitio de cliente?
Entra en un sitio concreto
Cada sitio tiene un id: el 0 es la instalación a la que te conectaste, y los sitios conectados se numeran desde el 1. Pregunta por un cliente por su nombre y el asistente busca el id con get-sites y lo pasa como site al informe que necesita:
¿Cuáles fueron las páginas principales de Client B la semana pasada?
Eso es get-top-pages con "site": 2. Lo mismo vale para totales, fuentes de tráfico, referentes, países y los demás informes que se enumeran más abajo. Omite site, o pasa 0, para la instalación a la que te conectaste.
Con un dashboard de MainWP
Vireo Pro lleva soporte de MainWP integrado. Instala Pro en el sitio del dashboard de MainWP y activa la licencia, y Pro se añade solo a la página Extensions de MainWP. Cada sitio hijo necesita MainWP Child, Vireo Analytics y Vireo Pro con una licencia activa.
Si usabas el plugin independiente Vireo Analytics for MainWP, desactívalo. Pro hace el mismo trabajo, y mientras el plugin antiguo siga activo, Pro no toca MainWP y muestra un aviso que lo indica.
En el dashboard obtienes:
- Un widget de Vireo Analytics en el Overview de MainWP, que lista los visitantes, las páginas vistas y la variación de cada sitio hijo a 7 o 30 días, según la última sincronización.
- Una página de Vireo Analytics para cada sitio hijo, con sus visitantes, páginas vistas, páginas principales y referentes principales de los últimos 7 o 30 días, consultados en el momento.
- Tokens para los Pro Reports de MainWP:
[vireo.visitors],[vireo.pageviews],[vireo.visitors.change],[vireo.pageviews.change],[vireo.top.pages]y[vireo.top.referrers]. Cada uno se rellena con el sitio y las fechas del informe. Un sitio hijo sin Vireo recibe una breve razón en lugar de un token sin resolver. - Las herramientas del asistente de esta página, para todos los sitios hijos.
La página de Vireo en las Extensions de MainWP lista cada sitio hijo con la versión de Vireo Analytics que ejecuta y un botón Open para su página de Vireo. Un sitio hijo que no puede reportar explica por qué en lugar de mostrar una versión:
- todavía no se ha sincronizado
- Vireo Analytics no está instalado, o está instalado pero no activo
- Vireo Pro no está activo en él
- su Vireo Analytics es demasiado antiguo: el widget, la página y los tokens necesitan la versión 0.9.0 o posterior
- no comparte sus estadísticas con el dashboard
- no tienes acceso a él en MainWP
- no respondió
Pregunta por los sitios hijos de MainWP
Conecta tu asistente de IA al dashboard de MainWP. get-sites lista todos los sitios hijos que ves en MainWP, con ids como mainwp:12 (el id del sitio en MainWP) y "source": "mainwp", y el asistente pasa ese id como site:
¿Cuáles de mis sitios de MainWP han bajado este mes?
get-sites-overview obtiene de golpe los totales de todos los sitios hijos. Un sitio hijo que no responde en 10 segundos, no tiene Vireo, ejecuta un Vireo demasiado antiguo para responder o ha desactivado el envío de datos aparece en unreachable con su motivo, en lugar de desaparecer de las cifras sin decir nada.
Un sitio hijo responde solo con Vireo Pro activo y con licencia, y entonces responde a todas las herramientas de su propio Vireo: los informes gratuitos y los de Pro, como campañas, interacción e ingresos, porque Pro los registra en ese sitio.
Qué herramientas aceptan un sitio
Por MCP y la Abilities API, estas aceptan site:
get-totals, get-daily-stats, get-hourly-stats, get-changes, get-highlights, get-top-pages, get-top-referrers, get-traffic-sources, get-referrer-detail, get-ai-referrals, get-countries, get-devices, get-events, get-event-detail, get-404s, get-bot-stats, get-vitals, get-annotations.
get-sites devuelve la misma lista en accepts_site, para que el asistente no tenga que adivinar.
Estas responden por la instalación a la que llamas:
- Los informes propios de Pro, como campañas, interacción, búsquedas en el sitio, embudos, visitantes en directo e ingresos, que Pro registra para el sitio WordPress en el que está instalado.
get-post-statsyget-year-review, que se construyen a partir de las entradas de WordPress de este sitio.get-search-consoleyget-goals, que se guardan para este sitio.
Esa lista es para sitios conectados. Un sitio hijo de MainWP ejecuta la herramienta en su propio Vireo, así que responde con lo que ese sitio tenga instalado.
Si preguntas por uno de estos informes en el sitio de un cliente, obtienes un error en lugar de las cifras de este sitio bajo el nombre del cliente. Un informe de Pro dice que está «recorded for this WordPress site only» y señala las herramientas que sí aceptan site. Las demás rechazan site como una entrada desconocida.
Cuando no se puede leer un sitio
Una petición sobre otro sitio se rechaza, sin cifras, en lugar de responderse con los datos del sitio equivocado:
| Situación | Error | Por REST |
|---|---|---|
| Ningún sitio conectado tiene ese id | vireo_site_unknown: «No connected site has the id 9. Call get-sites for the list». |
404 |
Una herramienta que no acepta site, como uno de los informes propios de Pro |
vireo_site_unsupported |
400 |
| Pro no está activo con licencia | vireo_site_pro |
403 |
| El usuario no puede leer las cifras de ese sitio | vireo_site_forbidden |
403 |
Un sitio hijo de MainWP añade sus propios rechazos. Cada mensaje nombra el sitio, por ejemplo mainwp:12, y explica qué falló:
| Situación | Error | Por REST |
|---|---|---|
| El sitio hijo queda fuera de los sitios de tu plan | vireo_site_over_plan |
403 |
| El sitio hijo no respondió, o respondió algo inesperado | vireo_remote_unreachable |
502 |
| El Vireo del sitio hijo es demasiado antiguo para responder a llamadas de herramientas | vireo_remote_old |
501 |
| El sitio hijo se negó: su administrador de MainWP no puede leer sus analíticas, o ha desactivado el envío de datos a MainWP | vireo_remote_denied |
403 |
Las herramientas gratuitas que no están en la lista por sitio rechazan site como una entrada desconocida (ability_invalid_input, 400). Cada respuesta, de este sitio o del de un cliente, se aplana antes de llegar al asistente: de todo lo que pudo escribir un visitante se eliminan los saltos de línea, los caracteres de control e invisibles y los corchetes que podrían hacer pasar un texto por una instrucción.
Cuántos sitios
Los planes se calculan por sitios, y un sitio conectado cuenta como uno. Cada instalación de WordPress puede conectar un sitio, más uno por cada sitio que tu licencia tenga sin usar. Un plan de 25 sitios activo solo en el sitio de tu agencia puede alojar allí 25 sitios de clientes; uno ilimitado, 100. get-sites informa del limit de la instalación y de cuántos sitios están conectados (count).
Los sitios hijos de MainWP también cuentan. Los sitios conectados usan el margen primero, y los sitios hijos se quedan con lo que sobra, en el orden en que se añadieron a MainWP. Un sitio hijo que queda fuera del margen sigue apareciendo en get-sites, con "over_plan": true, para que el asistente pueda decírtelo, pero sus cifras no se pueden leer hasta que amplíes los sitios de tu plan. get-sites también informa de cuántos sitios hijos encontró como remote_count.
Si el margen se reduce más adelante, por ejemplo porque activaste la licencia en otro sitio WordPress, los sitios de clientes ya conectados siguen contando y siguen siendo legibles, y añadir más exige un plan mayor.
Por REST
Los mismos datos están disponibles para scripts con una contraseña de aplicación:
curl -u "$VIREO_AUTH" "https://example.com/wp-json/vireo-analytics/v1/stats/sites"
curl -u "$VIREO_AUTH" "https://example.com/wp-json/vireo-analytics/v1/stats/sites-overview?start=2026-09-12&end=2026-10-11"
Para un sitio de cliente concreto, ejecuta una ability a través de la Abilities API con site en su entrada:
curl -g -u "$VIREO_AUTH" \
"https://example.com/wp-json/wp-abilities/v1/abilities/vireo-analytics/get-totals/run?input[site]=2"
{"pageviews":1500,"visitors":1200,"days":30,"avg_daily":50}
Las rutas /stats/... del propio plugin gratuito, como /stats/totals, no aceptan site. Responden siempre por la instalación a la que llamas e ignoran un parámetro site.