Agentimus MCP Server

Agentimus

Dos cosas para la era de los agentes de IA. (1) Haz que cualquier sitio de WordPress sea legible y citable: llms.txt, una edición de texto completo, entrega en markdown, JSON-LD, reglas de robots con señales de contenido — y luego puntua en qué medida está preparado para AEO/GEO y qué corregir a continuación. (2) Permite que las herramientas de IA que ya usas operen el sitio mediante MCP: un servidor de Model Context Protocol se incluye dentro del plugin, y así Claude Code, Claude Desktop, Cursor o Codex pueden consultar tus datos de preparación, tráfico y bots y — detrás de dos activaciones opcionales más — redactar, editar y publicar entradas y páginas, y cada escritura se ejecuta como el usuario conectado, con comprobación de permisos y auditoría. Ligero, sin inflar el SEO, sin framework.

Disponible en WordPress.org: https://wordpress.org/plugins/agentimus/

📖 Documentación: https://heera.github.io/agentimus/: manual de usuario completo y referencia para el programador.

Related MCP server: wordpress-mcp

Instalación

• Desde el panel de control — Plugins → Añadir nuevo → Buscar "Agentimus" → Instalar → Activar.

• Desde WordPress.org — https://wordpress.org/plugins/agentimus/.

• Desde el código — clona este repositorio, ejecuta npm install && npm run build (genera assets/admin/) y luego copia o enlaza simbólicamente la carpeta en wp-content/plugins/.

Qué hace

Wait, I notice I wrote "legible y ejecutable" - that's wrong, it should be "legible y citable". Let me correct.

Also "consultar" vs "leer" - the original says "read". "leer" is fine.

Let me also "puntua" -> "puntúa" with accent.

Let me fix the whole thing:

"Dos cosas para la era de los agentes de IA. (1) Haz que cualquier sitio de WordPress sea legible y citable: llms.txt, una edición de texto completo, entrega en markdown, JSON-LD, reglas de robots con señales de contenido — y luego puntúa en qué medida está preparado para AEO/GEO y qué corregir a continuación. (2) Permuta que las herramientas de IA que ya usas operen el sitio a través de MCP: un servidor de Model Context Protocol se incluye dentro del plugin, para que Claude Code, Claude Desktop, Cursor o Codex puedan leer tus datos de preparación, tráfico y bots y — detrás de dos conmutadores opcionales más — redactar, editar y publicar entradas y páginas; cada escritura se ejecuta como el usuario autenticado, con verificación de permisos y auditoría. Ligero, sin inflar el SEO, sin framework."

Ok let me also re-check "entrega con" - original says "markdown delivery" - I'll say "entrega en markdown".

And "Plugin" - keep plugin.

Also the second bullet: "Desde el código" - better "Desde el código fuente".

Let me also check the note: "información del manual de usuario completo y referencia de desarrolladores." - In "Documentation:" I have "manual de usuario completo y referencia para el programador".

Ok. Let me output the final,# Agentimus

Dos cosas para la era de los agentes de IA. (1) Haz que cualquier sitio de WordPress sea legible y citable: llms.txt, una edición de texto completo, entrega en markdown, JSON-LD, reglas de robots con señales de contenido — y luego puntúa en qué medida está preparado para AEO/GEO y qué corregir a continuación. (2) Permite que las herramientas de IA que ya usas operen el sitio a través de MCP: un servidor de Model Context Protocol se incluye dentro del plugin, de modo que Claude Code, Claude Desktop, Cursor o Codex puedan leer tus datos de preparación, tráfico y bots y — detrás de dos alternativas optativas más — redactar, editar y publicar entradas y páginas, ejecutándose cada escritura como el usuario conectado, con verificación de permisos y auditoría. Ligero, sin inflar el SEO, sin framework.

Disponible en WordPress.org: https://wordpress.org/plugins/agentimus/

📖 Documentación: https://heera.github.io/agentimus/ — manual completo de usuario y referencia para el desarrollador.

Instalación

• Desde el panel de control — Plugins → Añadir nuevo → buscar “Agentimus” → Instalar → Activar.

• Desde WordPress.org — https://wordpress.org/plugins/agentimus/.

