Methodology
NLWeb ask endpoint
ia.nlweb-ask · 4.26
Act
MAY
Recommendation
AR-ACT-09
Why it matters
NLWeb lets an agent ask a site a question and get schema.org results back. A working /ask endpoint gives agents a direct answer path instead of a crawl. The check is informational and gives no points.
How to fix it
Serve NLWeb at /ask with schema.org results.
-
Answer GET /ask?query=... with JSON that has a results array.
{"query_id": "q1", "results": [{"url": "https://example.com/shoe", "name": "Trail shoe", "schema_object": {"@type": "Product", "name": "Trail shoe"}}]} -
Give each result a schema.org object, and support streaming=false for a plain JSON answer.
Verify
curl -s 'https://{domain}/ask?query=what+does+this+site+offer&streaming=false' | jq -e '.results | length > 0'
Expected: exit code 0
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.nlweb-ask
Details Mapping, lifecycle and references
- AR mapping
- Full match
- Evidence source
- agentready.org AR-ACT-09
- Score role
- Informational
- Introduced
- 2026-10-22
- Methodology version
- 2026-10-22