# HowTo Entity Audit

> HowTo Entity Audit is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively audits a public URL or domain to evaluate whether it properly exposes HowTo structured-data entities, returning observations, verdict, evidence source, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/howto-entity-audit?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/howto-entity-audit-206fedbf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HJZMdxQUTDnRZ9mo5rGkK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability howto-entity-audit-206fedbf -d '<json body>'
```

Example prompt: Can you audit https://www.example.com/how-to-make-pasta to check whether it has valid HowTo structured-data entities and tell me the verdict, evidence source, and what action I should take?

## When to prefer this

Choose this endpoint when you need a passive, read-only audit of HowTo structured-data entities on a specific public URL or domain — especially for agent readiness assessments, SEO compliance checks, or pre-publish validation of tutorial and step-by-step guide pages. Prefer it over generic SEO crawlers when you specifically need a verdict on schema.org HowTo entity presence and quality.

## Known failure modes

- Target URL is unreachable or returns a non-200 status, resulting in no evidence being collected
- Target blocks crawlers via robots.txt or firewall, limiting observable evidence
- Malformed or non-public URLs return a validation error
- No HowTo structured data found results in a fail verdict with empty evidence source
- Rate limiting or transient network errors may cause incomplete audits

## How this service works

HowTo entity audit fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns an observation describing what HowTo entity evidence was found, the threshold being evaluated, a pass/fail verdict, the exact evidence source URL or element, known limitations of the passive check, and a mode-specific recommended action — all without performing any login, form submission, payload injection, or load test.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/howto-entity-audit-206fedbf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)