How auriti-labs/geo-optimizer-skill works
GEO Optimizer is a toolkit for assessing and improving a website’s visibility to AI answer engines. Its main workflow is a user invoking an audit, the audit engine evaluating the target site and scoring its readiness, then returning prioritized findings. Separate capabilities generate fixes and llms.txt, check real AI citations, track changes, and expose the toolkit through web, MCP, and Astro interfaces. The map follows documented capabilities and sampled entry points; several internal call relationships are omitted where implementation excerpts were unavailable.
Main entry points: audit.py Full site audit · main.py CLI entry · app.py Web app · audit_cmd.py Audit command
Components 26
User interfaces
- CLI entry
src/geo_optimizer/cli/main.py - Audit command
src/geo_optimizer/cli/audit_cmd.py - Web app
src/geo_optimizer/web/app.py - MCP tools
src/geo_optimizer/mcp/server.py - Web frontend
frontend/src - llms generator UI
frontend/src/components/tools/LlmsTxtGenerator.tsx - Frontend API client
frontend/src/lib/api.ts
Audit and scoring
- Full site audit
src/geo_optimizer/core/audit.py - Audit checks
src/geo_optimizer/core - Robots parser
src/geo_optimizer/utils/robots_parser.py - Scoring engine
src/geo_optimizer/core/scoring.py - Audit results
src/geo_optimizer/models/results.py
Optimization tools
- Fix command
src/geo_optimizer/cli/fix_cmd.py - Fix generation
src/geo_optimizer/core/fixer.py - llms command
src/geo_optimizer/cli/llms_cmd.py - llms generator
src/geo_optimizer/core/llms_generator.py - Citation command
src/geo_optimizer/cli/citations_cmd.py - Citation analysis
src/geo_optimizer/core/citations.py
Monitoring and history
- Monitor command
src/geo_optimizer/cli/monitor_cmd.py - Site monitoring
src/geo_optimizer/core/monitor.py - Audit history
src/geo_optimizer/core/history.py
Service integrations
- LLM client
src/geo_optimizer/core/llm_client.py - Astro integration
integrations/astro-geoready/index.mjs
Other components
- User
- Target website
- AI providers
Connections 29
- User → CLI entry: invokes
- CLI entry → Audit command: dispatches
- Audit command → Full site audit: runs audit
- Full site audit → Target website: fetches pages
- Full site audit → Audit checks: evaluates
- Audit checks → Robots parser: parses rules
- Full site audit → Scoring engine: scores findings
- Full site audit → Audit results: returns results
- User → Web app: requests audit
- Web app → Full site audit: runs audit
- User → MCP tools: calls tools
- MCP tools → Full site audit: runs audit
- CLI entry → Fix command: dispatches
- Fix command → Fix generation: generates fixes
- Fix generation → Target website: inspects site
- CLI entry → llms command: dispatches
- llms command → llms generator: generates text
- llms generator → Target website: reads sitemap
- CLI entry → Citation command: dispatches
- Citation command → Citation analysis: analyzes citations
- Citation analysis → LLM client: queries engines
- LLM client → AI providers: sends prompts
- CLI entry → Monitor command: dispatches
- Monitor command → Site monitoring: checks visibility
- Web frontend → Web app: calls API
- User → llms generator UI: submits site
- llms generator UI → Frontend API client: requests generation
- Frontend API client → Web app: calls API
- Astro integration → Target website: generates site files