--- title: "SEO reports for audits and analysis | SEO Skill" description: "Choose an SEO report for a site audit, lost clicks, keyword research, competitors, indexing, links, local search, or AI search visibility." canonical: "https://seoskill.dev/docs/reports" language: "en" --- # 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 ```sh 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: ```sh 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](https://seoskill.dev/docs/research-providers) explains how to connect one and set spending limits. When the result needs to become a client deliverable, use the [HTML report guide](https://seoskill.dev/docs/html-reports). 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-crawl Site crawl ](https://seoskill.dev/docs/reports/site-crawl)[ Audit one URL for technical SEO, metadata, canonicals, schema, links and Search Console queries. See the live evidence before changing the page. audit-page Audit page ](https://seoskill.dev/docs/reports/audit-page)[ Run 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-urls Audit selected URLs ](https://seoskill.dev/docs/reports/audit-urls)[ Follow every redirect hop from one URL to its final page and check status codes, loops, chains, canonicals and link safety before updating links. redirect-trace Redirect trace ](https://seoskill.dev/docs/reports/redirect-trace)[ Run 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-audit Performance audit ](https://seoskill.dev/docs/reports/performance-audit) ## Crawl 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-fixes Top fixes ](https://seoskill.dev/docs/reports/top-fixes)[ Find 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-urls Affected URLs ](https://seoskill.dev/docs/reports/affected-urls)[ Look 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-issue Explain a crawl issue ](https://seoskill.dev/docs/reports/explain-crawl-issue)[ Browse 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-rules Crawler rules ](https://seoskill.dev/docs/reports/crawler-rules)[ List 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-history Crawl history ](https://seoskill.dev/docs/reports/crawl-history)[ Open 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-report Saved crawl report ](https://seoskill.dev/docs/reports/crawl-report) ## Indexing & 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-diff Crawl diff ](https://seoskill.dev/docs/reports/crawl-diff)[ Compare 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-crawls Compare crawls ](https://seoskill.dev/docs/reports/compare-crawls)[ Compare crawl, sitemap and Search Console evidence to find page groups that need a closer Google URL Inspection check before spending limited quota. index-coverage Index coverage ](https://seoskill.dev/docs/reports/index-coverage)[ Plan a representative Google URL Inspection sample across sitemaps and page groups without spending the daily API quota or guessing which pages matter. index-coverage-plan Index plan ](https://seoskill.dev/docs/reports/index-plan)[ Collect 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-monitor Index monitor ](https://seoskill.dev/docs/reports/index-monitor)[ Compare current Google URL Inspection results with saved snapshots to find selected pages whose index status or canonical changed since the last check. index-watch Index watch ](https://seoskill.dev/docs/reports/index-watch)[ Find meaningful Bing traffic trends, crawl changes, and query and page opportunities with explicit provider coverage, limits, and clear verification steps. bing-webmaster-overview Bing Webmaster overview ](https://seoskill.dev/docs/reports/bing-webmaster-overview)[ Review limited referring URLs, target pages and anchor text from Ahrefs, DataForSEO, Bing Webmaster or a local export, with source limits kept visible. link-evidence Referring link evidence ](https://seoskill.dev/docs/reports/link-evidence)[ Stream 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-analysis Server log crawler analysis ](https://seoskill.dev/docs/reports/server-log-analysis)[ Run recurring crawl, index and link checks together to find technical SEO changes while keeping missing or quota-limited evidence visible on every run. technical-watch Technical watch ](https://seoskill.dev/docs/reports/technical-watch) ## Search 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-opportunities Competitive opportunities ](https://seoskill.dev/docs/reports/competitive-opportunities)[ Discover market-specific keyword ideas from a small seed list with search volume, difficulty, source overlap, provider coverage, cache status and cost. keyword-research Keyword research ](https://seoskill.dev/docs/reports/keyword-research)[ Compare search volume, trends, CPC, competition, difficulty, intent and result counts for a list of keywords in one country and language before deeper research. keyword-metrics Keyword metrics ](https://seoskill.dev/docs/reports/keyword-metrics)[ Review saved keyword research, stale provider metrics, tags and page mappings from one local project set without repeating paid provider requests. saved-keywords Saved keyword set ](https://seoskill.dev/docs/reports/saved-keywords)[ Inspect exact organic ranks, domains, URLs, titles, snippets and result features for one keyword, location, language and device-specific search snapshot. serp-results Live search results ](https://seoskill.dev/docs/reports/serp-results)[ Track exact organic positions for a saved keyword set by location and device. Compare ranking changes with local history, coverage and provider cost. rank-tracking Exact rank tracking ](https://seoskill.dev/docs/reports/rank-tracking)[ Review estimated organic traffic, ranked keywords and ranking distribution for a domain, with optional matching Search Console evidence kept separate. domain-overview Domain search footprint ](https://seoskill.dev/docs/reports/domain-overview)[ Retrieve one attributed Ahrefs Domain Rating observation for a domain or URL, with its target mode, license, cache state, coverage and limits kept visible. domain-rating Ahrefs Domain Rating ](https://seoskill.dev/docs/reports/domain-rating)[ Review a limited domain or page keyword footprint with ranking URLs, demand estimates, provider limits and optional matching Search Console query evidence. ranked-keywords Ranked keyword footprint ](https://seoskill.dev/docs/reports/ranked-keywords)[ See 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-pages Ranking pages and patterns ](https://seoskill.dev/docs/reports/ranking-pages)[ Find domains that repeatedly appear for an explicit keyword set, preserve declared site types, and leave unknown search competitors safely unclassified. serp-competitors Search competitors ](https://seoskill.dev/docs/reports/serp-competitors)[ Compare competitor keywords with Search Console themes, current rankings and repeated page patterns. Exclude irrelevant terms and evidence of existing coverage. competitor-keyword-gap Competitor keyword gaps ](https://seoskill.dev/docs/reports/competitor-keyword-gap)[ Combine Search Console quick wins, second-page queries and striking-distance evidence with optional keyword estimates and programmatic SEO clusters. keyword-opportunities Keyword opportunities ](https://seoskill.dev/docs/reports/keyword-opportunities)[ Find local Search Console queries, landing pages and repeated templates. Add measured visitor geography or a few exact local results only when needed. local-search-demand Local search demand ](https://seoskill.dev/docs/reports/local-search-demand)[ Find repeatable searches in Search Console, then check planned comparisons, tools, templates and location pages to see what exists and what may be missing. pseo-patterns Programmatic SEO patterns ](https://seoskill.dev/docs/reports/pseo-patterns)[ Research ways to expand an existing programmatic page system with Search Console, keyword ideas, current results and competitor pages before building more. pseo-opportunities Programmatic SEO opportunities ](https://seoskill.dev/docs/reports/pseo-opportunities)[ Find page-one queries with useful impressions and weaker CTR evidence, then inspect the search result before changing titles, snippets or page copy. quick-wins Quick wins ](https://seoskill.dev/docs/reports/quick-wins)[ Group Search Console queries around positions 11 to 20 into focused content, snippet, internal link and template review actions for each page. striking-distance Striking distance ](https://seoskill.dev/docs/reports/striking-distance)[ Find URLs and queries averaging positions 11 to 20, then inspect whether content, links, snippets or technical issues deserve attention on each page. second-page Second page ](https://seoskill.dev/docs/reports/second-page)[ Compare matched Search Console periods to find pages and queries losing clicks, impressions, position or CTR before planning a content refresh. decaying-pages Decaying pages ](https://seoskill.dev/docs/reports/decaying-pages)[ Find high-impression Search Console queries with weaker CTR than expected for their position. Review the real result before rewriting a snippet. ctr-underperformers CTR underperformers ](https://seoskill.dev/docs/reports/ctr-underperformers)[ Compare one URL with its Search Console queries and live page evidence to find focused content, CTR and coverage opportunities before rewriting the page. page-opportunities Page opportunities ](https://seoskill.dev/docs/reports/page-opportunities) ## Content & 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. cannibalisation Cannibalisation ](https://seoskill.dev/docs/reports/cannibalisation)[ Find 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-links Internal links ](https://seoskill.dev/docs/reports/internal-links)[ Build a content brief from one page, its Search Console queries and the headings or topics already present. Keep every suggestion tied to demand. content-optimization Content optimization ](https://seoskill.dev/docs/reports/content-optimization)[ Group returned Search Console queries into repeated demand themes so content gaps, templates and competing pages are easier to inspect across the site. query-clusters Query clusters ](https://seoskill.dev/docs/reports/query-clusters)[ Find 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-recovery Link recovery ](https://seoskill.dev/docs/reports/link-recovery)[ Find Search Console queries with forum, review, comparison or discussion intent so your content can answer the format people are looking for. community-intent Community intent ](https://seoskill.dev/docs/reports/community-intent) ## AI 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-readiness AI agent readiness ](https://seoskill.dev/docs/reports/agent-readiness)[ Compare provider-indexed AI mentions, cited domains and question samples with optional Search Console evidence for one exact surface and market. ai-mention-research AI mention research ](https://seoskill.dev/docs/reports/ai-mention-research)[ Check fixed prompts against exact current AI models, retain answer and citation evidence locally, and compare only compatible observations over time. ai-prompt-observations AI prompt observations ](https://seoskill.dev/docs/reports/ai-prompt-observations)[ Score crawl-based AI search readiness across access, indexability and page signals. Open every contributing check before trusting the number. ai-search-scorecard AI search scorecard ](https://seoskill.dev/docs/reports/ai-search-scorecard)[ Check whether crawlers can access and use important pages in AI search. Find technical blockers without inventing a visibility or citation score. ai-readiness AI readiness ](https://seoskill.dev/docs/reports/ai-readiness)[ Check whether schema, authorship and brand details clearly connect the people, organisation and content across your site and find conflicting signals. entity-readiness Entity readiness ](https://seoskill.dev/docs/reports/entity-readiness)[ Check the crawl, index, canonical and snippet controls used for Google AI search eligibility without predicting whether a page will be selected. geo-gaps Google AI search controls ](https://seoskill.dev/docs/reports/geo-gaps)[ Check 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-audit llms.txt audit ](https://seoskill.dev/docs/reports/llms-txt-audit)[ Generate 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-txt Generate llms.txt ](https://seoskill.dev/docs/reports/generate-llms-txt)[ Turn real Search Console queries into repeatable AI monitoring prompts so assistant answers can be checked against demand your site already sees. seo-to-ai-query SEO to AI query ](https://seoskill.dev/docs/reports/seo-to-ai-query)[ Find visits from known AI assistants in Google Analytics, see which landing pages received them and keep missing referrers separate from confirmed traffic. ai-referrals AI referrals ](https://seoskill.dev/docs/reports/ai-referrals) ## Understand 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-overview Search performance overview ](https://seoskill.dev/docs/reports/search-performance-overview)[ Compare Search Console movement by page, query, country or device to find which segment explains a wider gain or loss across the selected dates. segment-impact Segment impact ](https://seoskill.dev/docs/reports/segment-impact)[ Find unusual Search Console movement, identify the pages and queries behind it and compare the dates with confirmed Google updates before a deeper check. traffic-anomaly Traffic anomaly ](https://seoskill.dev/docs/reports/traffic-anomaly)[ Compare unusual Search Console traffic dates with confirmed Google ranking updates without treating a matching date as proof of what caused the change. update-correlation Google update correlation ](https://seoskill.dev/docs/reports/update-correlation) ## Reports & 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-priorities Refresh priorities ](https://seoskill.dev/docs/reports/refresh-priorities)[ Create a monthly SEO report from finalised Search Console data with clear comparisons, page evidence, missing data and next actions for the next month. monthly-report Monthly report ](https://seoskill.dev/docs/reports/monthly-report)[ Turn 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-plan Monthly action plan ](https://seoskill.dev/docs/reports/monthly-action-plan)[ Turn crawl findings into a concise narrative that explains what matters, what changed and which evidence supports the next action without hiding limits. narrative-report Narrative report ](https://seoskill.dev/docs/reports/narrative-report)[ Review 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-postmortem Update postmortem ](https://seoskill.dev/docs/reports/update-postmortem) ## Testing, 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-check Setup check ](https://seoskill.dev/docs/reports/setup-check)[ Compare matched Search Console periods around a recorded SEO change and keep releases, demand shifts and other confounders beside the result. measure-change Measure a change ](https://seoskill.dev/docs/reports/measure-change)[ Audit programmatic SEO templates, repeated URL patterns and Search Console demand. Review representative pages before changing a whole template. pseo-audit pSEO audit ](https://seoskill.dev/docs/reports/pseo-audit)[ Export crawl evidence as a limited OKF v0.2 bundle with source details, generation metadata, and linked artifacts that an agent can inspect locally. okf-build OKF export ](https://seoskill.dev/docs/reports/okf-build)[ Validate an Open Knowledge Format pack for paths, sources, trust signals, lifecycle, freshness, and Markdown references before an agent uses it. okf-validate OKF validation ](https://seoskill.dev/docs/reports/okf-validate)