Turn any URL into a full competitive report

The SEO, AEO and AI Visibility Report Engine is an open-source tool that turns a website into a report on search visibility, AI recommendations, competitor gaps, reviews, reputation, ads, social reach and site speed.

Email me for a report View on GitHub Sample report 1 (PDF) Sample report 2 (PDF) All capabilities


What it looks like

Both sample reports come from the fictional demo companies that ship with the repo, so you can reproduce every page yourself before adding a single API key.

Report opening page with headline findings and a domain authority chart
Every headline on the opening spread is computed from the scan's own numbers
Greenfield opportunity map plotting demand against winnability for buyer queries
The greenfield map plots demand against winnability for every buyer query in the niche
AI visibility matrix showing eight buyer questions across five AI engines
The AI visibility matrix checks eight buyer questions across five engines, cell by cell
Report page showing competitor top traffic pages, review counts, ratings and complaints
Competitor pages, reviews, ratings and the complaint wedge all sit in the report
Report page showing live Google ads by company and social presence benchmarks
The ads footprint shows which rivals are buying attention before you spend a dollar

How it works

Start with any website. It can be yours, a client's, or a competitor's.

  1. It maps the field: You name the competitors, or let it find them from the site itself.
  2. It pulls the live numbers: Search rankings and traffic, backlinks, review counts and ratings, live Google Ads activity, social following, site speed, and what ChatGPT, Gemini, Claude, Perplexity and Google AI actually say when buyers ask for a recommendation.
  3. It finds the story: You see which competitors are getting found, which pages bring them traffic, which review gaps matter, which ads are live, and whether AI engines recommend you or your rivals, question by question.
  4. It writes the report: A branded PDF where every headline comes straight from the data. Send it as is, or edit it first. There is also a live dashboard if you would rather browse the data than read a deck.

Free to download and run. The included demo uses fictional sample data, so you can render the report without creating accounts or adding API keys. A real scan of a company plus eight competitors costs about one to two dollars in API credit.

# try it in two minutes, no API keys $ git clone https://github.com/prashishh/seo-geo-report-engine.git && cd seo-geo-report-engine $ python3 tools/report/first_scan.py --project demo --date "sample data" --render assembled first-scan report with 18 sections rendered -> projects/demo/deliverables/demo-first-scan.pdf
AccountWhat it powersCost
DataForSEOrankings, keywords, backlinks, AI answers, reviews, ads, speed testspay as you go, $1 to $2 per full scan
OpenRouterreputation themes and cited live researchoptional, cents
Apifysocial following and public profile dataoptional, free tier
PredictLeads, Open PageRank, Mozfunding signals and authority cross-checksoptional, free tiers

The report is one part of a larger kit. There are 33 skills and 8 workflows covering keyword research, comparison pages, programmatic SEO, growth proposals and recurring client reports. See everything it can do.


What the full scan covers

The first-scan report is built to show the whole competitive field, not just a health score. It checks search demand, backlinks, competitor pages, reviews, ad activity, social reach, site speed, and AI-answer visibility, then turns that into a prioritized plan.

AreaWhat you learn
AI searchwhether ChatGPT, Gemini, Claude, Perplexity and Google AI Overviews name you or competitors
Search demandwhich buyer queries exist, who ranks, and which greenfield terms are still open
Competitor pagesthe pages already pulling traffic for rivals, including home, category, comparison and editorial pages
Reviewsratings, review volume and recurring complaints that can become your switching wedge
Adswhich competitors are running live Google ads and where paid pressure is showing up
Authoritydomain strength, backlinks, link gaps and the outreach list worth handing to a team
PerformanceCore Web Vitals and site-speed gaps across the whole field
Show more capabilities

The 18 report sections

