ARD PUBLISH CHECKLIST
Make the catalog actually crawlable.
A valid manifest is only useful when registries can retrieve it. Check the document, endpoint, headers, and public access before asking a discovery service to ingest your resources.
Manifest
- Use
specVersion: "1.0". - Anchor every
urn:air:identifier to a domain you control. - Provide exactly one of
urlordatafor each entry. - Add two to five representative natural-language queries.
- Never include API keys, bearer tokens, or private implementation details.
Endpoint
- Serve
/.well-known/ai-catalog.jsonover HTTPS. - Return
Content-Type: application/json. - Return
Access-Control-Allow-Origin: *for crawler access. - Do not require a login, session cookie, or JavaScript rendering.
- Keep robots.txt and edge security rules from blocking registry crawlers.