Technical SEO of one page
seo_auditCheck one page for technical SEO problems—missing metadata, heading structure, canonical, hreflang, robots.txt, sitemap validity, and broken internal links—to find why it isn't indexed.
Instructions
Reads one page and reports the technical SEO facts a maintenance retainer is judged on: title and meta description, heading structure, canonical, Open Graph, hreflang, language, viewport, images with no alt text, the state of robots.txt and the sitemap, and which internal links are broken. The sitemap is checked against the rules of the sitemaps protocol, so a file that exists but that consumers drop is reported as broken rather than as present.
Use it to answer "why is this page not being indexed?", "does this page have the metadata it needs?" or "are there broken links on the homepage?". It is the check to run before a quarterly report, and after a site rebuild.
Do not use it to check whether a site is up, which is uptime_check, or to inspect a certificate, which is ssl_check. It audits one page: it does not crawl a site, and it judges only what is in the HTML, never how a page ranks.
robots.txt is read first and obeyed. A page this crawler is not allowed to read is reported as such and is not requested — and neither are internal links it forbids. An unreadable robots.txt is treated as forbidding everything, per RFC 9309.
Link checking is one HTTP request per link, paced politely, so an audit with links takes seconds rather than milliseconds; pass checkLinks: false when speed matters more. Returns findings ordered by urgency, worst first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page to audit, e.g. "https://example.com/pricing". A bare domain such as "example.com" is accepted and read over HTTPS. One page is audited, not a whole site, so pass the page you care about; the homepage is the usual choice. | |
| maxLinks | No | How many internal links to check at most. Defaults to 25. Links beyond the limit are counted and reported as unchecked, never silently ignored. | |
| checkLinks | No | Whether to request each internal link to find broken ones. Defaults to true. Set it to false for a fast metadata-only audit: link checking is one request per link and is what makes this tool take seconds rather than milliseconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL that was requested. | |
| page | Yes | What the document itself says. | |
| links | Yes | Internal link health. Only internal links are requested; external ones are counted. | |
| robots | Yes | What the host publishes about crawling, and what it means for this audit. | |
| status | Yes | HTTP status of the page. | |
| fetched | Yes | Whether the page was read at all. False when robots.txt forbids it. | |
| sitemap | Yes | The sitemap declared in robots.txt, or /sitemap.xml when none is declared. | |
| finalUrl | Yes | Where it ended up after redirects. | |
| findings | Yes | What needs attention, worst first. | |
| severity | Yes | How much attention this needs. "critical" means act now; "warning" means act this month; "unknown" means the check could not establish the fact, which is not the same as it being fine. | |
| checkedAt | Yes | When the audit ran, ISO 8601 in UTC. | |
| truncated | Yes | Whether the document was longer than the read limit and was cut off. | |
| contentType | Yes | Content type, without parameters, e.g. "text/html". |