Audit Page
seo.audit_page
Overview
Orchestrate certified page primitives over supplied HTML and optional observations. We never fetch a URL, run a script, or choose a winner. The audit envelope costs 1 execution credit. Each executed child adds that child's published credit weight times how many times it ran. Those extras are included in this parent debit — primitives are not invoked through the public pipeline and not billed again. We reserve the closed child-plan ceiling before execution and settle to the children that actually ran. Exclude a child or omit its evidence to keep it out of both the reservation and the work. The settled allocation is reported on usage under seo-composite-v1. Accepts file input via file_ref — no need to extract file content first.
The page audit composes extractors and validators; it does not invent a live crawl.
Reliability
seo.audit_page is stable for identical input. Identical input always produces identical JSON. SEO_INPUT_REQUIRED means a required field is missing or has the wrong shape, so send the published object rather than a guessed map; retrying unchanged will not help. SEO_INPUT_TOO_LARGE means a value exceeds its ceiling, so trim it. SEO_HTML_MALFORMED means the HTML could not be parsed under the offline HTML contract, so fix the markup. SEO_XML_MALFORMED means the XML is not well-formed, so correct it. SEO_XML_DOCTYPE_NOT_ALLOWED means the XML includes a DOCTYPE declaration, so strip the DOCTYPE and resend; we refuse DTDs rather than expanding entities. SEO_JSONLD_MALFORMED means a JSON-LD block is not usable JSON, so correct it. SEO_PROFILE_UNKNOWN means the named profile is not bundled, so send one of the published profile ids. SEO_TOO_MANY_RECORDS means a list exceeded its ceiling, so split the batch. SEO_GRAPH_LIMIT_EXCEEDED means the graph exceeded its node or edge ceiling, so shrink it. SEO_INVALID_URL means a URL string is not a usable RFC 3986 URI, so send an absolute URI. SEO_OBSERVATION_INCOMPLETE means required observation coverage is missing, so add the missing evidence. SEO_INPUT_CONFLICT means two fields that cannot be used together were both supplied, so drop one. Retrying an unchanged request will not help.
Context footprint
Returns a compact seo.audit_page record. The audit envelope costs 1 execution credit. Each executed child adds that child's published credit weight times how many times it ran. Those extras are included in this parent debit — primitives are not invoked through the public pipeline and not billed again. We reserve the closed child-plan ceiling before execution and settle to the children that actually ran. Exclude a child or omit its evidence to keep it out of both the reservation and the work. The settled allocation is reported on usage under seo-composite-v1.
When to use it
When you already hold one page's artifacts (HTML, optional headers, optional rendered snapshot) and need a composed offline page audit. Keyword scoring is marketing.keyword_density, not an seo.* twin.
When you still need to fetch the page, or you want a site-wide envelope — use seo.audit_site.
Scope
Non-goals
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not fetch the page or score keywords
Properties
Capabilities
Cost & billing
Flat rate per invocation
File handling
File limits
Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.
| Limit | Value | Limited by |
|---|---|---|
| Maximum size per input file | 1 MiB | Skill maximum |
How we handle your data
What this means
This skill may receive sensitive content and may return submitted, transformed, extracted, or reformatted content.
Squillify guarantees
- Runs inside Squillify
- This skill runs inside Squillify.
- Payloads are not sent to an external service by this skill.
- Squillify does not permanently store submitted payloads.
- Telemetry records metadata only, not submitted content.
- Submitted payloads are not used for training.
- Submitted payloads are not reviewed by humans.
- This skill does not target sensitive data.
- The response may contain submitted or transformed content.
Your responsibility
Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
| html | string | No | Bounded inline html. Required unless file_ref is provided. Omit file_ref when this inline source is sent. |
| file_ref | string | No | Tenant-scoped opaque file reference. Omit it when the inline source is supplied. |
| documentUrl | string | Yes | Required. The documentUrl value for this offline analysis, up to 1 MiB. |
| response | object | No | Closed object 'response' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat response as empty. |
| renderedObservation | object | No | Closed object 'renderedObservation' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat renderedObservation as empty. Purpose-bound map: each property name is a caller key and each value is a string, at most 64 keys. |
| resourceManifest | object | No | Closed object 'resourceManifest' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat resourceManifest as empty. Purpose-bound map: each property name is a caller key and each value is a string, at most 64 keys. |
| profile | string | No | The profile value for this offline analysis, up to 1 MiB. Omit it and we apply the published default for profile. |
| include | array | No | Closed array 'include' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat include as empty. |
| exclude | array | No | Closed array 'exclude' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat exclude as empty. |
| executionPolicy | object | No | Closed object 'executionPolicy' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. Omit it and we treat executionPolicy as empty. Purpose-bound map: each property name is a caller key and each value is a string, at most 64 keys. |
Output schema
| Field | Type | Required | Description |
|---|---|---|---|
| summary | object | Yes | Required. Structured 'summary' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| sections | array | Yes | Required. Structured 'sections' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| primitiveFindings | array | Yes | Required. Structured 'primitiveFindings' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| coverage | object | Yes | Required. Structured 'coverage' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| skippedChecks | array | Yes | Required. Structured 'skippedChecks' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| executionLedger | array | Yes | Required. Structured 'executionLedger' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| componentManifest | array | Yes | Required. Structured 'componentManifest' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| truncated | boolean | Yes | Required. Structured 'truncated' value produced by this offline analysis. |
| cleanBillOfHealth | boolean | Yes | Required. Structured 'cleanBillOfHealth' value produced by this offline analysis. |
| profile | string | Yes | Required. Structured 'profile' value produced by this offline analysis. |
| contractVersion | string | Yes | Required. Structured 'contractVersion' value produced by this offline analysis. |
| engine | string | Yes | Required. Structured 'engine' value produced by this offline analysis. |
| usage | object | Yes | Required. Structured 'usage' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
API contract
POST /v1/executecurl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"seo.audit_page","input":{"documentUrl":"https://www.example.com/","html":"<html><head><title>Home</title><meta name=description content='Hello world from the homepage today with enough characters.'><link rel=canonical href=https://www.example.com/><link rel=alternate hreflang=en href=https://www.example.com/></head><body><h1>Home</h1><p>Hello world</p><a href=/a>A</a><img src=/a.jpg alt=Hero></body></html>","profile":"seo.default@1"}}'import { Squillify } from "@squillify/sdk";
const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });
const { output } = await sq.execute("seo.audit_page", {"profile":"seo.default@1","documentUrl":"https://www.example.com/","html":"<html><head><title>Home</title><meta name=description content='Hello world from the homepage today with enough characters.'><link rel=canonical href=https://www.example.com/><link rel=alternate hreflang=en href=https://www.example.com/></head><body><h1>Home</h1><p>Hello world</p><a href=/a>A</a><img src=/a.jpg alt=Hero></body></html>"});Errors
| Code | HTTP | Retryable | Description |
|---|---|---|---|
| VALIDATION_ERROR | 400 | No | The request payload failed schema validation. |
| UNAUTHORIZED | 401 | No | Missing or invalid API key. |
| SKILL_NOT_ACCESSIBLE | 403 | No | The API key is not granted access to this skill. |
| SKILL_NOT_AVAILABLE_FOR_PLAN | 403 | No | This skill is not included in your current plan. |
| PLAN_ELIGIBILITY_UNAVAILABLE | 503 | Yes | Plan eligibility could not be decided. Retry after backoff. |
| SKILL_NOT_FOUND | 404 | No | The requested skill or version does not exist. |
| TENANT_RATE_LIMITED | 429 | Yes | Request rate limit exceeded. Retry after backoff. |
| QUOTA_EXCEEDED | 429 | Yes | Plan quota exhausted. Retryable once the quota period resets. |
| EXECUTION_TIMEOUT | 504 | Yes | Execution exceeded the allowed time budget. |
| SEO_INPUT_REQUIRED | 400 | No | The request payload failed this skill's input validation. |
| SEO_INPUT_TOO_LARGE | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_HTML_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_XML_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_XML_DOCTYPE_NOT_ALLOWED | 400 | No | The request payload failed this skill's input validation. |
| SEO_JSONLD_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_PROFILE_UNKNOWN | 400 | No | The request payload failed this skill's input validation. |
| SEO_TOO_MANY_RECORDS | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_GRAPH_LIMIT_EXCEEDED | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_INVALID_URL | 400 | No | The request payload failed this skill's input validation. |
Other limits
| Limit | Value |
|---|---|
| Recommended inline bytes | 32 KiB |
Limitations
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not fetch the page or score keywords
- Fetching the live URL
- Predicting ranking
How to call
POST /v1/execute (requires authentication)
{
"skillKey": "seo.audit_page",
"input": {
"profile": "seo.default@1",
"documentUrl": "https://www.example.com/",
"html": "<html><head><title>Home</title><meta name=description content='Hello world from the homepage today with enough characters.'><link rel=canonical href=https://www.example.com/><link rel=alternate hreflang=en href=https://www.example.com/></head><body><h1>Home</h1><p>Hello world</p><a href=/a>A</a><img src=/a.jpg alt=Hero></body></html>"
}
}Examples
Primary business path
{
"profile": "seo.default@1",
"documentUrl": "https://www.example.com/",
"html": "<html><head><title>Home</title><meta name=description content='Hello world from the homepage today with enough characters.'><link rel=canonical href=https://www.example.com/><link rel=alternate hreflang=en href=https://www.example.com/></head><body><h1>Home</h1><p>Hello world</p><a href=/a>A</a><img src=/a.jpg alt=Hero></body></html>"
}{
"coverage": {
"canonical": "PRESENT",
"directives": "PRESENT",
"headings": "PRESENT",
"hreflang": "PRESENT",
"http": "UNKNOWN",
"links": "PRESENT",
"media": "PRESENT",
"metadata": "PRESENT",
"performance": "UNKNOWN",
"rendering": "UNKNOWN",
"structuredData": "PARTIAL"
},
"profile": "seo.default@1",
"skippedChecks": [
{
"skillKey": "seo.extract_http_signals",
"reason": "response",
"section": "http"
},
{
"skillKey": "seo.validate_status_code",
"reason": "response",
"section": "http"
},
{
"skillKey": "seo.compute_page_weight",
"reason": "resourceManifest",
"section": "performance"
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"reason": "renderedObservation",
"section": "rendering"
},
{
"skillKey": "seo.detect_rendering_failure",
"reason": "renderedObservation",
"section": "rendering"
}
],
"primitiveFindings": [],
"componentManifest": [
{
"skillKey": "seo.extract_meta_tags",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_title_length",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_meta_description",
"contractVersion": "1.0.0",
"profile": "seo.meta.description@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_missing_metadata",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_headings",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_multiple_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_missing_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_noindex",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_nofollow",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_jsonld",
"contractVersion": "1.0.0",
"profile": "seo.jsonld.1.1.safe@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_schema_types",
"contractVersion": "1.0.0",
"profile": "seo.schemaorg@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_internal_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_external_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_images",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_image_alt",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_videos",
"contractVersion": "1.0.0",
"profile": "seo.google.video@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_http_signals",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_status_code",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.compute_page_weight",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_rendering_failure",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
}
],
"summary": {
"auditKey": "seo.audit_page",
"childExecutions": 21,
"findingCount": 0,
"errorCount": 0,
"warningCount": 0,
"skippedCount": 5,
"truncated": false,
"cleanBillOfHealth": false,
"maxChildExecutions": 32,
"maxFindings": 200,
"engine": "seo-composite-ledger",
"profile": "seo.default@1"
},
"executionLedger": [
{
"skillKey": "seo.extract_meta_tags",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "4a597e11e1dc4e519edd89484dc9d3b25618621e00dc04a5778f306902e5f9ab",
"section": "metadata"
},
{
"skillKey": "seo.validate_title_length",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "f14fb0d31ddaa352e02d74d2a20ac002ad2e1b352076e21d588f9e403163929d",
"section": "metadata"
},
{
"skillKey": "seo.validate_meta_description",
"contractVersion": "1.0.0",
"profile": "seo.meta.description@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "51a17c7894f97a5057a7f5d3ba3cfa4dfcf3b62ed5bd5790de10e18b54678067",
"section": "metadata"
},
{
"skillKey": "seo.detect_missing_metadata",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "0f3c842be834e3e50f8eff95659bdc02abb9ee65db95419d1508f59a0c1dac7e",
"section": "metadata"
},
{
"skillKey": "seo.extract_headings",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "ca4d84cc92d14952db8ed2f27835504bb987f22a42452b94da5594dab619bfda",
"section": "headings"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a69d44f251175ff04a2c3f23165502bf5d53f4132c7b029e020014878a9757ec",
"section": "headings"
},
{
"skillKey": "seo.detect_multiple_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "fb6939888c4a7ae82f369e4e9f9b5491fc81779fe0f74d6fcbf3665a7ca664ba",
"section": "headings"
},
{
"skillKey": "seo.detect_missing_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "b5fde70befb411688a8ed414b6ab3038fce17ce901410eb651c1680b174b9f2d",
"section": "headings"
},
{
"skillKey": "seo.detect_noindex",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "f67f95cda9c2fc692244694a5681fd1a9730412c1da6240ad84ee0b2d48ed5d3",
"section": "directives"
},
{
"skillKey": "seo.detect_nofollow",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a5e1bbdcdea8122aec55e99b34d9f53f5a611acf6bfdd0bb4ea7368328ab3e8b",
"section": "directives"
},
{
"skillKey": "seo.extract_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a8569f66d20d7e9000cb162aaddc4fb52bbb8d07569b777409d5262bbb78ea09",
"section": "canonical"
},
{
"skillKey": "seo.validate_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "ad45b4f878f433f5c4c9acf802a716a0249c60d881948573f8ac6d249e126c82",
"section": "canonical"
},
{
"skillKey": "seo.extract_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "5248a0d57cadef406784659e8a9ef8bdf8fe6c677411bb99477a09c4bc32a1ad",
"section": "hreflang"
},
{
"skillKey": "seo.validate_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "24e68252347c26161313d40e2afc5c215083c68492b52215e77ac855a2b46529",
"section": "hreflang"
},
{
"skillKey": "seo.validate_jsonld",
"contractVersion": "1.0.0",
"profile": "seo.jsonld.1.1.safe@1",
"status": "failed",
"reason": "SEO_INPUT_REQUIRED",
"section": "structuredData",
"findingCount": 0
},
{
"skillKey": "seo.extract_schema_types",
"contractVersion": "1.0.0",
"profile": "seo.schemaorg@1",
"status": "failed",
"reason": "SEO_INPUT_REQUIRED",
"section": "structuredData",
"findingCount": 0
},
{
"skillKey": "seo.extract_internal_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "0cb3cf0f46b04d0e9bd512fcfb3c1b7383195a335e8c4964171163af777217d1",
"section": "links"
},
{
"skillKey": "seo.extract_external_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a57cea41a0d0d4f44435881076f940e4d1fd54699c57bd94494385e144092a38",
"section": "links"
},
{
"skillKey": "seo.extract_images",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "9119f18fde27061cb0ecb7648bd723a79533c28bd13679345e3699fd629c6ea6",
"section": "media"
},
{
"skillKey": "seo.validate_image_alt",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "aa31bcdfb6dff53b6b0c650c65bb32ce1c3cf0b70c6a5984eb2b8f6fa2a7fe17",
"section": "media"
},
{
"skillKey": "seo.extract_videos",
"contractVersion": "1.0.0",
"profile": "seo.google.video@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "2ce6d88bc938da7d910dc233318209ee7bf5add36f2872f9e180fe8842d94640",
"section": "media"
},
{
"skillKey": "seo.extract_http_signals",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "response",
"section": "http",
"findingCount": 0
},
{
"skillKey": "seo.validate_status_code",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "response",
"section": "http",
"findingCount": 0
},
{
"skillKey": "seo.compute_page_weight",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "resourceManifest",
"section": "performance",
"findingCount": 0
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "renderedObservation",
"section": "rendering",
"findingCount": 0
},
{
"skillKey": "seo.detect_rendering_failure",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "renderedObservation",
"section": "rendering",
"findingCount": 0
}
],
"cleanBillOfHealth": false,
"engine": "seo-composite-ledger",
"truncated": false,
"contractVersion": "1.0.0",
"sections": [
{
"id": "metadata",
"coverage": "PRESENT",
"executedCount": 4,
"skippedCount": 0
},
{
"id": "headings",
"coverage": "PRESENT",
"executedCount": 4,
"skippedCount": 0
},
{
"id": "directives",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "canonical",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "hreflang",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "structuredData",
"coverage": "PARTIAL",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "links",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "media",
"coverage": "PRESENT",
"executedCount": 3,
"skippedCount": 0
},
{
"id": "http",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 2
},
{
"id": "performance",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 1
},
{
"id": "rendering",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 2
}
],
"usage": {
"pricingModel": "seo-composite-v1",
"totalUnits": 20,
"baseUnits": 1,
"components": [
{
"skillKey": "seo.extract_meta_tags",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_title_length",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_meta_description",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_missing_metadata",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_headings",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_multiple_h1",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_missing_h1",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_noindex",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_nofollow",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_canonical",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_canonical",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_hreflang",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_hreflang",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_internal_links",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_external_links",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_images",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_image_alt",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_videos",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
}
]
}
}Boundary or option path
{
"documentUrl": "https://www.example.com/",
"profile": "seo.default@1",
"exclude": [
"seo.validate_title_length"
],
"html": "<html><head><title>Home</title><meta name=description content='Hello world from the homepage today with enough characters.'><link rel=canonical href=https://www.example.com/><link rel=alternate hreflang=en href=https://www.example.com/></head><body><h1>Home</h1><p>Hello world</p><a href=/a>A</a><img src=/a.jpg alt=Hero></body></html>"
}{
"coverage": {
"canonical": "PRESENT",
"directives": "PRESENT",
"headings": "PRESENT",
"hreflang": "PRESENT",
"http": "UNKNOWN",
"links": "PRESENT",
"media": "PRESENT",
"metadata": "PRESENT",
"performance": "UNKNOWN",
"rendering": "UNKNOWN",
"structuredData": "PARTIAL"
},
"profile": "seo.default@1",
"skippedChecks": [
{
"skillKey": "seo.validate_title_length",
"reason": "excluded",
"section": "metadata"
},
{
"skillKey": "seo.extract_http_signals",
"reason": "response",
"section": "http"
},
{
"skillKey": "seo.validate_status_code",
"reason": "response",
"section": "http"
},
{
"skillKey": "seo.compute_page_weight",
"reason": "resourceManifest",
"section": "performance"
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"reason": "renderedObservation",
"section": "rendering"
},
{
"skillKey": "seo.detect_rendering_failure",
"reason": "renderedObservation",
"section": "rendering"
}
],
"primitiveFindings": [],
"componentManifest": [
{
"skillKey": "seo.extract_meta_tags",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_title_length",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_meta_description",
"contractVersion": "1.0.0",
"profile": "seo.meta.description@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_missing_metadata",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_headings",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_multiple_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_missing_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_noindex",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_nofollow",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_jsonld",
"contractVersion": "1.0.0",
"profile": "seo.jsonld.1.1.safe@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_schema_types",
"contractVersion": "1.0.0",
"profile": "seo.schemaorg@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_internal_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_external_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_images",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_image_alt",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_videos",
"contractVersion": "1.0.0",
"profile": "seo.google.video@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.extract_http_signals",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.validate_status_code",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.compute_page_weight",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
},
{
"skillKey": "seo.detect_rendering_failure",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"engine": "seo-composite-ledger"
}
],
"summary": {
"auditKey": "seo.audit_page",
"childExecutions": 20,
"findingCount": 0,
"errorCount": 0,
"warningCount": 0,
"skippedCount": 6,
"truncated": false,
"cleanBillOfHealth": false,
"maxChildExecutions": 32,
"maxFindings": 200,
"engine": "seo-composite-ledger",
"profile": "seo.default@1"
},
"executionLedger": [
{
"skillKey": "seo.extract_meta_tags",
"contractVersion": "1.0.0",
"profile": "seo.title.length@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "4a597e11e1dc4e519edd89484dc9d3b25618621e00dc04a5778f306902e5f9ab",
"section": "metadata"
},
{
"skillKey": "seo.validate_title_length",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "excluded",
"section": "metadata",
"findingCount": 0
},
{
"skillKey": "seo.validate_meta_description",
"contractVersion": "1.0.0",
"profile": "seo.meta.description@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "51a17c7894f97a5057a7f5d3ba3cfa4dfcf3b62ed5bd5790de10e18b54678067",
"section": "metadata"
},
{
"skillKey": "seo.detect_missing_metadata",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "0f3c842be834e3e50f8eff95659bdc02abb9ee65db95419d1508f59a0c1dac7e",
"section": "metadata"
},
{
"skillKey": "seo.extract_headings",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "ca4d84cc92d14952db8ed2f27835504bb987f22a42452b94da5594dab619bfda",
"section": "headings"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a69d44f251175ff04a2c3f23165502bf5d53f4132c7b029e020014878a9757ec",
"section": "headings"
},
{
"skillKey": "seo.detect_multiple_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "fb6939888c4a7ae82f369e4e9f9b5491fc81779fe0f74d6fcbf3665a7ca664ba",
"section": "headings"
},
{
"skillKey": "seo.detect_missing_h1",
"contractVersion": "1.0.0",
"profile": "seo.heading.hierarchy@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "b5fde70befb411688a8ed414b6ab3038fce17ce901410eb651c1680b174b9f2d",
"section": "headings"
},
{
"skillKey": "seo.detect_noindex",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "f67f95cda9c2fc692244694a5681fd1a9730412c1da6240ad84ee0b2d48ed5d3",
"section": "directives"
},
{
"skillKey": "seo.detect_nofollow",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a5e1bbdcdea8122aec55e99b34d9f53f5a611acf6bfdd0bb4ea7368328ab3e8b",
"section": "directives"
},
{
"skillKey": "seo.extract_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a8569f66d20d7e9000cb162aaddc4fb52bbb8d07569b777409d5262bbb78ea09",
"section": "canonical"
},
{
"skillKey": "seo.validate_canonical",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "ad45b4f878f433f5c4c9acf802a716a0249c60d881948573f8ac6d249e126c82",
"section": "canonical"
},
{
"skillKey": "seo.extract_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "5248a0d57cadef406784659e8a9ef8bdf8fe6c677411bb99477a09c4bc32a1ad",
"section": "hreflang"
},
{
"skillKey": "seo.validate_hreflang",
"contractVersion": "1.0.0",
"profile": "seo.hreflang.codes@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "24e68252347c26161313d40e2afc5c215083c68492b52215e77ac855a2b46529",
"section": "hreflang"
},
{
"skillKey": "seo.validate_jsonld",
"contractVersion": "1.0.0",
"profile": "seo.jsonld.1.1.safe@1",
"status": "failed",
"reason": "SEO_INPUT_REQUIRED",
"section": "structuredData",
"findingCount": 0
},
{
"skillKey": "seo.extract_schema_types",
"contractVersion": "1.0.0",
"profile": "seo.schemaorg@1",
"status": "failed",
"reason": "SEO_INPUT_REQUIRED",
"section": "structuredData",
"findingCount": 0
},
{
"skillKey": "seo.extract_internal_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "0cb3cf0f46b04d0e9bd512fcfb3c1b7383195a335e8c4964171163af777217d1",
"section": "links"
},
{
"skillKey": "seo.extract_external_links",
"contractVersion": "1.0.0",
"profile": "seo.default@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "a57cea41a0d0d4f44435881076f940e4d1fd54699c57bd94494385e144092a38",
"section": "links"
},
{
"skillKey": "seo.extract_images",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "9119f18fde27061cb0ecb7648bd723a79533c28bd13679345e3699fd629c6ea6",
"section": "media"
},
{
"skillKey": "seo.validate_image_alt",
"contractVersion": "1.0.0",
"profile": "seo.image.alt@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "aa31bcdfb6dff53b6b0c650c65bb32ce1c3cf0b70c6a5984eb2b8f6fa2a7fe17",
"section": "media"
},
{
"skillKey": "seo.extract_videos",
"contractVersion": "1.0.0",
"profile": "seo.google.video@1",
"status": "executed",
"findingCount": 0,
"outputDigest": "2ce6d88bc938da7d910dc233318209ee7bf5add36f2872f9e180fe8842d94640",
"section": "media"
},
{
"skillKey": "seo.extract_http_signals",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "response",
"section": "http",
"findingCount": 0
},
{
"skillKey": "seo.validate_status_code",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "response",
"section": "http",
"findingCount": 0
},
{
"skillKey": "seo.compute_page_weight",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "resourceManifest",
"section": "performance",
"findingCount": 0
},
{
"skillKey": "seo.compare_raw_and_rendered_html",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "renderedObservation",
"section": "rendering",
"findingCount": 0
},
{
"skillKey": "seo.detect_rendering_failure",
"contractVersion": "1.0.0",
"status": "skipped",
"reason": "renderedObservation",
"section": "rendering",
"findingCount": 0
}
],
"cleanBillOfHealth": false,
"engine": "seo-composite-ledger",
"truncated": false,
"contractVersion": "1.0.0",
"sections": [
{
"id": "metadata",
"coverage": "PRESENT",
"executedCount": 3,
"skippedCount": 1
},
{
"id": "headings",
"coverage": "PRESENT",
"executedCount": 4,
"skippedCount": 0
},
{
"id": "directives",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "canonical",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "hreflang",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "structuredData",
"coverage": "PARTIAL",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "links",
"coverage": "PRESENT",
"executedCount": 2,
"skippedCount": 0
},
{
"id": "media",
"coverage": "PRESENT",
"executedCount": 3,
"skippedCount": 0
},
{
"id": "http",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 2
},
{
"id": "performance",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 1
},
{
"id": "rendering",
"coverage": "UNKNOWN",
"executedCount": 0,
"skippedCount": 2
}
],
"usage": {
"pricingModel": "seo-composite-v1",
"totalUnits": 19,
"baseUnits": 1,
"components": [
{
"skillKey": "seo.extract_meta_tags",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_meta_description",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_missing_metadata",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_headings",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_heading_hierarchy",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_multiple_h1",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_missing_h1",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_noindex",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.detect_nofollow",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_canonical",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_canonical",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_hreflang",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_hreflang",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_internal_links",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_external_links",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_images",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.validate_image_alt",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
},
{
"skillKey": "seo.extract_videos",
"itemCount": 1,
"allocatedUnits": 1,
"billingDisposition": "INCLUDED_IN_PARENT"
}
]
}
}Recommended use cases
- Audit a saved PDP snapshot before publish
- Exclude a child you have no evidence for to keep it out of the reservation
Avoid for
- Fetching the live URL
- Predicting ranking
Related skills
Composable with
Safety & privacy
- Runs without calling any external service.
- Your payloads are never stored permanently.
- Telemetry captures metadata only — never your payload contents.
- We never train models on your payloads.
- No human reviews your payloads.