• Desde el código fuente — clona este repositorio, ejecuta npm install && npm run build (genera assets/admin/) y luego copia o enlaza simbólicamente la carpeta en wp-content/plugins/.

Qué hace

En el admin

• Hallazgos — una puerta de entrada para todo lo abierto en el sitio, en la navegación con su propio contador. Una única lista clasificada (páginas que pierden un clic que ya ganan, además de cualquier cosa que detecten las comprobaciones de configuración) ordenada por lo que cuesta cada una, con cada fila llevando el botón que aterriza en la solución. El contador mide solo el trabajo que se puede realizar; cualquier cosa que simplemente espera un informe posterior recibe un punto discreto en su lugar. Debajo, la lista de trabajo de contenido por elemento: una fila por elemento publicado, para qué se ha encontrado, si responde a eso y qué más necesita.

• Tema claro / oscuro — un conmutador que muestra el modo al que se está cambiando. El oscuro es una paleta ajustada a mano, no una inversión, con su propio dialecto por esquema de color del administrador de WordPress (las claves de Default son neutras, las de Coffee marrones y doradas). Una selección manual se mantiene hasta que el sistema operativo cambie la próxima vez, y entonces el ritmo del dispositivo vuelve a ganar; el modo resuelto viaja en <html data-ar-theme> y se recuerda por navegador, nunca en Ajustes.

• Puntuación AEO/GEO — una puntuación de 0 a 100 en el panel de control en cinco niveles (Encontrable / Legible / Confiable / Optimizado / Citado), con el siguiente paso más útil; cada nivel enlaza directamente a dónde se actúa sobre él. Citado es opcional (ver Citas) y su peso se redistribuye entre los demás cuando está desactivado. Una puntuación de 99,6 se lee 99 — el 100 se gana, nunca se redondea.

• Trabajo por problema — elige una comprobación y cada página que marque se abre en Tu contenido, clasificada y paginada, en lugar de una muestra de seis. Corrige aquello para lo que se abrió una lista filtrada y la fila mantiene su lugar, marcada como hecha, en lugar de desaparecer antes de que puedas ver el arreglo.

• Lectura que no depende de WP-Cron — el barrido de contenido es trabajo programado y, en muchos servidores, los trabajos programados de WordPress nunca se ejecutan (una página en caché nunca ejecuta PHP, por lo que la solicitud que los iniciaría nunca llega). Agentimus nota cuándo sus propios trabajos están atrasados y los ejecuta desde la pantalla de administración en la que ya estás, uniéndose al bloqueo del propio núcleo para que nunca pueda ejecutar un trabajo dos veces. Un sitio cuyo cron funciona no carga nada extra.

• Optimiza tu contenido — comprobaciones de citabilidad por página (contenido escaso, algo concreto que citar, pasajes citables, frescura) en tus artículos, con una lista de trabajo de qué páginas mejorar y un panel de solo lectura a juego en el editor. Los productos de comercio, las páginas designadas de los plugins de comercio (carrito, pago, cuenta — se leen tanto las opciones de WooCommerce como los ajustes de FluentCart) y las páginas contenedoras de shortcodes/bloques sin prosa de autor quedan excluidas; aparta cualquier página que no deba citarse (sigue publicada, solo sale de la puntuación) — el apartado es un libro de contabilidad, así que todo lo que aparques permanece listado y contado en lugar de meramente ausente; marca categorías como evergreen para eximir al contenido atemporal de la comprobación de frescura.

• Tipos de contenido y tu veto sobre ellos (Ajustes) — los tipos que un plugin activó se agrupan aparte de los tuyos, y puedes desactivar uno aunque el plugin que lo añadió quiera mantenerlo activado. El asistente de escritura sigue la misma regla: una página no recibe secciones inventadas, ni espacios de imagen ni etiquetas, porque una página no es un artículo.

• Las pantallas se vuelven a leer al volver a ellas — al salir de una pantalla de datos y volver, solían mostrarse los números de cuando se abrió el plugin por primera vez. Ahora cada una se actualiza al volver, así que lo que hay en pantalla es lo que es verdad.

