Summary

Voyage-GEO is an open-source CLI tool designed for Generative Engine Optimization, acting as SEO analytics for AI search engines. It helps brands understand how AI models like ChatGPT, Claude, and Gemini reference and recommend them, providing crucial insights into AI-driven search visibility and brand perception. The tool targets marketers, SEO professionals, and businesses seeking to monitor and improve their presence within the evolving landscape of AI-generated content and recommendations.

How It Works

The engine follows a structured pipeline: it first scrapes the brand's website to build a comprehensive profile including competitors and keywords. Next, it generates realistic, brand-blind search queries designed to mimic user intent. These queries are then executed against multiple AI models, accessible via OpenRouter or direct API keys. The results are analyzed for mention rates, sentiment, mindshare, and competitor positioning. Finally, interactive HTML reports, alongside JSON, CSV, and Markdown exports, are generated to present these findings. This approach offers a novel way to measure and manage brand performance in AI search.

Quick Start & Requirements

• Prerequisites: Python 3.11+ and an OpenRouter API key (or individual provider API keys).
• Installation: Install via pip: pip install voyage-geo. Alternatively, clone the repository and install from source.
• Configuration: Copy .env.example to .env and set OPENROUTER_API_KEY.
• Execution: Run analyses using python3 -m voyage_geo run -b "YourBrand" -w "https://yourbrand.com" --no-interactive.
• Documentation: Links to Quick Start, Claude Code, CLI Reference, Models, Docs, and Sample Reports are available within the repository.

Highlighted Details

• Supports major AI models including ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok, and Llama, accessible via OpenRouter or direct API keys.
• Offers an alternative BlockRun integration for pay-per-request access to over 30 models using cryptocurrency micropayments.
• Generates comprehensive reports in HTML, JSON, CSV, and Markdown formats, featuring interactive charts.
• Provides an integrated skill for AI agents like Claude Code and OpenClaw, and includes an optional local GUI (pip install "voyage-geo[app]").

Maintenance & Community

The project includes a CONTRIBUTING.md file for guidelines. Specific community channels (e.g., Discord, Slack) or details on notable contributors and sponsorships are not detailed in the provided README.

Licensing & Compatibility

The project is licensed under the MIT license, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

The README does not explicitly detail limitations such as alpha status or known bugs. Users should be aware of potential costs associated with API key usage for AI model access.