Integración
AgentFi funciona como un proxy ligero delante de su sitio. Intercepta las solicitudes de los bots de IA y sirve contenido optimizado (/llms.txt, /sitemap.xml, páginas de producto) directamente desde su sitio, mientras que el resto del tráfico pasa sin cambios.
Requisito previo: dominio verificado#
El despliegue del proxy exige haber verificado la propiedad del dominio. El procedimiento está en Verificación del dominio.
El rastreo y la optimización de páginas ya están disponibles sin verificación. Solo el proxy la requiere.
Paso 1: elija el modo de despliegue#
Todos los modos son funcionalmente equivalentes para los bots de IA. Las diferencias están en la dificultad del despliegue y en la mejora SEO para visitantes humanos.
| Modo | Qué implica | Diferencia |
|---|---|---|
| Cloudflare Worker RECOMENDADO | AgentFi despliega el Worker en su cuenta de Cloudflare. | Paridad total de funciones, incluida la inyección de JSON-LD y metaetiquetas en el head para visitantes humanos. |
| Nginx (autoalojado) MODO LITE | Usted copia un bloque de configuración en su propio vhost. | Los bots de IA reciben HTML optimizado para cualquier URL; sin inyección en el head para humanos. |
| Apache (autoalojado) MODO LITE | Usted copia un bloque de configuración en su VirtualHost. | Los bots de IA reciben HTML optimizado en las rutas de AgentFi. |
Cloudflare Worker#
Elija entre despliegue automático o manual.
Automática#
Seleccione un token de API de Cloudflare guardado y AgentFi despliega el Worker por usted. Es la opción más rápida. La zona que coincida con su dominio se detecta automáticamente.
- Agregue un token de Cloudflare
Vaya a Cloudflare API Tokens → Create Token y use la plantilla «Edit Cloudflare Workers». Pegue el token en el panel. Los tokens guardados se administran en Ajustes de la cuenta → Tokens de Cloudflare.
- Confirme la zona detectada
AgentFi busca la zona que corresponde a su dominio dentro de esa cuenta y la muestra.
- Pulse «Desplegar Worker»
El Worker se crea y se enlaza a la ruta de su dominio.
Si el panel muestra Zona no encontrada, el token pertenece a una cuenta de Cloudflare que no gestiona ese dominio. Las salidas son: agregar un token de la cuenta correcta, añadir el dominio a esa cuenta de Cloudflare, o conceder al token permisos de Zone Read sobre el dominio.
Si ya existe una ruta de Worker para el mismo patrón, AgentFi avisa de un conflicto de rutas e indica a qué worker está asignada. Desplegar sobrescribirá esa ruta. Compruebe en su panel de Cloudflare que el worker existente no es crítico antes de continuar; hay que marcar una casilla de confirmación explícita.
Manual#
Si prefiere no compartir sus credenciales de Cloudflare, descargue el script y despliéguelo usted mismo. El script viene preconfigurado con el ID de su cuenta y sus ajustes; no necesita modificaciones.
- Descargue el script del Worker desde el panel.
- Despliéguelo con la CLI de Wrangler o pegándolo en el panel de Cloudflare, y configure la ruta que el panel le indica.
- Vuelva al panel y pulse Continuar para pasar a la verificación.
Nginx y Apache autoalojados#
AgentFi genera un bloque de configuración listo para pegar en el vhost que sirve su dominio. El flujo tiene tres pasos:
- Configuración del proxy
Copie el bloque generado en su vhost y recargue el servidor. El panel sugiere un nombre de archivo.
- Prompt para el agente de IA
AgentFi también genera un prompt que puede pegar en un agente con acceso SSH a su servidor (Claude, ChatGPT, Cursor). El agente instalará la configuración, la validará y recargará el servidor.
- Verificar y activar
Cuando el endpoint
/verifyresponda correctamente, pulse el botón. El panel incluye un botón Probar el endpoint /verify.
Si el Cloudflare Worker sigue activo, seguirá interceptando todas las solicitudes en el edge de Cloudflare y su configuración de Nginx o Apache nunca verá el tráfico. El orden de migración sin tiempo de inactividad es: (1) instalar la configuración en el origen y recargar; (2) confirmar que la URL de estado se resuelve a través de su origen; (3) Zona de peligro → Desconectar Cloudflare; (4) Verificar y activar.
Paso 2: verificar y activar#
AgentFi envía una solicitud de prueba a su proxy para confirmar que responde correctamente y luego activa la integración con supervisión de estado automática cada 10 minutos. El endpoint que se comprueba se muestra en pantalla.
Si la verificación falla, el panel indica qué URL se comprobó y ofrece un enlace a la guía de solución de problemas. Asegúrese de que el Worker esté desplegado y de que la ruta esté activa en su dominio.
Estado de la integración#
| Estado | Significado |
|---|---|
| Integración activa | El proxy responde y las comprobaciones pasan. |
| Integración en pausa | Usted la pausó. El proxy no interviene; el tráfico va directo a su sitio. |
| Integración con fallos | La comprobación de estado falló. Revise la fecha de la última comprobación y el mensaje de error. |
| Sin conectar | El proxy todavía no se ha desplegado. |
La píldora de estado también aparece de forma permanente en la barra superior del panel.
Ajustes#
Contrato de edge desactualizado#
Si AgentFi actualiza el contrato de edge, el panel muestra un aviso pidiendo que vuelva a generar e instalar la configuración de su proxy. El botón Regenerar configuración produce la versión nueva.
Zona de peligro#
Desconectar Cloudflare elimina el Worker de su cuenta y restablece la integración. A partir de ese momento los bots de IA reciben su sitio original, sin optimizar, y los archivos gestionados dejan de servirse.
Comprobación final#
Con la integración activa, verifique el resultado desde fuera del panel:
- Abra
https://su-dominio.com/llms.txt— debe devolver el índice generado. - En Páginas, use Vista previa del HTML AIO sobre una página optimizada y compárela con Ver original.
- Pasados unos días, revise Tráfico de bots: debería ver visitas con código 200 de GPTBot, ClaudeBot o PerplexityBot.