Get SEO Audit
get_auditReads one SEO Audit of a site, by default the latest, as a report per category: status, stage, crawl progress, each category’s state and a seoAuditUrl that opens the site’s SEO Audit page in Keytomic. A finished category adds its finding and limitation counts and, for audits from crawlers with live category summaries, its issue, advisory and check counts and top findings; older audits leave these null. A category fails only for a high-severity issue, warns for any other issue, a limitation or a check that warns or fails, and passes otherwise; advisories alone leave it passing. Check counts count checks, not findings. While the audit is queued or running, follow it with watch_audit. Once it is completed or partial, it includes the summary: per category its status, finding and check counts and its 0–100 Category Health score with band; the 0–100 Website Health score with band; reportAreas; the Start Page’s metrics; PageSpeed scores per strategy (null when the strategy did not run); average and median time to first byte; the top 20 findings (key, title, severity, affected count), coverage and limitations. reportAreas has one entry per Report Area of the run’s mapping version, in display order, with the crawler’s label. Each entry has its 0–100 Area Health score with band and its passed, warning, failed and notApplicable check counts. notApplicable counts the area’s not applicable checks, which are not assessed; it is null on audits stored before the crawler counted them. For Performance, strategy names the PageSpeed strategy behind the score. An area has no weight and feeds no other score. The deductions behind the score are left out. An area without a score gives a reason: not_scored (stored before Report Areas), not_executed, unavailable, undeclared_finding_code, no_pagespeed_score (Performance only) or no_checks_assessed. Scores are null with a reason when there is none, and audits from older crawlers leave the newer fields null. It leaves out evidence: read it with list_audit_findings and list_audit_rows. Pass category to read only that category’s report from a finished audit: its status, every check with its status and row count, its findings and limitations; read a check’s rows with list_audit_rows. A failed or cancelled audit includes the crawler’s error. To compare audits, read each one by runId.
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": {
"projectId": "<projectId>"
},
"name": "get_audit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | SEO Audit to read. Defaults to the latest one. | |
| category | No | Category whose report to read instead of the whole audit. The audit must be finished. | |
| projectId | Yes | Site to read, from list_sites. Its SEO Audits are read. |