Referencia para desarrolladores
causabi-geo es una CLI de código abierto (MIT) que revisa cómo leen una página los rastreadores de IA y genera archivos de corrección listos para publicar, en local y sin cuenta. La revisión de todo el sitio y el monitoreo continuo están en causabi.com.
Actualizado:
Inicio rápido
pip install causabi-geo geo-optimizer analyze https://yourdomain.com
causabi-geo es el nombre del paquete y el comando es geo-optimizer (desde la v0.2.1, causabi-geo también funciona como alias).
Comandos de la CLI
# Analyze — puntaje de IA de 0 a 100 y lista de problemas geo-optimizer analyze https://yourdomain.com geo-optimizer analyze https://yourdomain.com --json # Score — alias de analyze geo-optimizer score https://yourdomain.com # Fix — genera archivos listos para publicar geo-optimizer fix https://yourdomain.com geo-optimizer fix https://yourdomain.com --output ./geo-fixes # Fix con un FAQ redactado por IA (requiere una clave de la API de Gemini) geo-optimizer fix https://yourdomain.com --api-key YOUR_GEMINI_KEY
fix escribe robots.txt (corregido para dejar pasar a los rastreadores de IA), schema.json, llms.txt, faq-schema.json (con --api-key) y HOW-TO-APPLY.md.
Qué mide el puntaje
La CLI puntúa seis categorías: acceso de los rastreadores de IA en robots.txt (20), Schema.org completo (25), FAQ schema (20), profundidad del contenido (15), señales de marca y contacto (10) y actualidad (10). El puntaje alojado en causabi.com usa otros pesos (los puntos por categoría del panel son distintos), suma revisiones de llms.txt y de accesibilidad, y distingue los rastreadores de entrenamiento, de búsqueda y de agentes. El puntaje mide qué tan legible es tu página para las máquinas. No predice ni garantiza citas.
Servidor MCP
El servidor MCP permite que Claude Code, Claude Desktop, Cursor y cualquier cliente compatible con MCP revisen tu puntaje de IA y generen archivos de corrección desde el editor. Funciona en local por stdio.
# Claude Code claude mcp add geo-optimizer -- npx -y geo-optimizer-mcp # Luego pregunta: # > Revisa el puntaje de IA de example.com
Configuración por archivo para otros clientes: geo-optimizer-mcp en GitHub.
API alojada
Hay un endpoint público del puntaje, sin necesidad de clave:
curl https://ai.causabi.com/api/score/yourdomain.com
Los endpoints con autenticación (revisiones completas, monitoreo, generación de archivos) necesitan una clave de API. Créala en la configuración del panel. Mira ejemplos de integración en /for-developers.
Preguntas frecuentes
¿Qué es causabi-geo?
causabi-geo es una CLI de código abierto (MIT) que revisa cómo leen una página los rastreadores de IA y genera archivos de corrección listos para publicar, en local y sin cuenta. La revisión de todo el sitio y el monitoreo continuo están en causabi.com.
¿Cómo se instala y qué comando se ejecuta?
Ejecuta pip install causabi-geo y luego geo-optimizer analyze https://yourdomain.com. causabi-geo es el nombre del paquete y el comando es geo-optimizer (desde la v0.2.1, causabi-geo también funciona como alias).
¿Qué archivos escribe el comando fix?
fix escribe robots.txt (corregido para dejar pasar a los rastreadores de IA), schema.json, llms.txt, faq-schema.json (con --api-key) y HOW-TO-APPLY.md.
¿Qué mide el puntaje y predice las citas?
La CLI puntúa seis categorías: acceso de los rastreadores de IA en robots.txt (20), Schema.org completo (25), FAQ schema (20), profundidad del contenido (15), señales de marca y contacto (10) y actualidad (10). El puntaje alojado en causabi.com usa otros pesos (los puntos por categoría del panel son distintos), suma revisiones de llms.txt y de accesibilidad, y distingue los rastreadores de entrenamiento, de búsqueda y de agentes. El puntaje mide qué tan legible es tu página para las máquinas. No predice ni garantiza citas.
¿Cómo reviso mi puntaje de IA desde un editor?
El servidor MCP permite que Claude Code, Claude Desktop, Cursor y cualquier cliente compatible con MCP revisen tu puntaje de IA y generen archivos de corrección desde el editor. Funciona en local por stdio. En Claude Code, ejecuta claude mcp add geo-optimizer -- npx -y geo-optimizer-mcp y luego pide el puntaje de IA de un dominio.
¿Hay una API pública y necesita clave?
Hay un endpoint público del puntaje, sin necesidad de clave: curl https://ai.causabi.com/api/score/yourdomain.com. Los endpoints con autenticación (revisiones completas, monitoreo, generación de archivos) necesitan una clave de API, que se crea en la configuración del panel.