seo-audit-report

Report on where a site stands

Goal

One readable account of a site, built on the joined history this install already holds, ending in the single thing worth doing next.

What makes this worth doing here

Most SEO reports are one data source rendered. This install holds crawl findings, rank movements from two different sources, AI-citation checks, and a log of every change the agent made to the live site — joined, over time. "Why did this page drop" needs all of that, which is why the answer is usually in the agent action log rather than in the rankings.

Tools

• get_client_knowledge — what the business is. Decides which findings matter.
• get_client_overview — score, open issues by severity, what is connected.
• list_audit_issues — the findings themselves.
• get_keyword_rankings — positions and movement.
• get_ai_visibility — whether assistants cite this site.
• get_citation_landscape — who they cite instead.
• get_recent_agent_runs and list_agent_actions — what has already been changed, and when.
• compare_search_periods — clicks and position against the previous period, and what moved, from Search Console.
• check_indexing — whether the pages Google shows most are indexed, and why not. inspect_url for one page, list_sitemaps for what was submitted. All four need a connected Search Console property and say so when there is none.

Reading the numbers honestly

This is most of the job.

• A rank from Search Console and a rank from a scrape are different measurements. One is an impression-weighted daily average across real searchers; the other is the position this server was shown at one moment from one location. Every row says which. Never average them, and never report movement between two rows from different sources — the tool returns null for that on purpose.
• An AI-visibility check says whether the model actually searched the web. Only the live ones tell you anything about AI search today. A "not cited" from training memory is a statement about the model, not about the site.
• get_citation_landscape states its sample size. A ranking drawn from three answers is three answers, not a share of voice. Say the number.
• No audit is not a clean audit. get_client_overview says plainly when there is none. Report that, do not report health.
• Correlate changes with dates. If rankings moved, check list_agent_actions for what changed and when before attributing it to anything else.
• Search Console's newest days are unfinished. compare_search_periods ends both periods on the last day Google finished counting. Do not restate its numbers as "the last 28 days" by the calendar, and do not call a partial day a drop.
• An inspection is Google's record from its last crawl. A fix made this week will not show in inspect_url or check_indexing until Google recrawls the page. Say when the page was last crawled.