Agent Ready

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Natural-language question to search Agent Ready's docs, scoring methodology, check registry, and content library (explainers, comparisons, how-to guides, glossary)."
    },
    "mode": {
      "enum": [
        "list",
        "summarize"
      ],
      "type": "string",
      "description": "\"list\" (default) returns matching items; \"summarize\" returns a synthesized answer."
    },
    "itemType": {
      "enum": [
        "methodology",
        "checks",
        "specs",
        "llms-txt",
        "check",
        "page",
        "any"
      ],
      "type": "string",
      "description": "Restrict results to a content type: methodology, checks, specs, llms-txt, check, page (explainers/guides/glossary), or any (default: all types)."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The scan id returned by scan_site (also the share token in a /scan/<id> URL)."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "Full URL of the site to scan, e.g. https://example.com. Must be a public http(s) address."
    },
    "pageLimit": {
      "type": "integer",
      "maximum": 2000,
      "minimum": 1,
      "description": "Maximum number of pages to crawl. Defaults to your tier's per-scan page limit when omitted."
    }
  }
}