• Centro de descubrimiento (pestaña Descubrimiento) — el inventario de todo lo que este sitio publica para máquinas: los proveedores que lo describen, las capacidades que declaran, las API públicas, los documentos well-known y la superficie de MCP y herramientas. La sección de herramientas declara tres cosas separadas en tres paneles: lo que un agente con sesión iniciada puede ejecutar (agrupado por proveedor, cada grupo abriéndose a sus nombres de herramienta), las direcciones a las que se conectan esos agentes y lo que un agente anónimo recibe en /.well-known/mcp.json. Las listas de capacidades se desplazan dentro de una altura fija, ya que su longitud la decide el sitio (una por tipo de contenido REST público y taxonomía). Cualquier problema de registro se enumera con una solución en lenguaje sencillo.

• Informe de preparación — comprobaciones de apto/advertencia/error, cada una con una sugerencia en lenguaje sencillo y un enlace profundo a la solución (incluida una comprobación de "mapa del sitio anunciado en robots.txt").

• Vista previa del agente — un modal (desde Preparación) que muestra el JSON-LD y Markdown exactos que un agente recibe para el sitio o cualquier página/entrada, con un selector agrupado de sitio/página/entrada, copiar y enlaces de validación. Muestra lo que se enviaría incluso cuando el esquema está deshabilitado o un plugin de SEO lo posee; las entradas protegidas con contraseña permanecen ocultas y un borrador no publicado se muestra como una vista previa de lo que emitirá una vez publicado. Un gemelo de solo lectura también se encuentra en el editor de entradas.

• Visibilidad → Búsqueda — qué buscó la gente, con qué frecuencia apareciste, con qué frecuencia se hizo clic en esos resultados y las páginas que los ganaron, cada número informado por el propio motor. Conecta Google y Bing y aparece un interruptor: los dos cuentan buscadores diferentes y nunca se fusionan. Justo debajo, Oportunidades de búsqueda convierte esos mismos números en una lista de trabajo — páginas que se quedan a las puertas de la primera página y páginas de la primera página que se pasan por alto — cada entrada conectada al campo exacto que la soluciona. También nombra las búsquedas que varias de tus páginas se reparten — los clics se dividen, por lo que cada una se posiciona más abajo de lo que lo haría una sola página — con la página que gana el clic indicada y una decisión sobre cada una de las demás. (Vivía al final de Preparación hasta la 1.36; Preparación ahora mantiene un puntero a ella).

• Visibilidad → En el índice — si los índices de los motores realmente contienen tus páginas, el de Bing y el de Google en una sola pantalla. Bing es el índice que leen hoy la búsqueda de ChatGPT y Copilot: cuánto de tu sitio contiene, con qué limpieza entra su rastreador, una serie diaria de tráfico humano con tendencia semana a semana y una pregunta en vivo por página respondida por la propia API de Bing. El lado de Google recorre todo el sitio en rotación y lo vuelve a comprobar a diario — las páginas sanas siguen siendo un contador, cualquier cosa que necesite un vistazo gana una fila con las propias palabras de Google y un enlace profundo a Search Console, y cualquier URL individual se puede volver a inspeccionar en el acto.

• Fuentes de datos (Ajustes → Fuentes de datos) — servicios externos de los que Agentimus lee, todos opcionales y de solo lectura, cada uno con una clave guardada en tu propio servidor y sin proxy de terceros: Cloudflare para lo que el borde respondió o bloqueó antes de que tu servidor lo viera (y, con un permiso de token extra opcional, vaciar su caché cuando publicas), Google Search Console para la cobertura de búsqueda e índice — con Analytics montado en esa misma clave si quieres números de visitantes — y Bing Webmaster Tools, que también puede anunciar cada cambio que publiques a través de IndexNow. Los números aterrizan en tu propia base de datos, por lo que tu historial sobrevive a la ventana de informes de cada servicio.

