Find the SEO report that gets you to the next fix

Find the right local SEO report for lost traffic, technical problems, page opportunities, release regressions, AI search evidence, and measurement.

Get to the first useful answer faster

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, or a technical change after a release. You get the affected pages and queries without digging through an unrelated audit.

seo report --url is the technical-only version. It saves a bounded crawl and labels every Search Console section as skipped until you add --site or a project profile. It does not turn missing search data into an empty result.

Keep every recommendation tied to evidence you can check

Each result keeps the observed crawl or provider data beside the finding. It also carries the date range, row caps, thresholds, skipped sections, source limits, and the command that verifies the change.

That means a missing row stays missing instead of becoming zero. A capped crawl cannot produce an all-clear. A low-CTR row can earn a place in the review queue without becoming a promise of more traffic.

Find a report by the job you need done

The catalog includes 52 reports across 9 categories. Browse the plain-English list below, or ask the installed package for the live ids and input schemas.

Ask the installed package for the live catalog and exact input schema:

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

The CLI and MCP server use one report registry. Agents using MCP should call seo_list_reports, seo_describe_report, and then seo_run_report rather than treating a copied schema as permanent.

Crawl & page checks

Crawl a whole site or inspect selected pages for technical problems your agent can fix.

Site crawlMap a limited part of a site, run the maintained technical checks, and save a reusable evidence baseline.site-crawl Audit pageInspect one live URL before changing its metadata, canonical, directives, structured data, links, or content.audit-page Audit selected URLsRun the crawler checks across a chosen list of pages without discovering or crawling the rest of the site.audit-urls Redirect traceFollow every hop from one URL to its final page and catch loops, long chains, broken destinations, or conflicting index signals.redirect-trace Performance auditCombine a local Lighthouse test with available CrUX field data and see where a page is slow without mixing lab and real-user evidence.performance-audit

Crawl findings

Turn a crawl finding into affected URLs, understand the rule, and inspect saved evidence.

Top fixesTurn a long crawl report into a short list of technical SEO fixes ranked by evidence, reach, and effort.top-fixes Affected URLsOpen the exact URLs behind a crawl finding and turn a summary count into a limited review or fix list.affected-urls Explain a crawl issueTurn one crawler rule id into plain-English meaning, practical fixes, impact context, and a repeatable verification step.explain-crawl-issue Crawler rulesSee every technical check built into the local crawler and find the right rule for a focused follow-up.crawler-rules Crawl historyList local crawl snapshots by site and date so you can choose the right baseline without opening every report.crawl-history Saved crawl reportRetrieve one local crawl snapshot in compact form and request its page or issue inventory only when you need it.crawl-report

Indexing & monitoring

Find indexing candidates, compare crawls, and catch technical changes after a release.

Crawl diffCrawl the same limited URL scope again and find technical or page changes since the previous monitoring run.crawl-diff Compare crawlsSee which pages and technical issues appeared, disappeared, or changed between two saved crawl snapshots.compare-crawls Index coverageFind crawlable pages missing from the returned Search Console data, then choose representative URLs for direct inspection.index-coverage Index planTurn sitemap URLs, Search Console properties, and daily URL Inspection limits into a realistic monitoring cycle.index-coverage-plan Index monitorInspect a quota-limited sitemap sample and save Google indexed-state snapshots for later comparison.index-monitor Index watchInspect a limited URL set and separate current index issues, regressions, recoveries, and operational failures.index-watch Technical watchRun recurring crawl, index, and link-recovery checks after the first audit.technical-watch

Search opportunities

Use the searches already bringing people to your site to choose pages, snippets, and links worth improving.

Quick winsFind page-one rankings with weak CTR where title or snippet work may earn more clicks.quick-wins Striking distanceGroup position 11 to 20 Search Console queries into practical actions.striking-distance Second pageFind URLs ranking around positions 11 to 20 and decide which pages deserve closer review.second-page Decaying pagesFind returned page and query rows with supported click declines across two matched Search Console windows.decaying-pages CTR underperformersFind high-impression queries whose CTR trails a documented expectation and review the search result before changing anything.ctr-underperformers Page opportunitiesSee which returned search queries are already associated with one URL and what deserves a closer look on the live page.page-opportunities

