Skip to content
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.

  1. 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"}}]}
  2. 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
Score role
Informational
Introduced
2026-10-22
Methodology version
2026-10-22

Checkpoint data (JSON)