Turn any URL into a full competitive report

See where your product stands, who is winning its buyers, and what to do about it

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

How it works

Give it a website. 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. Who owns the category's traffic. Which links competitors have that you are missing, and which are worth chasing. Which keywords are wide-open greenfield nobody has claimed. 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 demo report costs nothing and needs no accounts. 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: 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.


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 this actually check?

It checks how visible a company is across classic search and AI answers. Rankings, backlinks, traffic share, reviews, ads, social reach, site speed, and whether ChatGPT, Gemini, Claude, Perplexity and Google AI Overviews recommend the brand or its competitors.

Does it recommend new keywords to target?

Yes. It builds a keyword and greenfield map scored by real search demand, how hard each term is to rank for, and how well it fits the business. It flags the terms competitors already rank for that the company does not, then ranks the wide-open, winnable ones first, the demand nobody has claimed yet.

What does it tell me about my competitors?

A full read on what each rival is doing. The pages winning them the most traffic, their funding and hiring activity, their live Google Ads count, where their backlinks come from, and the complaint that keeps showing up in their reviews, the exact weak point a comparison page or an outreach email can target.

How much does it cost to run?

The software is free and MIT licensed. The demo report renders with no accounts at all. A real scan of one company plus about eight competitors costs one to two dollars in pay-as-you-go API credit.

What is GEO?

GEO stands for generative engine optimization, the practice of making a brand visible and citable inside AI answers. It is the AI-era counterpart to SEO, and this engine measures both.

Is this just a scorecard, or does it tell me what to do next?

The point is a plan, not just a score. The closing section turns every gap into a sequenced set of moves, which keyword clusters to build first, which AI answers to chase, which links to go after, ranked by how much demand sits behind each one and how winnable it actually is right now.

Does it surface anything I would not find on my own?

Often, yes. Press coverage that never turned into an actual link. A competitor's backlink count inflated by low-quality directories rather than real authority. A strong rating sitting on almost no reviews. These are the small, easy-to-miss findings that tend to become the fastest wins for growing a company's digital presence.

Can I get the report without installing anything?

Yes. Email your website to namaste@prashish.xyz and the first scan comes back as soon as possible.


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