Field notes
Agents need predictable, bounded tools with clear prices and useful outputs.
Example API
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
A fictional planet has two moons.[1]
Its year is 40 days.
A fictional planet has two moons.[1]
Its year is 40 days.
A fictional planet has two moons.[1]
Its year is 40 days.
A fictional planet has two moons.[1]
Its year is 40 days.
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
A fictional planet has two moons.[1]
Its year is 40 days.
A fictional planet has two moons.[1]
Its year is 40 days.
Agents need predictable, bounded tools with clear prices and useful outputs.
| Item |
|---|
| Cup |
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 30 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
Requests time out after 60 seconds. Retry only idempotent requests.
GET /v1/itemsAuthenticationAPI pricing
A fictional planet has two moons.[1]
Its year is 40 days.
![\"Blue](\"/cup.png\")
","baseUrl":"https://example.com/"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/html.images","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/html.images","page":"https://agent-utilities.agent-utilities.workers.dev/tools/html.images","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/html.images","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"html.feeds","version":"1.0.0","category":"html","description":"Discover up to 50 RSS, Atom and JSON Feed links declared in supplied HTML.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"baseUrl":{"type":"string","minLength":1,"maxLength":2048}},"required":["html"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"feeds":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"]},"type":{"type":"string"},"title":{"type":"string"}},"required":["url","type","title"],"additionalProperties":false}},"truncated":{"type":"boolean"}},"required":["feeds","truncated"],"additionalProperties":false},"example":{"html":"","baseUrl":"https://example.com/"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/html.feeds","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/html.feeds","page":"https://agent-utilities.agent-utilities.workers.dev/tools/html.feeds","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/html.feeds","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"data.json-pointer","version":"1.0.0","category":"data","description":"Select JSON values with up to 100 RFC 6901 pointer strings, preserving missing versus null.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"data":{},"paths":{"type":"array","items":{"type":"string","maxLength":2048},"maxItems":100}},"required":["data","paths"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"selections":{"type":"array","items":{"type":"object","properties":{"pointer":{"type":"string"},"found":{"type":"boolean"},"value":{}},"required":["pointer","found"],"additionalProperties":false}}},"required":["selections"],"additionalProperties":false},"example":{"data":{"product":{"name":"Cup"}},"paths":["/product/name","/price"]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/data.json-pointer","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/data.json-pointer","page":"https://agent-utilities.agent-utilities.workers.dev/tools/data.json-pointer","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/data.json-pointer","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"data.json-diff","version":"1.0.0","category":"data","description":"Compare JSON structures and return bounded changes at JSON Pointer paths.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"before":{},"after":{},"maxChanges":{"type":"integer","minimum":1,"maximum":200}},"required":["before","after"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"equal":{"type":"boolean"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"kind":{"type":"string"},"before":{},"after":{}},"required":["path","kind"],"additionalProperties":false}},"truncated":{"type":"boolean"},"scope":{"type":"string"}},"required":["equal","changes","truncated","scope"],"additionalProperties":false},"example":{"before":{"price":10},"after":{"price":12,"inStock":true}},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/data.json-diff","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/data.json-diff","page":"https://agent-utilities.agent-utilities.workers.dev/tools/data.json-diff","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/data.json-diff","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"data.json-canonical","version":"1.0.0","category":"data","description":"Serialize JSON with sorted object keys for deterministic comparison; not RFC 8785 certification.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"data":{}},"required":["data"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"text":{"type":"string"},"profile":{"type":"string"}},"required":["text","profile"],"additionalProperties":false},"example":{"data":{"z":2,"a":1}},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/data.json-canonical","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/data.json-canonical","page":"https://agent-utilities.agent-utilities.workers.dev/tools/data.json-canonical","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/data.json-canonical","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"security.jwt-inspect","version":"1.0.0","category":"security","description":"Decode untrusted JWT claims and optionally compare timestamps; never verifies a signature.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":20000},"atUnixSeconds":{"type":"integer","minimum":0}},"required":["token"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"header":{"type":"object"},"claims":{"type":"object"},"signatureVerified":{"const":false},"expired":{"type":["boolean","null"]},"notYetValid":{"type":["boolean","null"]},"warnings":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["header","claims","signatureVerified","expired","notYetValid","warnings","scope"],"additionalProperties":false},"example":{"token":"eyJhbGciOiJub25lIn0.eyJzdWIiOiJkZW1vIn0."},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":true,"route":"/v1/tools/security.jwt-inspect","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/security.jwt-inspect","page":"https://agent-utilities.agent-utilities.workers.dev/tools/security.jwt-inspect","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/security.jwt-inspect","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"security.csp-audit","version":"1.0.0","category":"security","description":"Parse a supplied Content Security Policy and flag selected risky or missing directives.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"policy":{"type":"string","maxLength":16000}},"required":["policy"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"directives":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}}},"required":["name","sources"],"additionalProperties":false}},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["directives","findings","scope"],"additionalProperties":false},"example":{"policy":"default-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/security.csp-audit","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/security.csp-audit","page":"https://agent-utilities.agent-utilities.workers.dev/tools/security.csp-audit","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/security.csp-audit","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"security.header-audit","version":"1.0.0","category":"security","description":"Review supplied response headers for selected security and CORS issues without echoing values.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"headers":{"type":"object","maxProperties":100,"additionalProperties":{"type":"string","maxLength":8192}}},"required":["headers"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"headerNames":{"type":"array","items":{"type":"string"}},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["headerNames","findings","scope"],"additionalProperties":false},"example":{"headers":{"X-Content-Type-Options":"nosniff"}},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":true,"route":"/v1/tools/security.header-audit","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/security.header-audit","page":"https://agent-utilities.agent-utilities.workers.dev/tools/security.header-audit","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/security.header-audit","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"security.cookie-audit","version":"1.0.0","category":"security","description":"Check up to 50 Set-Cookie headers for security attributes and prefix rules; masks cookie values.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"setCookies":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":50}},"required":["setCookies"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"cookies":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"const":"[REDACTED]"},"secure":{"type":"boolean"},"httpOnly":{"type":"boolean"},"sameSite":{"type":"string"},"hasDomain":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}}},"required":["name","value","secure","httpOnly","sameSite","hasDomain","findings"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["cookies","scope"],"additionalProperties":false},"example":{"setCookies":["demo=example; Secure; HttpOnly; SameSite=Lax; Path=/"]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":true,"route":"/v1/tools/security.cookie-audit","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/security.cookie-audit","page":"https://agent-utilities.agent-utilities.workers.dev/tools/security.cookie-audit","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/security.cookie-audit","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"agents.env-template-check","version":"1.0.0","category":"agents","description":"Compare environment-variable names against a template; never returns assignment values.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"template":{"type":"string","maxLength":100000},"actual":{"type":"string","maxLength":100000}},"required":["template","actual"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"missing":{"type":"array","items":{"type":"string"}},"extra":{"type":"array","items":{"type":"string"}},"duplicateNames":{"type":"array","items":{"type":"string"}},"templateDuplicateNames":{"type":"array","items":{"type":"string"}},"unrecognizedLines":{"type":"object","properties":{"template":{"type":"number"},"actual":{"type":"number"}},"required":["template","actual"],"additionalProperties":false},"scope":{"type":"string"}},"required":["missing","extra","duplicateNames","templateDuplicateNames","unrecognizedLines","scope"],"additionalProperties":false},"example":{"template":"APP_URL=\nLOG_LEVEL=","actual":"APP_URL=https://example.com"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":true,"route":"/v1/tools/agents.env-template-check","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/agents.env-template-check","page":"https://agent-utilities.agent-utilities.workers.dev/tools/agents.env-template-check","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/agents.env-template-check","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"agents.tool-name-conflicts","version":"1.0.0","category":"agents","description":"Find duplicate or easily confused tool names after Unicode, case and separator normalization.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":200}},"required":["names"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"conflicts":{"type":"array","items":{"type":"object","properties":{"normalized":{"type":"string"},"kind":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"index":{"type":"number"}},"required":["name","index"],"additionalProperties":false}}},"required":["normalized","kind","items"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["conflicts","scope"],"additionalProperties":false},"example":{"names":["get_price","Get-Price","checkout"]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/agents.tool-name-conflicts","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/agents.tool-name-conflicts","page":"https://agent-utilities.agent-utilities.workers.dev/tools/agents.tool-name-conflicts","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/agents.tool-name-conflicts","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"text.chunk","version":"1.0.0","category":"text","description":"Split text into at most 200 overlapping chunks with offsets and intact UTF-16 surrogate pairs.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"text":{"type":"string","maxLength":100000},"maxChars":{"type":"integer","minimum":32,"maximum":10000},"overlap":{"type":"integer","minimum":0,"maximum":500}},"required":["text"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"chunks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"offsetUnit":{"type":"string"},"count":{"type":"number"}},"required":["chunks","offsetUnit","count"],"additionalProperties":false},"example":{"text":"Agents can reuse bounded snippets of a longer document.","maxChars":32,"overlap":8},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/text.chunk","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/text.chunk","page":"https://agent-utilities.agent-utilities.workers.dev/tools/text.chunk","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/text.chunk","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.gtin-validate","version":"1.0.0","category":"commerce","description":"Validate GTIN-8, UPC/GTIN-12, EAN/GTIN-13 and GTIN-14 check digits; no product lookup.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"code":{"type":"string","maxLength":32}},"required":["code"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"valid":{"type":"boolean"},"format":{"type":"string"},"expectedCheckDigit":{"type":["string","null"]},"scope":{"type":"string"}},"required":["valid","format","expectedCheckDigit","scope"],"additionalProperties":false},"example":{"code":"036000291452"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.gtin-validate","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.gtin-validate","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.gtin-validate","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.gtin-validate","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.variant-compare","version":"1.0.0","category":"commerce","description":"Compare requested product attributes with an offered variant and list missing or mismatched fields.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"requested":{"type":"object","maxProperties":100},"offered":{"type":"object","maxProperties":100}},"required":["requested","offered"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"matches":{"type":"boolean"},"missing":{"type":"array","items":{"type":"string"}},"mismatched":{"type":"array","items":{"type":"object","properties":{"attribute":{"type":"string"},"requested":{},"offered":{}},"required":["attribute","requested","offered"],"additionalProperties":false}},"extra":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["matches","missing","mismatched","extra","scope"],"additionalProperties":false},"example":{"requested":{"color":"blue","size":"M"},"offered":{"color":"blue","size":"L","stock":true}},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.variant-compare","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.variant-compare","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.variant-compare","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.variant-compare","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.pack-plan","version":"1.0.0","category":"commerce","description":"Choose the lowest-cost whole-pack combination for a required count with exact prices and explicit pack limits; up to 20 interchangeable offers.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"requiredUnits":{"type":"integer","minimum":1,"maximum":1000},"offers":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"unitsPerPack":{"type":"integer","minimum":1,"maximum":1000},"price":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"maxPacks":{"type":"integer","minimum":0,"maximum":1000}},"required":["id","unitsPerPack","price","maxPacks"],"additionalProperties":false}}},"required":["currency","minorUnitDigits","requiredUnits","offers"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"requiredUnits":{"type":"number"},"feasible":{"type":"boolean"},"totalUnits":{"type":["integer","null"]},"excessUnits":{"type":["integer","null"]},"itemSubtotal":{"type":["string","null"]},"packCount":{"type":["integer","null"]},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"packs":{"type":"number"},"units":{"type":"number"},"lineSubtotal":{"type":"string"}},"required":["id","packs","units","lineSubtotal"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["currency","minorUnitDigits","requiredUnits","feasible","totalUnits","excessUnits","itemSubtotal","packCount","lines","scope"],"additionalProperties":false},"example":{"currency":"USD","minorUnitDigits":2,"requiredUnits":12,"offers":[{"id":"six-pack","unitsPerPack":6,"price":"7.99","maxPacks":10},{"id":"ten-pack","unitsPerPack":10,"price":"11.99","maxPacks":10}]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.pack-plan","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.pack-plan","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.pack-plan","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.pack-plan","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.money-parse","version":"1.0.0","category":"commerce","description":"Normalize up to 50 displayed prices with explicit locale, currency and decimal scale; exact amounts, strict grouping and per-price errors.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"locale":{"type":"string","enum":["en-US","en-GB","de-DE","fr-FR","en-IN"]},"currency":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD","JPY","INR"]},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"amounts":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"text":{"type":"string","minLength":1,"maxLength":100}},"required":["id","text"],"additionalProperties":false}}},"required":["locale","currency","minorUnitDigits","amounts"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"locale":{"type":"string"},"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"amounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"valid":{"type":"boolean"},"amount":{"type":["string","null"]},"minorUnits":{"type":["string","null"]},"currencyToken":{"type":["string","null"]},"issue":{"type":["string","null"]}},"required":["id","valid","amount","minorUnits","currencyToken","issue"],"additionalProperties":false}},"allValid":{"type":"boolean"},"acceptedCurrencyTokens":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["locale","currency","minorUnitDigits","amounts","allValid","acceptedCurrencyTokens","scope"],"additionalProperties":false},"example":{"locale":"de-DE","currency":"EUR","minorUnitDigits":2,"amounts":[{"id":"offer-1","text":"1.234,56 €"},{"id":"offer-2","text":"EUR 999,95"},{"id":"range","text":"10–20 €"}]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.money-parse","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.money-parse","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.money-parse","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.money-parse","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.offer-extract","version":"1.0.0","category":"commerce","description":"Extract bounded Product offers from supplied JSON-LD HTML with source pointers, missing-price warnings and separate aggregate ranges.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"baseUrl":{"type":"string","maxLength":2048},"maxOffers":{"type":"integer","minimum":1,"maximum":50}},"required":["html"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"offers":{"type":"array","items":{"type":"object","properties":{"productName":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"offerType":{"type":"string"},"price":{"type":["string","null"]},"currency":{"type":["string","null"]},"lowPrice":{"type":["string","null"]},"highPrice":{"type":["string","null"]},"url":{"type":["string","null"]},"availability":{"type":["string","null"]},"itemCondition":{"type":["string","null"]},"priceValidUntil":{"type":["string","null"]},"source":{"type":"object","properties":{"productBlock":{"type":"number"},"productPointer":{"type":"string"},"offerBlock":{"type":"number"},"offerPointer":{"type":"string"}},"required":["productBlock","productPointer","offerBlock","offerPointer"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["productName","sku","gtin","offerType","price","currency","lowPrice","highPrice","url","availability","itemCondition","priceValidUntil","source","warnings"],"additionalProperties":false}},"productsFound":{"type":"number"},"productsWithoutOffers":{"type":"number"},"invalidBlocks":{"type":"number"},"unresolvedReferences":{"type":"number"},"unsupportedOffers":{"type":"number"},"truncated":{"type":"boolean"},"scope":{"type":"string"}},"required":["offers","productsFound","productsWithoutOffers","invalidBlocks","unresolvedReferences","unsupportedOffers","truncated","scope"],"additionalProperties":false},"example":{"html":"","baseUrl":"https://example.com/shop"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.offer-extract","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.offer-extract","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.offer-extract","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.offer-extract","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.unit-price","version":"1.0.0","category":"commerce","description":"Compare up to 50 explicit pack prices with exact arithmetic across compatible mass, volume or count units; no currency conversion.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"reference":{"type":"object","properties":{"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]}},"required":["quantity","unit"],"additionalProperties":false},"offers":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"price":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]},"packCount":{"type":"integer","minimum":1,"maximum":10000}},"required":["id","price","quantity","unit"],"additionalProperties":false}}},"required":["currency","reference","offers"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"currency":{"type":"string"},"reference":{"type":"object","properties":{"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]}},"required":["quantity","unit"],"additionalProperties":false},"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"totalQuantity":{"type":"object","properties":{"numerator":{"type":"string"},"denominator":{"type":"string"},"unit":{"type":"string"}},"required":["numerator","denominator","unit"],"additionalProperties":false},"pricePerReference":{"type":"string"},"exactPricePerReference":{"type":"object","properties":{"numerator":{"type":"string"},"denominator":{"type":"string"}},"required":["numerator","denominator"],"additionalProperties":false}},"required":["id","totalQuantity","pricePerReference","exactPricePerReference"],"additionalProperties":false}},"cheapestIds":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["currency","reference","offers","cheapestIds","scope"],"additionalProperties":false},"example":{"currency":"USD","reference":{"quantity":"100","unit":"g"},"offers":[{"id":"500g-bag","price":"8.99","quantity":"500","unit":"g"},{"id":"1kg-bag","price":"16.49","quantity":"1","unit":"kg"}]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.unit-price","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.unit-price","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.unit-price","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.unit-price","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.price-components","version":"1.0.0","category":"commerce","description":"Reconcile item, discount, shipping, tax and fee amounts using exact decimals; missing costs stay unknown and declared totals can be checked.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"unitPrice":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"quantity":{"type":"integer","minimum":1,"maximum":100000},"discount":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19}},"required":["id","unitPrice","quantity","discount"],"additionalProperties":false}},"orderDiscount":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"shipping":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"tax":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"fees":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"declaredTotal":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19}},"required":["currency","minorUnitDigits","items","orderDiscount","shipping","tax","fees"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"subtotal":{"type":"string"},"discount":{"type":"string"},"total":{"type":"string"}},"required":["id","subtotal","discount","total"],"additionalProperties":false}},"itemSubtotal":{"type":"string"},"lineDiscounts":{"type":"string"},"orderDiscount":{"type":"string"},"knownTotal":{"type":"string"},"total":{"type":["string","null"]},"missingComponents":{"type":"array","items":{"type":"string"}},"matchesDeclaredTotal":{"type":["boolean","null"]},"difference":{"type":["string","null"]},"scope":{"type":"string"}},"required":["currency","minorUnitDigits","lines","itemSubtotal","lineDiscounts","orderDiscount","knownTotal","total","missingComponents","matchesDeclaredTotal","difference","scope"],"additionalProperties":false},"example":{"currency":"USD","minorUnitDigits":2,"items":[{"id":"1kg-bag","unitPrice":"16.49","quantity":2,"discount":"0.00"}],"orderDiscount":"2.00","shipping":"4.99","tax":null,"fees":"0.00"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.price-components","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.price-components","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.price-components","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.price-components","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.main-product","version":"1.0.0","category":"commerce","description":"Identify the main Product or ProductGroup from supplied JSON-LD HTML using identity, mainEntity and canonical evidence; abstain on ambiguity.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"pageUrl":{"type":"string","maxLength":2048}},"required":["html"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["selected","ambiguous","no_product"]},"reason":{"type":"string"},"selectedId":{"type":["string","null"]},"selected":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["Product","ProductGroup"]},"name":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"brand":{"type":["string","null"]},"mpn":{"type":["string","null"]},"url":{"type":["string","null"]},"variantCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"block":{"type":"number"},"pointer":{"type":"string"}},"required":["block","pointer"],"additionalProperties":false}},"offers":{"type":"array","items":{"type":"object","properties":{"productName":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"offerType":{"type":"string"},"price":{"type":["string","null"]},"currency":{"type":["string","null"]},"lowPrice":{"type":["string","null"]},"highPrice":{"type":["string","null"]},"url":{"type":["string","null"]},"availability":{"type":["string","null"]},"itemCondition":{"type":["string","null"]},"priceValidUntil":{"type":["string","null"]},"source":{"type":"object","properties":{"productBlock":{"type":"number"},"productPointer":{"type":"string"},"offerBlock":{"type":"number"},"offerPointer":{"type":"string"}},"required":["productBlock","productPointer","offerBlock","offerPointer"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["productName","sku","gtin","offerType","price","currency","lowPrice","highPrice","url","availability","itemCondition","priceValidUntil","source","warnings"],"additionalProperties":false}}},"required":["id","kind","name","sku","gtin","brand","mpn","url","variantCount","sources","offers"],"additionalProperties":false},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["Product","ProductGroup"]},"name":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"brand":{"type":["string","null"]},"mpn":{"type":["string","null"]},"url":{"type":["string","null"]},"variantCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"block":{"type":"number"},"pointer":{"type":"string"}},"required":["block","pointer"],"additionalProperties":false}},"offers":{"type":"array","items":{"type":"object","properties":{"productName":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"offerType":{"type":"string"},"price":{"type":["string","null"]},"currency":{"type":["string","null"]},"lowPrice":{"type":["string","null"]},"highPrice":{"type":["string","null"]},"url":{"type":["string","null"]},"availability":{"type":["string","null"]},"itemCondition":{"type":["string","null"]},"priceValidUntil":{"type":["string","null"]},"source":{"type":"object","properties":{"productBlock":{"type":"number"},"productPointer":{"type":"string"},"offerBlock":{"type":"number"},"offerPointer":{"type":"string"}},"required":["productBlock","productPointer","offerBlock","offerPointer"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["productName","sku","gtin","offerType","price","currency","lowPrice","highPrice","url","availability","itemCondition","priceValidUntil","source","warnings"],"additionalProperties":false}}},"required":["id","kind","name","sku","gtin","brand","mpn","url","variantCount","sources","offers"],"additionalProperties":false}},"distinctProducts":{"type":"number"},"canonicalUrl":{"type":["string","null"]},"pageTypes":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["status","reason","selectedId","selected","candidates","distinctProducts","canonicalUrl","pageTypes","warnings","scope"],"additionalProperties":false},"example":{"html":"","pageUrl":"https://example.com/coffee"},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.main-product","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.main-product","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.main-product","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.main-product","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.pack-size-normalize","version":"1.0.0","category":"commerce","description":"Normalize locale-explicit pack-size expressions and multipacks to exact grams, millilitres or counts; reject ambiguous text.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"locale":{"type":"string","enum":["en-US","en-GB","de-DE","fr-FR","pt-BR"]},"quantities":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"text":{"type":"string","minLength":1,"maxLength":160}},"required":["id","text"],"additionalProperties":false}}},"required":["locale","quantities"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"locale":{"type":"string"},"quantities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["normalized","unsupported"]},"quantity":{"type":["string","null"]},"unit":{"type":["string","null"]},"packCount":{"type":["integer","null"]},"totalQuantity":{"type":["string","null"]},"baseUnit":{"type":["string","null"]},"dimension":{"type":["string","null"]},"approximate":{"type":"boolean"},"issue":{"type":["string","null"]}},"required":["id","status","quantity","unit","packCount","totalQuantity","baseUnit","dimension","approximate","issue"],"additionalProperties":false}},"allNormalized":{"type":"boolean"},"scope":{"type":"string"}},"required":["locale","quantities","allNormalized","scope"],"additionalProperties":false},"example":{"locale":"pt-BR","quantities":[{"id":"milk","text":"6 x 1,5 litros"},{"id":"chicken","text":"Aprox. 2,8 Kg"},{"id":"unclear","text":"500g + 20% free"}]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.pack-size-normalize","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.pack-size-normalize","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.pack-size-normalize","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.pack-size-normalize","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}},{"id":"commerce.feed-page-compare","version":"1.1.0","category":"commerce","description":"Compare supplied feed identity, price, currency and availability with selected JSON-LD product evidence; preserve conflicts and unknown fields. Optional availabilityProfile google_merchant applies Google feed mappings; generic is the default.","priceMicroUsdc":0,"priceRevision":"2026-10-06-free-validation","pricingStatus":"free-validation","inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"pageUrl":{"type":"string","maxLength":2048},"availabilityProfile":{"type":"string","enum":["generic","google_merchant"],"description":"Default generic preserves existing vocabulary distinctions. google_merchant maps non-vehicle Schema.org availability to Google feed categories; not an eligibility check."},"feed":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":512},"gtin":{"type":"string","pattern":"^\\d{8,14}$"},"mpn":{"type":"string","minLength":1,"maxLength":512},"price":{"type":"string","maxLength":30},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"availability":{"type":"string","maxLength":100}},"required":[],"additionalProperties":false},"offerUrl":{"type":"string","maxLength":2048}},"required":["html","feed"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["match","mismatch","identity_mismatch","inconclusive"]},"identityStatus":{"type":"string","enum":["match","mismatch","unknown"]},"availabilityProfile":{"type":"string","enum":["generic","google_merchant"]},"selection":{"type":"object","properties":{"status":{"type":"string","enum":["selected","ambiguous","no_product"]},"reason":{"type":"string"},"selectedId":{"type":["string","null"]}},"required":["status","reason","selectedId"],"additionalProperties":false},"checks":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"feedValue":{"type":["string","null"]},"pageValues":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["match","mismatch","ambiguous","unknown","not_supplied"]},"reason":{"type":"string"}},"required":["field","feedValue","pageValues","status","reason"],"additionalProperties":false}},"evidence":{"anyOf":[{"type":"object","properties":{"productSources":{"type":"array","items":{"type":"object","properties":{"block":{"type":"number"},"pointer":{"type":"string"}},"required":["block","pointer"],"additionalProperties":false}},"offerSources":{"type":"array","items":{"type":"object","properties":{"productBlock":{"type":"number"},"productPointer":{"type":"string"},"offerBlock":{"type":"number"},"offerPointer":{"type":"string"}},"required":["productBlock","productPointer","offerBlock","offerPointer"],"additionalProperties":false}},"originalAvailability":{"type":"array","items":{"type":["string","null"]}}},"required":["productSources","offerSources","originalAvailability"],"additionalProperties":false},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["status","identityStatus","availabilityProfile","selection","checks","evidence","warnings","scope"],"additionalProperties":false},"example":{"html":"","pageUrl":"https://example.com/coffee","feed":{"sku":"COFFEE-500","price":"9.49","currency":"USD","availability":"in_stock"}},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.feed-page-compare","priceMicroUsd":0,"exampleUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/commerce.feed-page-compare","page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.feed-page-compare","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.feed-page-compare","requiredHeaders":{"Content-Type":"application/json"},"authentication":"none","paymentRequired":false,"chargedMicroUsd":"0","scope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}}],"workflows":[{"slug":"compare-delivered-carts","title":"Compare checkout totals after shipping and discounts","label":"Checkout comparison","description":"Compare supplied carts with exact amounts, preserve unknown shipping or tax, and avoid choosing a winner from item prices alone.","problem":"The same item costs $18 at one checkout and $22 at another. With supplied shipping, discounts and tax, their totals become $25.49 and $22.50. These fictional snapshots demonstrate why the lower item price can lose. Confirm that carts meet the same requirements before comparing them.","steps":[{"tool":"commerce.price-components","title":"Reconcile lower-item-price","text":"Send this supplied snapshot as one separate call. Inspect total, missingComponents and any declared-total mismatch. Missing shipping, tax or fees must stay null; never replace an unknown cost with zero.","sampleInput":{"currency":"USD","minorUnitDigits":2,"items":[{"id":"identical-item","unitPrice":"18.00","quantity":1,"discount":"0.00"}],"orderDiscount":"0.00","shipping":"5.99","tax":"1.50","fees":"0.00"}},{"tool":"commerce.price-components","title":"Reconcile free-shipping","text":"Send this supplied snapshot as one separate call. Inspect total, missingComponents and any declared-total mismatch. Missing shipping, tax or fees must stay null; never replace an unknown cost with zero.","sampleInput":{"currency":"USD","minorUnitDigits":2,"items":[{"id":"identical-item","unitPrice":"22.00","quantity":1,"discount":"0.00"}],"orderDiscount":"1.00","shipping":"0.00","tax":"1.50","fees":"0.00"}}],"exampleScope":"Fictional checkout snapshots shared with the downloadable recipe. Sample inputs are not live merchant offers or customer activity.","recipe":{"url":"https://agent-utilities.agent-utilities.workers.dev/downloads/compare_carts.py","inputUrl":"https://agent-utilities.agent-utilities.workers.dev/downloads/cart_comparison_example.json","guideUrl":"https://agent-utilities.agent-utilities.workers.dev/integrations/python#compare-carts","preview":"python3 compare_carts.py","scope":"Default preview prepares inputs offline. --execute performs 2–10 free full calls without a key or payment; stop on failure, with no paid fallback. Supplied comparable carts only."},"outcome":"For these complete supplied snapshots, free-shipping has the lower total at $22.50, versus $25.49. Compare exact minor-unit integers in one currency and retain ties. Any incomplete candidate prevents an overall winner, even when other carts have known totals. A declared-total mismatch needs review. These are supplied-data calculations, not live quotes, tax advice, product-equivalence checks or orders.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/compare-delivered-carts","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/compare-delivered-carts","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"choose-whole-packs","title":"Buy enough units without choosing the wrong pack mix","label":"Shopping agents","description":"Compare unit prices, choose whole packs under supplied stock limits, and reconcile the resulting item subtotal with delivery costs.","problem":"The lowest price per unit is not always the cheapest way to buy a requested quantity. For twelve identical items, two six-packs at $7.99 each cost less than two ten-packs at $11.99 each, even though the ten-pack has the lower unit price. First establish that the items are interchangeable; these tools do not verify compatibility.","steps":[{"tool":"commerce.unit-price","title":"See the unit-price tradeoff","text":"Compare each offer using unit each, quantity equal to the number of units in one pack, and the whole-pack price. A six-pack at $7.99 costs about $1.331667 per item; a ten-pack at $11.99 costs $1.199. This comparison alone does not choose how many packs to buy."},{"tool":"commerce.pack-plan","title":"Choose an exact whole-pack combination","text":"Set requiredUnits to 12, supply those pack sizes and prices, and set maxPacks to the actual limit you know for each offer. With ten packs available for each, the minimum item subtotal is $15.98: two six-packs, twelve items and no excess. Two ten-packs would cost $23.98. Prices tie-break by least excess, then fewest packs. Unknown stock is not unlimited; obtain a usable limit before planning."},{"tool":"commerce.price-components","title":"Include the remaining checkout costs","text":"For each selected plan line, map its original offer price to unitPrice and its packs count to quantity; quantity here counts packs, not individual units. Supply explicit discounts and shipping, tax and fees. Keep unknown components null. The $15.98 item subtotal is not a verified delivered total."}],"outcome":"A minimum item-cost basket within supplied pack limits, plus a separate reconciliation of known checkout costs. Use interchangeable units in one currency. Shipping thresholds, coupons and cross-merchant costs can change the best delivered basket and are outside this planner. No merchant inventory is reserved and no order is placed.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/choose-whole-packs","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/choose-whole-packs","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"normalize-prices-update-cart","title":"Normalize displayed prices and update a cart snapshot","label":"Shopping data cleanup","description":"Parse prices with an explicit locale, apply guarded JSON changes, and reconcile a supplied cart with exact arithmetic.","problem":"Displayed prices may use different decimal separators, and an agent can overwrite the wrong cart entry if it applies an unguarded change. Normalize prices first, then test the expected record before editing its snapshot.","steps":[{"tool":"commerce.money-parse","title":"Read the price with its declared format","text":"Supply a supported locale, currency and decimal scale. For example, 1.234,56 € with de-DE, EUR and two decimal places becomes 1234.56. Check each returned valid flag; ranges, prose, conflicting currency tokens and excess precision remain errors. A shared $ symbol does not establish which dollar currency the merchant uses."},{"tool":"data.json-patch","title":"Guard changes to the supplied snapshot","text":"Use a test operation on the expected SKU or currency before replacing a price or quantity. Map only a valid normalized amount into the patch value. Array additions insert at an index; /- appends. If any operation fails, no result is committed and the original supplied snapshot is unchanged. This tool does not write to a merchant cart or place an order."},{"tool":"commerce.price-components","title":"Recalculate explicit components","text":"Map the updated snapshot into the item schema, including unitPrice, quantity and discount. Supply the same declared currency and decimal scale. Keep unavailable shipping, tax and fees as null. A known subtotal is not a complete checkout total until every component is supplied."}],"outcome":"Normalized price strings, a guarded JSON snapshot and an exact reconciliation. Each operation is a separate call; currency selection, product identity and permission to modify a real cart remain the caller's responsibility.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/normalize-prices-update-cart","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/normalize-prices-update-cart","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"shopping-agent-data","title":"Check product data before your agent decides","label":"Shopping agents","description":"Extract structured product information, validate retail identifiers and compare requested variants with an offer.","problem":"A product page can describe several sizes, colors and offers. Your agent needs to distinguish the item it wants from the item a merchant actually offers.","steps":[{"tool":"commerce.offer-extract","title":"Extract the declared product offers","text":"Pass the HTML your agent already obtained. Product offers retain source pointers, currency, price and availability when supplied. Missing prices, aggregate ranges and ambiguous price specifications remain explicit. Extraction does not establish that a listing is accurate."},{"tool":"commerce.gtin-validate","title":"Check the retail identifier","text":"Validate the check digit before comparing identifiers across listings. A valid GTIN is a structural check, not proof that the item exists or that a seller is trustworthy."},{"tool":"commerce.variant-compare","title":"Compare the actual variant","text":"Supply the requested and offered attributes explicitly. The result separates missing fields from mismatches, so a blue medium shirt is not silently replaced with a large one."}],"outcome":"A structured set of facts and mismatches that your agent can use in its decision. These tools do not place orders or determine merchant trustworthiness.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/shopping-agent-data","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/shopping-agent-data","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"compare-shopping-costs","title":"Compare pack prices without hiding missing costs","label":"Price comparison","description":"Extract declared product offers, compare compatible pack sizes with exact arithmetic, and reconcile a cart while keeping unknown shipping or tax visible.","problem":"A larger pack can have a lower unit price but a higher checkout total. Give your agent separate answers for the product offer, the price per unit, and the costs that are still unknown.","steps":[{"tool":"commerce.offer-extract","title":"Keep the price attached to its source","text":"Extract each supplied product page. Use an individual Offer price and currency, retaining its source pointer. Do not replace an individual price with an AggregateOffer lowPrice or choose a conditional member price without checking eligibility."},{"tool":"commerce.unit-price","title":"Compare the same quantity","text":"Map each individual offer price to the price field. Supply verified packCount, quantity and unit explicitly; package size is not inferred from a product title. For example, $8.99 for 500 g is $1.798 per 100 g, while $16.49 for 1 kg is $1.649 per 100 g. All prices must be in the same declared currency."},{"tool":"commerce.price-components","title":"Reconcile what the cart actually includes","text":"Pass the selected whole-pack price as unitPrice, plus item count and explicit line and order discounts. Declare the currency decimal places and provide shipping, tax and fees as amounts or null when unknown. The example with two $16.49 bags, a $2 discount and $4.99 shipping has a known total of $35.97; unknown tax keeps the final total null."}],"outcome":"An exact unit-price comparison and a separately reconciled cart. The lowest unit price is not a recommendation about product quality or final delivered cost. These tools never place orders, convert currencies or calculate tax from local law.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/compare-shopping-costs","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/compare-shopping-costs","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"web-page-extraction","title":"Turn supplied HTML into structured research inputs","label":"Research workflows","description":"Extract article text, source metadata and links, then split text into bounded chunks with source offsets.","problem":"Navigation, repeated links and formatting make raw HTML awkward to use in a research workflow. Keep extraction separate from interpretation and preserve the source context.","steps":[{"tool":"html.metadata","title":"Keep the page context","text":"Extract the title, description, declared canonical URL and language. Supply the source URL to resolve relative links. Declared metadata can be incorrect; keep your original source URL too."},{"tool":"html.main-text","title":"Extract readable content","text":"Send the same supplied HTML to obtain article text and the extraction method. This parses HTML; it does not execute JavaScript or render content that is absent from the document."},{"tool":"text.chunk","title":"Keep bounded snippets and offsets","text":"Split extracted text into overlapping chunks. Offsets use UTF-16 units, and surrogate pairs remain intact. This is character-based chunking, not a model-specific token count."}],"outcome":"Readable, bounded chunks alongside source metadata, ready for your own retrieval or summarization workflow. The agent supplies the HTML it is authorized to access.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/web-page-extraction","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/web-page-extraction","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."},{"slug":"agent-configuration-checks","title":"Catch configuration mistakes before a run","label":"Agent developers","description":"Compare environment templates, find conflicting tool names and run bounded configuration heuristics.","problem":"Missing environment variables and confusing tool names can break an otherwise working agent. Check these deterministic details before starting a long run.","steps":[{"tool":"agents.env-template-check","title":"Compare environment-variable names","text":"Supply a template and configuration to find missing, extra and duplicate variable names. Values are not returned. Prefer sanitized assignments when checking names; real credentials are unnecessary."},{"tool":"agents.tool-name-conflicts","title":"Find ambiguous tool names","text":"Check a combined tool catalog for duplicate names and collisions after Unicode, case and separator normalization. A conflict is a prompt to review naming, not proof of a client failure."},{"tool":"agents.config-audit","title":"Review explicit risk indicators","text":"Apply five fixed heuristics to configuration text. Findings identify matched language for review. They cannot certify that an agent is safe or enforce its permissions."}],"outcome":"A short list of concrete configuration issues to review before execution. Keep permission enforcement and credential storage in your own runtime.","url":"https://agent-utilities.agent-utilities.workers.dev/use-cases/agent-configuration-checks","apiUrl":"https://agent-utilities.agent-utilities.workers.dev/v1/content/workflows/agent-configuration-checks","estimatedMicroUsd":0,"pricingScope":"All available hosted tools are free during validation. Existing input, output and source-access limits apply. Full tools and the combined report share capacity limits that count attempts, including failed executions and marked checks; they are not per-user allowances. No account, API key, wallet or funding is needed. Existing credit balances are preserved. Live Reddit remains unavailable until configured. Paid billing will not resume automatically."}],"docs":[{"id":"seo-page-library","title":"Free SEO audit and reusable page library","markdown":"# Free SEO audit and reusable page library\n\nUse public or sanitized HTML snapshots. No account, key, wallet or model purchase is required. All fetching happens through the local bounded crawler or the official Wikipedia reader, not through arbitrary hosted URL scraping.\n\n## Start in your browser\n\n[Check one page](https://agent-utilities.agent-utilities.workers.dev/seo#start) by supplying a page URL and its static HTML. No command line or JSON authoring is needed. Supplying the URL does not fetch it. HTML is parsed locally, is not rendered as a page and is not uploaded or saved by the service. The simple HTML form leaves capture time and HTTP status unknown. An advanced snapshot can include them when known; the tool does not invent those observations.\n\nDownload the snapshot after inspecting its findings. At your next actual site edit or review, capture the same pages again and [compare both snapshots](https://agent-utilities.agent-utilities.workers.dev/seo#compare). The comparison runs locally and preserves dates, coverage, page availability and omission counts. You can download the compact result for your agent or release notes. The built-in demonstration is fictional and labeled accordingly.\n\nNeither a missing finding nor a failed page proves that an issue was fixed. Findings that depend on other pages can also change when capture coverage changes. These are static HTML observations, not rendered-browser, search-index or ranking checks. Multi-page capture and refresh remain available through the bounded local crawler below.\n\n## Audit a supplied snapshot\n\n### Try a complete offline SEO comparison first\n\nDownload the [crawler](https://agent-utilities.agent-utilities.workers.dev/downloads/agent-utilities-seo.mjs), its [checksum](https://agent-utilities.agent-utilities.workers.dev/downloads/agent-utilities-seo.mjs.sha256), and these example files into the same folder:\n\n- [Before snapshot](https://agent-utilities.agent-utilities.workers.dev/downloads/seo-change-example-before.json)\n- [After snapshot](https://agent-utilities.agent-utilities.workers.dev/downloads/seo-change-example-after.json)\n- [Complete expected result](https://agent-utilities.agent-utilities.workers.dev/downloads/seo-change-example-result.json)\n- [Example checksums](https://agent-utilities.agent-utilities.workers.dev/downloads/seo-change-example.sha256) and [machine-readable manifest](https://agent-utilities.agent-utilities.workers.dev/downloads/seo-change-example-manifest.json)\n\nThis is entirely fictional: HTML, HTTP statuses, dates and coverage are invented. No site was fetched and no customer use is represented. Run with Node.js 22+:\n\n```sh\nshasum -a 256 -c agent-utilities-seo.mjs.sha256\nshasum -a 256 -c seo-change-example.sha256\nnode agent-utilities-seo.mjs changes seo-change-example-before.json seo-change-example-after.json --out my-seo-changes.json\ncmp my-seo-changes.json seo-change-example-result.json\n```\n\nThe result newly observes `noindex` on the home page. The missing-title finding is not observed later. The contact page goes from a supplied 404 observation to a failed 503 observation, so its metadata remains unknown. Neither missing findings nor failed reads prove resolution. Two of three invented discovered URLs are supplied in each capture. The command retains both dates and coverage without raw HTML, makes no network/model request, and creates a private output while preserving existing files. `cmp` prints nothing when the complete result matches. Use a new output name when rerunning.\n\n### Run a supplied snapshot audit\n\nFree HTTP: POST `https://agent-utilities.agent-utilities.workers.dev/v1/seo/audit` with `Content-Type: application/json` and this input shape. This tiny example is synthetic; replace it with your actual snapshot:\n\n```json\n{\"siteUrl\":\"https://example.com/\",\"pages\":[{\"url\":\"https://example.com/\",\"status\":200,\"html\":\"Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text
Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text
Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text
Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text
Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text
Timeout: 30 seconds.
Timeout: 30 seconds.
Your public text