• Citas (Visibilidad → Citas; opcional, trae tu propia clave — añade el nivel Citado a tu puntuación, y una lectura caduca a los 90 días para que una obsoleta nunca cuente) — rastrea cada marca, producto o persona que elijas en ChatGPT, Perplexity, Gemini y Claude. Por cada uno, hace las preguntas que tu audiencia escribe e informa si está mencionado, enlazado y cómo se clasifica frente a sus propios rivales, a lo largo del tiempo. Dale a un elemento una categoría ("plugin de SEO para WordPress") y Agentimus sugiere las preguntas que alguien realmente escribe — o, cuando un proveedor de IA está configurado en WordPress, le pide a esa IA una variedad de preguntas sin marca (POST /visibility/suggest y /visibility/suggest-ai). Cada elemento tiene su propio sitio web, categoría, competidores, preguntas y marcador; pausa cualquiera o todo el horario, y cada ajuste de la pantalla se guarda solo. Los resultados se almacenan localmente; es la única función que hace llamadas salientes — usando claves API que proporcionas (almacenadas cifradas en reposo), desactivada por defecto. Mantiene sus propias claves en lugar de reutilizar los conectores de IA compartidos de WordPress, porque una verificación de visibilidad se califica por las fuentes que un motor citó y el cliente compartido las descarta.

• Registro de actividad del agente — un panel de solo local (sin IP registrada por defecto; un ajuste opcional almacena IP solo para rastreadores marcados) de qué agentes de IA y rastreadores obtienen tus endpoints; los aciertos repetidos se agrupan con un contador, los más recientes primero. Haz clic en la barra de cualquier día para el informe completo de ese día: clientes, endpoints y cada solicitud. Tus propias visitas con sesión iniciada se omiten, y también las búsquedas de verificación en vivo/exposición de la pantalla de preparación (llevan un token X-Agentimus-Selfcheck de corta duración, ya que son deliberadamente anónimas).

• Registro de solicitudes (Más → Registro de solicitudes) — el registro bruto detrás de ese panel: una fila por solicitud, paginado por claves, filtrable por cliente, endpoint, red, agente de usuario y rango de fechas. Los filtros se combinan con Y, dando la tabulación cruzada agente × endpoint que los resúmenes agregados estructuralmente no pueden mostrar.

• Acceso del agente (Más → Acceso del agente) — la otra cara del registro: quién se autentica y actúa en la superficie de máquina que crea Agentimus. Registra la creación/el primer uso/el cambio de nombre/la revocación de contraseñas de aplicación, la ejecución de capacidades de WordPress y las solicitudes que fueron rechazadas o que sondearon capacidades que no existen — y cada fila dice quién: el usuario y la contraseña de aplicación nombrada detrás, resueltos en vivo (una clave renombrada muestra su etiqueta actual, una revocada lee "desde revocada"). Un registro, no un guardián (nunca bloquea); sin IP registrada, por lo que nombra la credencial, no a la persona. Monta rest_request_after_callbacks y los hooks de contraseña de aplicación; la mitad de credenciales no necesita la API de capacidades, la mitad de capacidades la detecta automáticamente.

• Tráfico desde IA — un contador privado de primera parte de qué asistentes de IA envían visitantes a tu sitio (recuentos diarios de asistente → página de aterrizaje; sin IP, sin datos por visitante). El panel muestra un resumen — haz clic en la barra de cualquier día para el informe de asistente → página de aterrizaje de ese día; Más → Visitantes es el informe completo, con el mismo desglose diario. Cada tarjeta dice que son personas, no agentes: el registro de solicitudes es el lado de la máquina, Visitantes es el lado humano, y los dos nunca se suman. Un modo CDN opcional los cuenta en el navegador para que los números sobrevivan a una caché de página completa. Debido a que el reconocimiento es una lista finita, un diagnóstico opcional de Encontrar fuentes de IA perdidas registra los hosts de referencia y las etiquetas utm_source que no pudo atribuir — la única forma de ver un punto ciego que de otro modo no deja rastro.

• Retención del registro de visitas (Ajustes → Registro de visitas) — un período de retención, borrado automático nocturno y un límite estricto de filas. El límite supera a la retención: "conservar durante 90 días" es un techo de antigüedad, no una promesa de que una fila sobreviva 90 días. Desactivar el borrado automático no significa "conservar para siempre" — el límite sigue cobrando, el más antiguo primero.

