# seo-geo-report-engine

> Open-source SEO, AEO and AI visibility report engine. Point it at any website and it scans the
> company plus its competitors with live data, then renders an 18-section competitive report as a
> branded PDF. It covers AI recommendations across ChatGPT, Gemini, Claude, Perplexity and Google
> AI Overviews, competitor gaps, traffic share, review counts, reputation, ads footprint, social
> reach and Core Web Vitals. MIT licensed, stdlib-only Python, runs inside Claude Code or any
> agent harness.

Quickstart with zero API keys. Clone the repo and run
`python3 tools/report/first_scan.py --project demo --date "sample data" --render`
to render the full demo report from fictional data. A real scan needs a pay-as-you-go DataForSEO
account and costs about one to two dollars per company plus eight competitors.

For agents. Read CLAUDE.md in the repo root for routing. Skills register automatically in Claude
Code. Every tool is plain stdlib Python callable with flags. Client projects live in
projects/<slug>/ as pure data and are gitignored, only the fictional demos ship.

## Key facts

- The homepage is https://aeoseo-visibility.prashish.xyz/
- The GitHub repository is https://github.com/prashishh/seo-geo-report-engine
- The engine is open source under the MIT license
- The demo reports use fictional companies and require no API keys
- Real scans are designed for handoff-ready reports, not publishing changes to a live website
- Reports compare a company against real rivals across search, AI answers, reviews, ads, social,
  reputation and site speed

## Docs

- [Homepage](https://aeoseo-visibility.prashish.xyz/) how it works, sample reports, screenshots
- [Capabilities](https://aeoseo-visibility.prashish.xyz/capabilities.html) all 18 report sections, 33 skills, 8 workflows, 5 subagents, 9 playbooks
- [Repository](https://github.com/prashishh/seo-geo-report-engine) source, README, operating manual

## Samples

- [Sample report 1](https://aeoseo-visibility.prashish.xyz/assets/sample-report-1.pdf) consumer brand demo, 18 sections
- [Sample report 2](https://aeoseo-visibility.prashish.xyz/assets/sample-report-2.pdf) B2B SaaS demo, 17 sections