Solución de problemas
Los problemas habituales y cómo resolverlos, agrupados por dónde aparecen.
Rastreo y descubrimiento de páginas#
El rastreo encuentra muy pocas páginas#
- Compruebe la tarjeta Sitemap del Resumen. Si dice No encontrado, publique un
sitemap.xml: es la causa más frecuente y la de mayor impacto. - Revise el máximo de páginas del sitio. Si lo fijó bajo para una prueba, súbalo.
- Confirme que no ha agotado el límite de páginas por sitio de su plan.
- Revise que
robots.txtno bloquee las rutas que le interesan.
El rastreo falla#
El mensaje El rastreo falló suele deberse a que el sitio no responde, a un certificado SSL inválido o a un firewall que bloquea al rastreador. Revise los avisos de configuración del Resumen, que suelen nombrar la causa concreta.
Aviso de redirección con cookies#
Si su sitio responde con un 302 y establece cookies antes de servir contenido, el rastreador de AgentFi lo gestiona automáticamente, pero los agentes externos (GPTBot, ClaudeBot, PerplexityBot) recibirán la portada en lugar de la página solicitada. Es un problema real que hay que resolver en el servidor: los bots deben recibir la página pedida sin pasar por una redirección con cookies.
Aviso de certificado SSL#
Si el sitemap se detectó usando TLS relajado, los bots de IA con validación estricta de certificados podrían no poder acceder. Revise la cadena de certificados de su dominio: falta casi siempre el certificado intermedio.
Optimización#
Páginas en «Optimización fallida»#
- Use Reintentar todas desde Páginas: muchos fallos son transitorios.
- Si persiste en páginas concretas, revise su contenido: páginas casi vacías o cargadas íntegramente por JavaScript no dan material suficiente al modelo.
- Compruebe que le quedan optimizaciones en el paquete mensual.
El contenido optimizado no me convence#
- Use Actualizar contenido en esa fila y describa el ajuste concreto.
- Para un cambio que afecte a todo el sitio, edite las reglas de optimización personalizadas en el diálogo de Optimizar todas: quedan guardadas y se aplican en adelante.
- Si el original cambió, use Volver a rastrear el origen antes de volver a optimizar.
Se agotó el paquete de optimizaciones#
La optimización manual se pausa hasta el siguiente periodo. La optimización automática continúa, pero pasa a gastar tokens. Las salidas son esperar al reinicio de la cuota, mejorar el plan o reducir el alcance excluyendo páginas que no aporten.
Integración#
La verificación del dominio no pasa#
- Confirme que el registro es TXT, no CNAME ni A.
- Confirme que el nombre es
@o su dominio sin subdominios. - Compruébelo desde fuera:
dig +short TXT su-dominio.com. - Espere: la propagación puede tardar hasta 24 horas, aunque suele ser cuestión de minutos.
Zona de Cloudflare no encontrada#
El token pertenece a una cuenta que no gestiona ese dominio. Tres salidas:
- agregar un token de la cuenta de Cloudflare que sí gestiona el dominio;
- añadir el dominio a la cuenta de Cloudflare del token que ya tiene;
- conceder a ese token permisos de Zone Read sobre el dominio.
Falta un permiso en el token de Cloudflare#
El panel nombra el permiso que falta. Abra los ajustes del token en Cloudflare, agregue ese permiso y vuelva a añadir el token en AgentFi: el token guardado no recoge los permisos nuevos por sí solo.
Conflicto de rutas#
Ya existe una ruta de Worker para el mismo patrón, asignada a otro worker. Desplegar la sobrescribirá. Compruebe en su panel de Cloudflare que ese worker no es crítico antes de marcar la casilla de confirmación.
Instalé Nginx o Apache y no pasa nada#
Casi siempre es porque el Cloudflare Worker sigue activo e intercepta todo en el edge, de modo que su configuración de origen nunca ve el tráfico. Siga el orden de migración descrito en Integración: instalar y recargar el origen, confirmar que responde, Desconectar Cloudflare, y solo entonces Verificar y activar.
La verificación del proxy falla#
- Confirme que el Worker está desplegado y que la ruta está activa en su dominio.
- Use el botón Probar el endpoint /verify del panel.
- Revise la URL exacta que el panel dice haber comprobado: un error de ruta base es frecuente.
La integración aparece «con fallos»#
La supervisión automática se ejecuta cada 10 minutos. Revise la fecha de la última comprobación y el mensaje de error. Un fallo puntual puede ser una indisponibilidad momentánea; uno persistente indica que el Worker se eliminó, la ruta cambió o el origen no responde.
Archivos de descubrimiento#
llms.txt no se genera#
Si el modo es Gestionado por AgentFi pero no hay ninguna página optimizada, el archivo no se puede construir. Optimice al menos algunas páginas y vuelva a intentarlo.
El archivo no aparece en mi dominio#
- Compruebe que la integración está activa: los archivos gestionados los sirve el proxy.
- Compruebe que el modo del archivo es Gestionado por AgentFi y no Usar el original del sitio.
- Pulse Volver a detectar y luego abra la URL directamente en el navegador.
Visibilidad#
Todas las consultas salen «No mencionado»#
- Revise la cobertura de optimización: si es baja, los modelos tienen poco contenido suyo que citar.
- Confirme que la integración está activa y que Tráfico de bots muestra visitas con código 200.
- Dé tiempo a los rastreadores: el contenido optimizado tarda en entrar en los índices de los modelos.
- Revise las consultas de búsqueda usadas por el motor en el detalle de una consulta: le dirán con qué términos le está buscando el modelo y qué le falta cubrir.
Los resultados cambian entre ejecuciones#
Los motores de IA no son deterministas. La misma consulta puede dar resultados distintos en dos ejecuciones seguidas. Mire la tendencia sobre varias ejecuciones, no una prueba aislada.
Muchos «Error del motor»#
Indica que el proveedor no devolvió una respuesta utilizable: caída, tiempo de espera o filtro de contenido. No penaliza su porcentaje. Si se repite de forma masiva en un motor concreto durante varios días, es un problema del lado del proveedor.
La columna de Claude está vacía#
La búsqueda con Claude AI es exclusiva del plan Business. Business
Consumo y facturación#
Los tokens se agotan mucho antes de lo esperado#
- Abra Historial de cambios y filtre por Programado: verá el consumo de cada ejecución.
- Revise la frecuencia de las pruebas automáticas. Diaria × 40 consultas × 4 motores son unos 4.800 tokens al mes.
- Revise si la optimización automática agotó el paquete y pasó a gastar tokens.
- Fije un límite mensual de tokens en la optimización automática.
Aparece «consumo excedente» en rojo#
Ha superado los tokens incluidos y el gasto adicional se factura a la tarifa por token de su plan. La barra lateral muestra los tokens extra y el importe. Para detenerlo, pause las programaciones o fije un límite mensual.
Acceso#
Veo «Sin acceso a sitios»#
Existen sitios en la organización, pero su usuario no tiene permiso sobre ninguno. Pida a un propietario o administrador que se lo conceda en Equipo.
No veo la sección de Administración#
Es normal: solo aparece para usuarios con rol de administrador.
No puedo cambiar de plan#
Si su plan está marcado como Asignado por admin, lo gestiona la administración de su organización.