Content & internal links

Find competing pages, weak internal links, and query groups that deserve clearer content.

CannibalisationFind queries associated with several URLs and separate healthy search coverage from genuine intent, canonical, or consolidation problems.cannibalisation Internal linksFind fetched pages with relevant search evidence that do not currently contain a verified contextual link to a chosen target.internal-links Content optimizationCreate a focused brief for one existing page from its own search queries and the content observed on the live URL.content-optimization Query clustersTurn a large returned Search Console query set into reproducible groups that are easier to review for shared demand.query-clusters Link recoveryFind URLs that still earn returned clicks or impressions but now fail, block access, or redirect poorly.link-recovery Community intentSurface searches containing explicit review, comparison, forum, recommendation, or first-hand experience wording.community-intent

AI search visibility

Find technical restrictions, improve machine-readable context, and measure AI referral traffic.

AI search scorecardTurn one crawl into a 0-100 heuristic score over this tool's own AI-search checks, with observed evidence and unknown states kept separate.ai-search-scorecard AI readinessReview crawl access, indexability, snippet controls, page structure, and optional agent resources without inventing an AI visibility score.ai-readiness Entity readinessReview naming, authorship, dates, schema, and sameAs links without claiming a search engine has recognised an entity.entity-readiness Google AI search controlsFind crawl, indexability, and snippet controls that can block Google AI search eligibility on selected pages.geo-gaps llms.txt auditCheck whether an optional llms.txt file is reachable, readable, and consistent with useful pages from the crawl.llms-txt-audit Generate llms.txtBuild a concise llms.txt draft from selected crawl evidence when someone has decided to maintain the optional file.generate-llms-txt SEO to AI queryTurn real Search Console queries into prompts for repeatable AI answer monitoring.seo-to-ai-query AI referralsSee which known AI products sent referral sessions recorded by GA4 and which landing pages received them.ai-referrals

Understand performance

Work out where search performance moved, which part of the site explains it, and whether the change is unusual.

Search performance overviewSee where clicks and impressions changed, which pages or queries account for the movement, and what to inspect next.search-performance-overview Segment impactCompare Search Console movement by page, query, country, or device.segment-impact Traffic anomalyCompare recent Search Console clicks and impressions with the site history to find unusual changes.traffic-anomaly Google update correlationPlace unusual Search Console movement beside confirmed Google ranking update windows without claiming the update caused it.update-correlation

Reports & priorities

Turn the evidence into a short work queue or a clear update for clients and teams.

Refresh prioritiesTurn crawl and Search Console evidence into one ranked implementation list.refresh-priorities Monthly reportTurn one calendar month of finalised search data into a clear report with changes, opportunities, gaps, and follow-up work.monthly-report Monthly action planProduce the shared monthly SEO report and finish with a short list of evidence-backed follow-up work.monthly-action-plan Narrative reportTurn crawl and search evidence into a short report that explains what matters and what to do next.narrative-report Update postmortemInspect winners, losers, page evidence, and known site changes around a confirmed Google ranking update window.update-postmortem

Testing, setup & exports

Check local setup, measure known changes, review templates, and package site knowledge for agents.

Setup checkFind local Google sign-in, scope, configuration, and saved project problems before they cause empty or failed reports.setup-check Measure a changeCompare equal, finalised search windows around a recorded change and see what moved without claiming the change caused it.measure-change pSEO auditReview repeated page families with search demand, limited crawl samples, and optional Google index evidence kept separate.pseo-audit OKF exportTurn a saved crawl into a compact OKF knowledge pack with source pages an agent can inspect and verify locally.okf-build OKF validationCheck OKF files for structural, path, link, citation, and manifest problems before an agent or automation relies on them.okf-validate

Know where the answer stops

SEO systems expose incomplete evidence. Reports avoid turning rough heuristics into ranking rules, label estimates as estimates, and lower the strength of a conclusion when the input is sparse. Important changes still deserve a check against the live page and the relevant provider.