Audit a site's content by sampling its sitemap
audit_sitemapAudit a website's content quality by sampling pages from its sitemap. Get score distribution, worst pages, and common issues for portfolio-level health checks.
Instructions
Site-wide content audit: discovers the sitemap, samples N URLs by deterministic uniform stride, runs audit_page on each, and returns score distribution + worst pages + most-common findings.
Read-only. One HTTP GET for sitemap discovery, optionally a few more for sitemap-index children, then sample_size × audit_page calls (each one HTTP GET + parsing). Polite throttling is enforced per host.
Deterministic — same domain + same sample_size returns the same set of URLs (uniform-stride sampling). Per-page scoring is rule-based; no LLM.
When to use: portfolio-level health check across a site ("how does our content score on average?"). Distinct from audit_site (homepage-only composite) and check_sitemap (validates sitemap.xml structure, not page content).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Hostname or origin to audit. Examples: `example.com`, `https://example.com`. The tool discovers the sitemap, samples N URLs by uniform stride, and runs audit_page on each. | |
| concurrency | No | Parallel audit_page calls. Default 2 (gentle). Max 5. The shared politeFetch host-delay is still enforced, so this is per-batch dispatch concurrency, not bypass. | |
| sample_size | No | Number of URLs to sample from the sitemap. Default 10. Max 50 (sampling caps to avoid runaway audits — each sample is one full audit_page call, ~1-3s with polite throttling). Sampling is deterministic uniform-stride: if the sitemap has 1000 URLs and sample_size=10, every 100th URL is picked. | |
| respect_robots | No | If true (default), respect robots.txt for each sampled URL. Set false only for self-audits where you've intentionally blocked crawlers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The domain audited. | |
| failed | Yes | URLs whose audit failed, with the error message. | |
| audited | Yes | Per-page audit results that completed successfully. | |
| sampling | Yes | Sampling strategy. Deterministic uniform stride: every Nth URL is picked. | |
| fetched_at | Yes | UTC ISO-8601 timestamp of the audit. | |
| sitemap_url | Yes | Resolved sitemap URL (null when discovery failed). | |
| worst_pages | Yes | Lowest-scoring pages from the sample, worst first. | |
| top_findings | Yes | Most-common findings across all sampled pages, sorted by occurrence count desc. | |
| urls_sampled | Yes | Number of URLs picked via uniform-stride sampling. | |
| grade_distribution | Yes | Count of pages per letter grade. | |
| score_distribution | Yes | Summary statistics across the audited sample. | |
| total_urls_in_sitemap | Yes | Total URLs declared across the sitemap and any indexed children. |