{"id":"ia.nlweb-ask","name":"NLWeb ask endpoint","verify":{"command":"curl -s 'https://{domain}/ask?query=what+does+this+site+offer&streaming=false' | jq -e '.results | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.nlweb-ask","expect":"exit code 0"},"fix":{"steps":[{"action":"Answer GET /ask?query=... with JSON that has a results array.","order":1,"language":"json","code_example":"{\"query_id\": \"q1\", \"results\": [{\"url\": \"https://example.com/shoe\", \"name\": \"Trail shoe\", \"schema_object\": {\"@type\": \"Product\", \"name\": \"Trail shoe\"}}]}"},{"action":"Give each result a schema.org object, and support streaming=false for a plain JSON answer.","order":2,"language":null,"code_example":null}],"summary":"Serve NLWeb at /ask with schema.org results.","skill":{"name":"agent-protocols","anchor":"ia.nlweb-ask"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"NLWeb","kind":"spec","url":"https://github.com/nlweb-ai/NLWeb"},{"title":"agentready.org AR-ACT-09","kind":"guide","url":"https://www.agentready.org/#act"}],"expected":"GET /ask?query=... returns JSON with a results array of schema.org objects","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-09","url":"https://www.agentready.org/#act"},"why":"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.","profiles":["ai_search_visibility","api_tool_readiness"],"score_role":"informational","legacy_id":"4.26","i18n":{"nl":{"name":"NLWeb ask-endpoint","steps":["Beantwoord GET /ask?query=... met JSON met een results-array.","Geef elk resultaat een schema.org-object, en ondersteun streaming=false voor een gewoon JSON-antwoord."],"why":"Met NLWeb kan een agent een site een vraag stellen en schema.org-resultaten terugkrijgen. Een werkend /ask-endpoint geeft agents een direct antwoordpad in plaats van een crawl. De check is informatief en geeft geen punten.","fix_summary":"Lever NLWeb op /ask met schema.org-resultaten.","verify_expect":"exitcode 0"}},"ar_practice_ids":["AR-ACT-09"],"strength":"MAY","ar_mapping":"full","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.nlweb-ask","maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}