01Where you stand todayheadline findings computed from the scan
02Domain authoritytrust score for you and every rival
03Backlinks and the link gapwho links to your rivals but not to you, junk filtered out
04Press and awardscoverage you already have and whether it passes authority
05Traffic sharehow category organic visits split across the field
06Share of searchwho buyers look for by name
07The demand you are missingkeywords rivals rank for that you do not
08Rival funding and hiringwho raised, who is hiring, and where momentum points
09Search demand and the gaphighest-intent queries with volume and difficulty
10Greenfield opportunity mapdemand against winnability for buyer queries
11What competitors win witheach rival's top-traffic pages
12Reputation and the wedgeratings, review counts and recurring complaints
13Google Ads footprintwho is buying attention and how many live ads they run
14Social presencefollower benchmark on the channel that matters
15Site speedCore Web Vitals for the whole field
16AI share of voicehow often each brand is named across AI engines
17AI visibility matrixbuyer questions against five engines, cell by cell
18The opportunity and the planthe lanes to attack first

Skills and workflows

AI searchllm-visibility, geo-audit, aeo-content-patterns, ai-citation-sprint, serp-intel, web-research
SEOkeyword-research, competitor-analysis, backlink-analysis, technical-seo-audit, web-vitals, comparison-pages, programmatic-seo, schema-markup and more
Strategyfirst-scan-report, opportunity-map, market-opportunity, positioning-messaging, customer-research, proposal-builder
Operationsreport-generator, kpi-dashboard, agency-dashboard, seo-data-router, skill-navigator
Workflows/client-report, /new-client, /discovery-audit, /growth-plan, /growth-proposal, /competitor-watch, /weekly-report, /monthly-report

The dedicated capabilities page keeps the full reference in one place.


For AI agents

Working inside Claude Code, Codex, or another agent harness? Clone the repo and read CLAUDE.md for routing. The skills register automatically, every tool is plain stdlib Python with flags an agent can call directly, and a machine-readable summary lives at llms.txt. The capabilities page lists every skill, workflow and report section in one place.


Common questions

What does it check?

Search visibility, AI recommendations, competitor pages, traffic share, share of search, backlinks, reviews, reputation, ads, social reach, site speed, and the gaps between your company and its rivals.

Does it find new keywords for me?

Yes. It shows the search terms your rivals rank for and you do not, and ranks the easy wins first.

What does it tell me about my competitors?

Their best pages, funding and hiring signals, ad footprint, backlinks, and the complaints that keep showing up in their reviews.

How much does it cost?

The software is free. The included demo uses fictional sample data, so you can render it without creating accounts or adding API keys. A real scan of you plus 8 rivals costs about $1 to $2.

What are AEO and GEO?

AEO means structuring content so answer engines can use it directly. GEO means making a brand easier to find, understand and recommend inside AI answers from tools like ChatGPT, Gemini, Claude, Perplexity and Google AI Overviews.

Do I just get a score, or a plan?

You get a prioritized plan. The report shows which gaps to fix first across search, AI answers, reviews, ads, competitors, social reach and site speed.

Will it find things I missed myself?

Often, yes. It can surface competitor pages that quietly bring in traffic, review gaps that weaken trust, ad activity you did not know rivals were running, and backlink profiles that look strong until low-quality links are filtered out.

Who is this for?

Agencies, founders, consultants, and marketers who need a fast competitive SEO and AI-search read.

Do I need coding experience to use it?

The demo is simple to run, but real scans are easiest if you are comfortable running terminal commands and adding API keys.

Can I use this for client work?

Yes. It is MIT licensed and designed to produce handoff-ready client reports, briefs, page specs, schema, and strategy artifacts.

Does it publish anything to my website?

No. It creates reports and ready-to-implement recommendations. Your team still reviews, builds, and ships anything that goes live.

What data do I need before running a real scan?

Start with a target domain, known competitors if you have them, and API keys for live search, review, backlink, ads, AI-answer, and speed data.


Run it yourself

Clone the repo, add your keys, and the whole practice is yours. The skills, the report pipeline, and the playbooks that explain the methodology behind each one. MIT licensed, used in production, provided as-is.

github.com/prashishh/seo-geo-report-engine

Or have it run for you

Want this report for your company without touching a terminal? Email me your website and I will send the first scan back as soon as possible.

namaste@prashish.xyz