Causabi developer reference
causabi-geo is an open-source (MIT) CLI that checks how AI crawlers read a page and generates ready-to-deploy fix files, locally and without an account. Whole-site checks and continuous monitoring run on causabi.com.
Updated:
Quickstart
pip install causabi-geo geo-optimizer analyze https://yourdomain.com
causabi-geo is the package name; the command is geo-optimizer (causabi-geo also works as an alias since v0.2.1).
CLI commands
# Analyze — AI score 0-100 + issue list geo-optimizer analyze https://yourdomain.com geo-optimizer analyze https://yourdomain.com --json # Score — alias for analyze geo-optimizer score https://yourdomain.com # Fix — generates ready-to-deploy files geo-optimizer fix https://yourdomain.com geo-optimizer fix https://yourdomain.com --output ./geo-fixes # Fix with an AI-generated FAQ (requires a Gemini API key) geo-optimizer fix https://yourdomain.com --api-key YOUR_GEMINI_KEY
fix writes robots.txt (patched to let AI crawlers in), schema.json, llms.txt, faq-schema.json (with --api-key) and HOW-TO-APPLY.md.
What the score measures
The CLI scores six categories: robots.txt access for AI crawlers (20), Schema.org completeness (25), FAQ schema (20), content depth (15), brand and contact signals (10), freshness (10). The hosted score on causabi.com uses different weights, adds llms.txt and accessibility checks and tells training, search and agent crawlers apart. The score measures how readable your page is for machines. It does not predict or guarantee citations.
MCP server
The MCP server lets Claude Code, Claude Desktop, Cursor and any MCP-compatible client check your AI score and generate fix files from the editor. It runs locally over stdio.
# Claude Code claude mcp add geo-optimizer -- npx -y geo-optimizer-mcp # Then ask: # > Check the AI score for example.com
Config-file setup for other clients: geo-optimizer-mcp on GitHub.
Hosted API
A public score endpoint is available without a key:
curl https://ai.causabi.com/api/score/yourdomain.com
Authenticated endpoints (full checks, monitoring, file generation) need an API key. Create one in the dashboard settings. See /for-developers for integration examples.