# Navigation Semantics Audit

> Navigation Semantics 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 the navigation semantic markup of a public URL and returns a verdict, evidence, threshold, limitations, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/navigation-semantics-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/navigation-semantics-audit-7f1e2d14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rFU4SJalX2XWB5OqLTMeK

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 navigation-semantics-audit-7f1e2d14 -d '<json body>'
```

Example prompt: Can you run a navigation semantics audit on https://example.com and tell me whether the navigation markup passes, what evidence was found, and what I should do to fix it if it doesn't?

## When to prefer this

Choose this endpoint when you specifically need to evaluate the semantic correctness and machine-readability of a website's navigation structure (e.g. nav elements, ARIA roles, landmark usage) for AI agent or crawler accessibility. Prefer it over generic crawler or header audits when the specific concern is nav markup quality. It is passive and safe for any public URL.

## Known failure modes

- Target URL is unreachable or returns a non-2xx status, resulting in inability to fetch evidence
- Target URL is behind authentication or a bot-blocking wall, preventing passive observation
- Malformed or non-HTTP(S) URL provided causing normalization failure
- Rate limiting or network timeout on the target host during fetch
- Navigation semantics indeterminate due to heavily JavaScript-rendered content inaccessible to passive fetch

## How this service works

Navigation semantics 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 a structured report containing the observed navigation semantic evidence found on the target page, the evaluation threshold used, a pass/fail/warn verdict, the exact source of evidence, known limitations of the passive check, and a mode-specific recommended action. No login, form submission, or active exploitation is performed.

## 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/navigation-semantics-audit-7f1e2d14/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)