{
  "openapi": "3.1.0",
  "info": {
    "title": "ClawSEO Agentic Discoverability Read API",
    "version": "v2.10.0",
    "description": "ClawSEO is an AI SEO operator for Agentic Discoverability. These read-only public endpoints expose product evidence, supported deterministic retrieval contracts, supplied-source provenance, release metadata, and guidance for locating and verifying relevant documents."
  },
  "servers": [
    {
      "url": "https://clawseo.com"
    }
  ],
  "paths": {
    "/.well-known/agentic-discoverability.json": {
      "get": {
        "operationId": "getAgenticDiscoverabilityManifest",
        "summary": "Get the canonical Agentic Discoverability manifest.",
        "responses": {
          "200": {
            "description": "Agentic Discoverability manifest.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgenticManifest"
                }
              }
            }
          }
        }
      }
    },
    "/agentic-discoverability.json": {
      "get": {
        "operationId": "getAgenticDiscoverabilityManifestAlias",
        "summary": "Get the root-level alias of the Agentic Discoverability manifest.",
        "responses": {
          "200": {
            "description": "Agentic Discoverability manifest alias.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgenticManifest"
                }
              }
            }
          }
        }
      }
    },
    "/agentic-discoverability/evidence.json": {
      "get": {
        "operationId": "getAgenticEvidenceMap",
        "summary": "Get structured claims, locators, entities, evidence, interpretation, prescription, confidence, and next investigations.",
        "responses": {
          "200": {
            "description": "Machine-queryable evidence map.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvidenceMap"
                }
              }
            }
          }
        }
      }
    },
    "/agentic-discoverability/retrieval-benchmark.json": {
      "get": {
        "operationId": "getAgenticRetrievalBenchmark",
        "summary": "Get query classes, target claims, expected URLs, and visibility-distribution measurement contract.",
        "responses": {
          "200": {
            "description": "Retrieval benchmark and measurement contract.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RetrievalBenchmark"
                }
              }
            }
          }
        }
      }
    },
    "/agentic-discoverability/provenance.json": {
      "get": {
        "operationId": "getAgenticProvenanceGraph",
        "summary": "Get source families, provenance relationships, and independence policy.",
        "responses": {
          "200": {
            "description": "Provenance graph.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProvenanceGraph"
                }
              }
            }
          }
        }
      }
    },
    "/agentic-discoverability/report.json": {
      "get": {
        "operationId": "getAgenticComplianceReport",
        "summary": "Get the Agentic Discoverability compliance report.",
        "responses": {
          "200": {
            "description": "Compliance report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ComplianceReport"
                }
              }
            }
          }
        }
      }
    },
    "/release.json": {
      "get": {
        "operationId": "getReleaseMetadata",
        "summary": "Get current ClawSEO release metadata.",
        "responses": {
          "200": {
            "description": "Release metadata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsSourceMap",
        "summary": "Get the plain-text AI retrieval source map.",
        "responses": {
          "200": {
            "description": "Plain-text LLM source map.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/version.txt": {
      "get": {
        "operationId": "getCurrentVersion",
        "summary": "Get the current public ClawSEO version.",
        "responses": {
          "200": {
            "description": "Current version string.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "pattern": "^v[0-9]+\\.[0-9]+\\.[0-9]+$"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AgenticManifest": {
        "type": "object",
        "required": [
          "name",
          "standard",
          "interfaces",
          "capabilities",
          "constraints"
        ]
      },
      "EvidenceMap": {
        "type": "object",
        "required": [
          "schema_version",
          "entities",
          "claims"
        ]
      },
      "RetrievalBenchmark": {
        "type": "object",
        "required": [
          "retrieval_methods",
          "query_classes",
          "visibility_measurement_contract"
        ]
      },
      "ProvenanceGraph": {
        "type": "object",
        "required": [
          "nodes",
          "relationships",
          "independence_policy"
        ]
      },
      "ComplianceReport": {
        "type": "object",
        "required": [
          "standard",
          "overall_status",
          "checks",
          "non_claims"
        ]
      }
    }
  }
}