• Mantén los endpoints de IA fuera de tu caché (Ajustes → Caché y CDN, opcional) — si una caché o CDN frente a tu sitio sirve copias almacenadas de los endpoints de IA (llms.txt, los documentos .well-known, el feed de cambios), esas búsquedas de agentes nunca llegan a WordPress: el registro las subestima y el feed de cambios puede quedar obsoleto. Actívalo y los endpoints envían Cache-Control: no-store, para que cualquier caché que lo respete deje pasar cada búsqueda. El informe de preparación enlaza a ello cuando detecta una caché frente a ti.

• Actualizar archivos de IA cuando cambia el contenido (Ajustes → Caché y CDN, activado por defecto) — en cada cambio de contenido, pide a cada caché de página detectada (WP Rocket, Nginx Helper, W3 Total Cache, LiteSpeed, WP Super Cache, Cache Enabler o cualquier escuchador de agentimus_purge_url) que suelte los archivos de IA — llms.txt, llms-full.txt, robots.txt, el feed de cambios, los documentos .well-known — además del gemelo .md de la entrada editada, que un plugin de caché de otro modo nunca sabría actualizar. Con detección de funciones, por lo que no hace nada si no hay caché presente.

• Actividad para revisar — una cola de revisión en la barra de navegación marca clientes nuevos, inusualmente voluminosos, falsificados/escáner o suplantadores (uno que afirma ser un bot del registro editable de bots verificados — Googlebot, GPTBot, PerplexityBot, … — pero que falla concluyentemente la comprobación publicada de ese operador: DNS inverso o sus rangos de IP publicados), cada uno con un panel simple de "Comprobar este bot" y un clic para Bloquear / Permitir / Ignorar. Se combina con la aplicación opcional Bloquear escáneres y raspadores; un ajuste opcional de Almacenar direcciones IP para clientes marcados muestra la dirección exacta a bloquear. Cada decisión permanente — bloqueado, de confianza, ignorado — se gestiona más tarde en Ajustes → Acceso de IA → Gestionar clientes: identidad, fecha de decisión y deshacer con un clic por fila.

• Exposición — controles opcionales que limitan lo que los rastreadores anónimos pueden leer (enumeración de nombres de usuario, archivos de autor, la versión de WP, enlaces <head>, XML-RPC), además de un escaneo de archivos expuestos con un clic que comprueba si los archivos de riesgo (copias de seguridad, .env, debug.log, claves) son descargables públicamente y te dice cómo bloquearlos. Orientación, no un cortafuegos.

• Restablecimiento de fábrica — un clic restaura cada ajuste a sus valores recomendados por defecto, con una vista previa de exactamente lo que cambiará.

Arquitectura

• PHP (inc/, espacio de nombres Agentimus\, autoload PSR-4) — PHP puro, sin framework.

  • Plugin orquesta; Settings es el almacén de opciones único; Cache gestiona los transients; Endpoints / Markdown / Schema generan la salida; Readiness ejecuta las comprobaciones; Rest respalda el admin; Admin monta la interfaz.

• Interfaz de administración — Vue 3 (Options API), compilada con Vite en assets/admin/. Se comunica con el espacio de nombres REST agentimus/v1 con el nonce estándar de WP.

Extensión a cualquier sitio / tipo de contenido

El núcleo gratuito cubre post + page y cualquier tipo de contenido público que actives (tarjeta de tipos de contenido, o el filtro agentimus_post_types), por lo que los productos y los CPT fluyen automáticamente a llms.txt, la edición de texto completo, markdown y schema. Una cobertura más profunda (un mapeador de Product de WooCommerce, contenido de page builders) es un complemento que se engancha en estas costuras:

• agentimus_post_types — añadir/eliminar tipos de contenido visibles para agentes

• agentimus_schema_for_post — devolver un nodo completo, p. ej. Product con ofertas

• agentimus_markdown_source — proporcionar HTML renderizado para contenido de page builders

Para desarrolladores — haz que tu plugin sea detectable

Agentimus expone una única capa de descubrimiento agregada en /.well-known/discovery.json (además de agent-card.json y mcp.json). Cualquier plugin puede registrarse con una acción y sin dependencias — si Agentimus no está instalado, el hook nunca se dispara, por lo que el código es inerte:

