SEO reports for audits and analysis
Choose an SEO report for a site audit, lost clicks, keyword research, competitors, indexing, links, local search, or AI search visibility.
Run the main report first
seo report --project example
seo report --url https://example.com
seo refresh-priorities --project example
seo quick-wins --project example
seo technical-watch --project example
Run seo report when you need to know what deserves attention across the site.
Use a focused report when you already know the problem: lost clicks, a broken
URL, weak page-one CTR, page-two rankings, competitor research, keyword gaps,
or a technical change after a release.
seo report --url runs the technical checks without Search Console. Add
--site or use a saved project when you want search performance included.
How report data works
Some services limit how much data they return or hide searches for privacy. The report tells you when that happened. Missing data means unknown, not zero.
Search Console and Google Analytics describe activity on a site you control. Keyword tools and current search results add outside estimates and observations. They can help you investigate, but they cannot promise rankings or traffic.
Those rules apply to every report, so individual report pages only call out a limit when it changes how you should use that particular result.
Choose a report for a specific job
The catalog includes 74 reports across 9 categories. Browse the list below or ask the installed package for the current report names and options.
Use these commands when you need the exact options for an agent or script:
seo reports list --json
seo reports list --category crawl --json
seo reports describe audit-page --json
seo reports run audit-page --params '{"url":"https://example.com"}' --json
Agents using MCP should call seo_list_reports, seo_describe_report, and
then seo_run_report.
Optional research providers add country-level keyword, domain, page and competitor estimates. The research provider guide explains how to connect one and set spending limits.
When the result needs to become a client deliverable, use the HTML report guide. The CLI can generate a fixed standalone file, or an agent can create a custom layout from the same report.
Crawl & page checks
Crawl a whole site or inspect selected pages for technical problems your agent can fix.
Check sitemap URL status, redirects and access first. Run the full technical SEO crawl only when you need page content, links, metadata and affected URLs.
site-crawlAudit one URL for technical SEO, metadata, canonicals, schema, links and Search Console queries. See the live evidence before changing the page.
audit-pageRun the same technical SEO checks across an exact list of URLs for a release, migration or template sample without opening the crawl to the whole site.
audit-urlsFollow every redirect hop from one URL to its final page and check status codes, loops, chains, canonicals and link safety before updating links.
redirect-traceRun Lighthouse for one URL, add available CrUX field data and see the Core Web Vitals evidence behind the highest-impact fixes for one page.
performance-auditCrawl findings
Turn a crawl finding into affected URLs, understand the rule, and inspect saved evidence.
Rank technical SEO issues using crawl severity, affected pages and available search evidence so the next fix has a clear reason and supporting evidence.
top-fixesFind every URL affected by a technical SEO issue, inspect the crawl evidence on each page and turn one broad finding into a practical fix list.
affected-urlsLook up one technical SEO crawler rule in plain English. See why it may matter, how to fix it and what to check on a live page after the change.
explain-crawl-issueBrowse the technical checks built into the SEO crawler and find the exact rule ID needed for plain-English guidance or affected URLs from a saved crawl.
crawler-rulesList saved SEO crawls by site and date, compare their scope and choose the right local snapshot before opening its pages or comparing two runs.
crawl-historyOpen a saved SEO crawl by site or report ID and inspect its coverage, issues and affected pages without fetching the site or changing the saved result.
crawl-reportIndexing & monitoring
Find indexing candidates, compare crawls, and catch technical changes after a release.
Repeat a limited crawl and compare it with the previous run to find technical SEO issues that appeared, changed or disappeared after a release.
crawl-diffCompare two saved SEO crawls to find new, fixed and changed technical issues. Check the crawl scope before treating the difference as real or complete.
compare-crawlsCompare crawl, sitemap and Search Console evidence to find page groups that need a closer Google URL Inspection check before spending limited quota.
index-coveragePlan a representative Google URL Inspection sample across sitemaps and page groups without spending the daily API quota or guessing which pages matter.
index-coverage-planCollect a limited set of Google URL Inspection snapshots, save them locally and keep deferred or failed pages separate from checked URLs in the report.
index-monitorCompare current Google URL Inspection results with saved snapshots to find selected pages whose index status or canonical changed since the last check.
index-watchFind meaningful Bing traffic trends, crawl changes, and query and page opportunities with explicit provider coverage, limits, and clear verification steps.
bing-webmaster-overviewReview limited referring URLs, target pages and anchor text from Ahrefs, DataForSEO, Bing Webmaster or a local export, with source limits kept visible.
link-evidenceStream a local combined or JSONL access log to review observed search and AI crawler requests, response errors and paths without retaining raw events.
server-log-analysisRun recurring crawl, index and link checks together to find technical SEO changes while keeping missing or quota-limited evidence visible on every run.
technical-watchSearch opportunities
Combine searches already associated with the site and independent keyword estimates to choose what deserves a closer look.
Turn a topic into a focused keyword and competitor shortlist using demand, current rankings, Ahrefs Domain Rating and optional link evidence.
competitive-opportunitiesDiscover market-specific keyword ideas from a small seed list with search volume, difficulty, source overlap, provider coverage, cache status and cost.
keyword-researchCompare search volume, trends, CPC, competition, difficulty, intent and result counts for a list of keywords in one country and language before deeper research.
keyword-metricsReview saved keyword research, stale provider metrics, tags and page mappings from one local project set without repeating paid provider requests.
saved-keywordsInspect exact organic ranks, domains, URLs, titles, snippets and result features for one keyword, location, language and device-specific search snapshot.
serp-resultsTrack exact organic positions for a saved keyword set by location and device. Compare ranking changes with local history, coverage and provider cost.
rank-trackingReview estimated organic traffic, ranked keywords and ranking distribution for a domain, with optional matching Search Console evidence kept separate.
domain-overviewRetrieve one attributed Ahrefs Domain Rating observation for a domain or URL, with its target mode, license, cache state, coverage and limits kept visible.
domain-ratingReview a limited domain or page keyword footprint with ranking URLs, demand estimates, provider limits and optional matching Search Console query evidence.
ranked-keywordsSee which pages carry a domain's estimated search footprint, which URL patterns repeat and how matching pages on your own site perform in Search Console.
ranking-pagesFind domains that repeatedly appear for an explicit keyword set, preserve declared site types, and leave unknown search competitors safely unclassified.
serp-competitorsCompare competitor keywords with Search Console themes, current rankings and repeated page patterns. Exclude irrelevant terms and evidence of existing coverage.
competitor-keyword-gapCombine Search Console quick wins, second-page queries and striking-distance evidence with optional keyword estimates and programmatic SEO clusters.
keyword-opportunitiesFind local Search Console queries, landing pages and repeated templates. Add measured visitor geography or a few exact local results only when needed.
local-search-demandFind repeatable searches in Search Console, then check planned comparisons, tools, templates and location pages to see what exists and what may be missing.
pseo-patternsResearch ways to expand an existing programmatic page system with Search Console, keyword ideas, current results and competitor pages before building more.
pseo-opportunitiesFind page-one queries with useful impressions and weaker CTR evidence, then inspect the search result before changing titles, snippets or page copy.
quick-winsGroup Search Console queries around positions 11 to 20 into focused content, snippet, internal link and template review actions for each page.
striking-distanceFind URLs and queries averaging positions 11 to 20, then inspect whether content, links, snippets or technical issues deserve attention on each page.
second-pageCompare matched Search Console periods to find pages and queries losing clicks, impressions, position or CTR before planning a content refresh.
decaying-pagesFind high-impression Search Console queries with weaker CTR than expected for their position. Review the real result before rewriting a snippet.
ctr-underperformersCompare one URL with its Search Console queries and live page evidence to find focused content, CTR and coverage opportunities before rewriting the page.
page-opportunitiesContent & internal links
Find competing pages, weak internal links, and query groups that deserve clearer content.
Find Search Console queries associated with competing URLs and inspect where impressions, clicks or intent may be split across several pages.
cannibalisationFind pages with related search demand that may deserve an internal link to a target URL. Inspect the source page for context and intent before adding anything.
internal-linksBuild a content brief from one page, its Search Console queries and the headings or topics already present. Keep every suggestion tied to demand.
content-optimizationGroup returned Search Console queries into repeated demand themes so content gaps, templates and competing pages are easier to inspect across the site.
query-clustersFind broken URLs and weak redirects that still have Search Console value, then decide which pages to restore, redirect or leave alone using search evidence.
link-recoveryFind Search Console queries with forum, review, comparison or discussion intent so your content can answer the format people are looking for.
community-intentAI search visibility
Find technical restrictions, improve machine-readable context, and measure AI referral traffic.
Check Markdown alternatives, agent discovery, crawler access and identity across a content site. Find broken routes without inventing a readiness score.
agent-readinessCompare provider-indexed AI mentions, cited domains and question samples with optional Search Console evidence for one exact surface and market.
ai-mention-researchCheck fixed prompts against exact current AI models, retain answer and citation evidence locally, and compare only compatible observations over time.
ai-prompt-observationsScore crawl-based AI search readiness across access, indexability and page signals. Open every contributing check before trusting the number.
ai-search-scorecardCheck whether crawlers can access and use important pages in AI search. Find technical blockers without inventing a visibility or citation score.
ai-readinessCheck whether schema, authorship and brand details clearly connect the people, organisation and content across your site and find conflicting signals.
entity-readinessCheck the crawl, index, canonical and snippet controls used for Google AI search eligibility without predicting whether a page will be selected.
geo-gapsCheck whether llms.txt can be fetched and parsed, whether its links work and how well it covers useful pages before you publish or update it.
llms-txt-auditGenerate an llms.txt draft from useful crawled pages, then review the selected links and wording against the saved crawl before publishing the file.
generate-llms-txtTurn real Search Console queries into repeatable AI monitoring prompts so assistant answers can be checked against demand your site already sees.
seo-to-ai-queryFind visits from known AI assistants in Google Analytics, see which landing pages received them and keep missing referrers separate from confirmed traffic.
ai-referralsUnderstand performance
Work out where search performance moved, which part of the site explains it, and whether the change is unusual.
See what changed in Search Console and which pages, queries, countries or devices explain the movement before choosing what to investigate next.
search-performance-overviewCompare Search Console movement by page, query, country or device to find which segment explains a wider gain or loss across the selected dates.
segment-impactFind unusual Search Console movement, identify the pages and queries behind it and compare the dates with confirmed Google updates before a deeper check.
traffic-anomalyCompare unusual Search Console traffic dates with confirmed Google ranking updates without treating a matching date as proof of what caused the change.
update-correlationReports & priorities
Turn the evidence into a short work queue or a clear update for clients and teams.
Combine Search Console opportunities and crawl evidence into a ranked SEO work list with the reason and supporting report behind every item.
refresh-prioritiesCreate a monthly SEO report from finalised Search Console data with clear comparisons, page evidence, missing data and next actions for the next month.
monthly-reportTurn finalised monthly Search Console evidence into a limited SEO action plan with clear priorities and the follow-up report to run for each one.
monthly-action-planTurn crawl findings into a concise narrative that explains what matters, what changed and which evidence supports the next action without hiding limits.
narrative-reportReview Search Console winners and losers around a confirmed Google update window and keep timing evidence separate from a claim of cause in the final report.
update-postmortemTesting, setup & exports
Check local setup, measure known changes, review templates, and package site knowledge for agents.
Check your SEO CLI login, Google permissions, OAuth client and saved project settings. Get the exact next step for each failed setup check without guessing.
setup-checkCompare matched Search Console periods around a recorded SEO change and keep releases, demand shifts and other confounders beside the result.
measure-changeAudit programmatic SEO templates, repeated URL patterns and Search Console demand. Review representative pages before changing a whole template.
pseo-auditExport crawl evidence as a limited OKF v0.2 bundle with source details, generation metadata, and linked artifacts that an agent can inspect locally.
okf-buildValidate an Open Knowledge Format pack for paths, sources, trust signals, lifecycle, freshness, and Markdown references before an agent uses it.
okf-validate