Agent Ready API Catalog

Sub-skill de agent-ready-cloudflare: Implement API Catalog

fabricioctelles 46b3b2a 836 B Updated

File contents

Implement API Catalog

Publish an API catalog for automated discovery per RFC 9727.

Requirements

  • Serve /.well-known/api-catalog with Content-Type: application/linkset+json and HTTP 200
  • Include a linkset array with entries for each API
  • Each entry needs an anchor URL and link relations: service-desc (OpenAPI spec), service-doc (docs), and optionally status (health endpoint)
  • See RFC 9727 Appendix A for examples

Validate

POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}

Check that checks.discovery.apiCatalog.status is "pass".

fabricioctelles/skills/tree/main/skills/agent-ready-cloudflare/api-catalog commit 46b3b2a43b

Frequently asked questions

npx skillmds@latest add fabricioctelles/agent-ready-api-catalog