add_action( 'wpdiscovery_register', function ( $registry ) {
    $registry->register( array(
        'id'           => 'acme-bookings',
        'title'        => 'Acme Bookings',
        'type'         => 'scheduling',                 // controlled vocab + x-vendor-name
        'capabilities' => array( 'scheduling.booking.create' ), // dot-notation INTENT
        'endpoints'    => array(                        // WHERE (concrete paths live here)
            array( 'url' => '/wp-json/acme/v1', 'type' => 'rest', 'auth' => 'apikey' ),
        ),
        'auth'         => array( 'type' => 'apikey', 'docs' => 'https://acme.dev/api' ),
        'agent'        => array( 'name' => 'Acme Agent', 'skills' => array(
            array( 'id' => 'create_booking', 'description' => 'Book an appointment.' ),
        ) ),
    ) );
} );

También hay una fachada global disponible (protégela, ya que la llamada es directa):

if ( class_exists( 'Agentimus_Discovery' ) ) {
    Agentimus_Discovery::register( [...] );
}

Campos del recurso: id (obligatorio, slug), title (obligatorio), type (obligatorio — content, commerce, scheduling, courses, forms, crm, auth, search, media, messaging, analytics, payments, directory, agent o x-vendor-name; añade tu propio tipo con el filtro agentimus_resource_types — una palabra no declarada se marca como x- y se publica, nunca se descarta), description, version, capabilities[], endpoints[] ({url, type, methods[], auth, description}), schemas[], auth ({type, oidc, scopes[], docs}), agent ({name, description, skills[{id,description}], endpoint, auth}), abilities[], tools[] (con forma de MCP), docs. provider se rellena automáticamente — no lo establezcas.

Las capacidades describen la intención; las rutas concretas /wp-json/... se encuentran solo en endpoints/tools. Las entradas no válidas se rechazan y se muestran (con el motivo) en Discovery Hub → Validación.

$registry->add_well_known( [...] ) sirve un documento /.well-known/<name> (callback | redirección | archivo). Consulta examples/integrate-your-plugin.php para la referencia completa de copiar y pegar, y la especificación WP_Discovery Protocol para el estándar.

Hooks y filtros

Cada hook es opcional y pertenece a uno de tres niveles. Las tablas indican el tipo de cada hook (acción o filtro) y la firma del callback (parámetros → retorno); hay ejemplos de copiar y pegar en examples/all-hooks-reference.php. En las firmas, Registry, Settings y Plugin son las clases Agentimus\Discovery\Registry, Agentimus\Settings y Agentimus\Plugin.

Estable

Público y congelado en la especificación WP_Discovery 1.0 — seguro sobre el que construir.

// Add selectable schema.org entity types to Settings → Identity.
add_filter( 'agentimus_entity_types', function ( $types ) {
    $types[] = 'Restaurant';
    return $types;
} );

Extensión

Filtros compatibles para dar forma a la salida; las firmas pueden evolucionar entre versiones.

// Add a vendor extension to the discovery document (the x- namespace is yours).
add_filter( 'agentimus_envelope', function ( $envelope, $registry ) {
    $envelope['x-acme'] = array( 'portal' => 'https://acme.example' );
    return $envelope;
}, 10, 2 );

Interno

Ajuste avanzado para propietarios de sitios — no es una superficie de integración de terceros.

// The Guard's final say on whether to 403 a request.
add_filter( 'agentimus_deny_request', function ( $deny, $ua ) {
    return $deny;
}, 10, 2 );

Desarrollo

npm install
npm run build      # one-off build into assets/admin/
npm run dev        # rebuild on change

assets/admin/ está en git-ignored — es un artefacto de compilación. Envíalo en el .zip distribuido (la etiqueta SVN de .org), no en el repositorio.

Requisitos

• WordPress 6.9+ (probado hasta 7.0)

• PHP 7.4+.

Licencia

GPL-2.0-or-later. La aplicación de administración se compila desde el código fuente de Vue en resources/ con Vite — no se distribuye código solo minificado, por lo que la compilación es reproducible.