# Asir Radar: access for AI agents

https://asir.info/agents is a no-JavaScript HTML directory for AI web-reading
tools. https://asir.info/agents.md is this lightweight plain-text guide.

## Two supported access modes

1. If your tool supports raw HTTPS JSON GET: read
   https://asir.info/v1/ai/freshness to check current publication,
   https://asir.info/v1/places for place IDs, and
   https://asir.info/v1/ai/quickstart for the route directory.
   The complete schema is https://asir.info/openapi.json.
   For a narrow question use /v1/ai/discovery?place=asir&surface=jobs&limit_per_surface=5.
2. If the web-reading tool cannot open application/json or long API URLs,
   DO NOT conclude the site is down. Open https://asir.info/agents
   and follow links to server-rendered HTML pages such as
   https://asir.info/jobs, https://asir.info/tourism,
   https://asir.info/projects and https://asir.info/changes.
   These pages are usable without JavaScript or authentication.

## Safe usage

Always identify the specific URL, HTTP status, and retrieval-tool error when
reporting a failure. A web tool's unsupported_content_type, url_not_allowed,
or url_not_in_prior_context is NOT equivalent to HTTP 404/503 from Asir Radar.
Do not infer full market absence from a partial, stale, unavailable or
restricted source. Preserve Asir Radar's canonical citation URL, source
provenance, publication date and coverage state where available.
Do not claim live inventory, prices, jobs or weather without fetching
the corresponding current data and checking freshness.

## Discovery resources

Agent directory: https://asir.info/agents
Current freshness: https://asir.info/v1/ai/freshness
Place catalog: https://asir.info/v1/places
Abha context: https://asir.info/v1/discovery/abha
Asir context: https://asir.info/v1/discovery/asir
Coverage: https://asir.info/v1/source-health
API schema: https://asir.info/openapi.json
Provider manifest: https://asir.info/.well-known/asir-radar.json
Human API docs: https://asir.info/docs
Arabic agent guide: https://asir.info/llms-ar.txt