{
  "openapi": "3.1.0",
  "info": {
    "title": "OOO Works free tools",
    "version": "1.0.0",
    "description": "Free checks from OOO Works. No key needed. Limits: 10 checks an hour per caller, results cached for 10 minutes. The same checks are available as an MCP server at https://oooworks.com/mcp (tool check_ai_crawler_access).",
    "contact": { "url": "https://oooworks.com/about/" }
  },
  "servers": [ { "url": "https://oooworks.com" } ],
  "paths": {
    "/api/ai-crawler-check": {
      "post": {
        "operationId": "checkAiCrawlerAccess",
        "summary": "Can AI assistants read this page?",
        "description": "Checks robots.txt rules for each AI crawler, what the server returns to each crawler's name compared with a normal browser, and noindex. One summary line per assistant: ok, blocked, or unknown (the site verifies real crawlers by IP, which can't be tested from outside).",
        "requestBody": { "required": true, "content": { "application/json": { "schema": {
          "type": "object", "required": ["url"],
          "properties": { "url": { "type": "string", "description": "Website or page, e.g. example.com", "examples": ["example.com"] } } } } } },
        "responses": {
          "200": { "description": "The check", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Report" } } } },
          "400": { "description": "Not a public website address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } },
          "422": { "description": "The site couldn't be opened", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } },
          "429": { "description": "Too many checks; try later", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": { "type": "object", "properties": { "error": { "type": "string" } } },
      "Line": { "type": "object", "properties": {
        "assistant": { "type": "string" },
        "state": { "type": "string", "enum": ["ok", "blocked", "unknown"] },
        "text": { "type": "string" } } },
      "Bot": { "type": "object", "properties": {
        "token": { "type": "string" }, "assistant": { "type": "string" },
        "purpose": { "type": "string", "enum": ["search", "user", "training"] },
        "robots": { "type": "string" }, "status": { "type": "integer" }, "served": { "type": "string" }, "verdict": { "type": "string" } } },
      "Report": { "type": "object", "properties": {
        "url": { "type": "string" }, "final_url": { "type": "string" }, "checked": { "type": "string", "format": "date-time" },
        "browser_status": { "type": "integer" }, "cdn": { "type": "string" },
        "robots_found": { "type": "boolean" }, "robots_varies": { "type": "boolean" }, "noindex": { "type": "boolean" },
        "summary": { "type": "array", "items": { "$ref": "#/components/schemas/Line" } },
        "bots": { "type": "array", "items": { "$ref": "#/components/schemas/Bot" } },
        "fixes": { "type": "array", "items": { "type": "string" } },
        "notes": { "type": "array", "items": { "type": "string" } } } }
    }
  }
}