SEO audit (whole site)
site_seo_auditCrawl a website and audit each page to aggregate average SEO scores, common issues, duplicate titles/descriptions, broken pages, and worst performers for site health reports and fix prioritization.
Instructions
Crawl a website (sitemap.xml or same-origin links, robots.txt respected) and run seo_audit on every page, then aggregate: average score, the most common issues with how many pages each affects, duplicate titles and meta descriptions, broken pages (4xx/5xx/unreachable) and the worst-scoring pages. Use it for site health reports and to prioritise fixes across many pages. Keep max_pages small (10-30) for a quick overview.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "site_seo_audit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Start URL. Only pages on the same origin (scheme + host + port) are crawled. | |
| strategy | No | "auto" uses sitemap.xml when available and falls back to following links; "sitemap" or "links" force one method. | auto |
| max_depth | No | Link depth from the start URL (only used by the "links" strategy). | |
| max_pages | No | Maximum pages to fetch (hard cap 100). | |
| path_prefix | No | Only crawl URLs whose path starts with this, e.g. "/blog/". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crawl | Yes | ||
| pages | Yes | ||
| worstPages | Yes | ||
| brokenPages | Yes | ||
| issueCounts | Yes | ||
| averageScore | Yes | ||
| pagesAudited | Yes | ||
| duplicateTitles | Yes | ||
| duplicateDescriptions | Yes |