{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentwebmap-com/json-schema/agentwebmap-com-domain-schema.json",
  "title": "Domain",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentwebmap-com-openapi.json#/components/schemas/Domain",
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "valid",
        "invalid",
        "unreachable"
      ]
    },
    "tier": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "featured",
        "listed",
        "unlisted",
        "rejected",
        null
      ]
    },
    "authority": {
      "type": [
        "integer",
        "null"
      ]
    },
    "verified": {
      "type": "boolean"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "llms_txt": {
      "type": [
        "string",
        "null"
      ]
    },
    "llms_full_txt": {
      "type": [
        "string",
        "null"
      ]
    },
    "last_checked": {
      "type": [
        "string",
        "null"
      ]
    },
    "agent_terms": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "automated_access": {
              "type": "string",
              "enum": [
                "welcome",
                "limited",
                "ask",
                "not_allowed"
              ]
            },
            "rate_limit": {
              "type": "string",
              "maxLength": 100
            },
            "attribution": {
              "type": "string",
              "enum": [
                "required",
                "appreciated",
                "none"
              ]
            },
            "attribution_text": {
              "type": "string",
              "maxLength": 200
            },
            "pricing": {
              "type": "string",
              "enum": [
                "free",
                "freemium",
                "paid"
              ]
            },
            "pricing_url": {
              "type": "string"
            },
            "terms_url": {
              "type": "string"
            },
            "notes": {
              "type": "string",
              "maxLength": 500
            }
          },
          "required": [],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ai-ml",
          "developer-tools",
          "infrastructure",
          "data-analytics",
          "cybersecurity",
          "finance-payments",
          "ecommerce",
          "productivity",
          "marketing",
          "education",
          "healthcare",
          "media",
          "design",
          "gaming",
          "travel",
          "community",
          "legal",
          "recruiting-careers",
          "industrial-manufacturing",
          "real-estate",
          "arts-culture",
          "sports-fitness",
          "food-dining",
          "automotive",
          "government-public-services",
          "science-research",
          "ai-agents-mcp",
          "apis-sdks",
          "databases",
          "auth-identity",
          "devops-observability",
          "no-code-automation",
          "communications",
          "crypto-web3",
          "saas-business-software",
          "open-source",
          "documentation-reference",
          "fashion-beauty",
          "home-garden",
          "consumer-electronics",
          "pets",
          "insurance",
          "telecom",
          "logistics-shipping",
          "energy-utilities",
          "construction-architecture",
          "agriculture",
          "nonprofit",
          "events",
          "personal-blog",
          "entertainment",
          "local-business"
        ]
      },
      "maxItems": 8,
      "uniqueItems": true,
      "description": "Inferred topic IDs from publisher metadata; empty means unclassified."
    },
    "inferred_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Topic tags inferred by the AI classifier from the site text."
    },
    "audience": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "developers",
            "consumers",
            "business",
            "mixed"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "agent_uses": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "read_docs",
          "call_api",
          "buy",
          "book",
          "search_content",
          "download_data",
          "contact_support"
        ]
      },
      "uniqueItems": true
    },
    "language": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Published or declared address country preferred; domain/hosting fallback. Null when unknown. Not independently verified headquarters or markets served."
    },
    "country_source": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "owner",
        "structured_data",
        "contact_page",
        "tld",
        "ip",
        "cdn",
        null
      ],
      "description": "owner: owner-declared address; structured_data/contact_page: site-published address; tld: domain inference; ip: non-CDN hosting inference; cdn: location withheld. No source independently verifies headquarters."
    },
    "publisher_country": {
      "type": [
        "string",
        "null"
      ]
    },
    "publisher_country_source": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "owner",
        "structured_data",
        "contact_page",
        null
      ]
    },
    "hosting_country": {
      "type": [
        "string",
        "null"
      ]
    },
    "platform_generated": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "agent_summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "llms_txt_cached": {
      "type": "string"
    },
    "agentic": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "interface",
            "transactional",
            "documentation",
            "informational"
          ],
          "description": "What an agent can do with the site: interface (API or MCP endpoint to call), transactional (buy or book), documentation (docs to read), informational (for people)."
        },
        {
          "type": "null"
        }
      ]
    },
    "section_keys": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "section_partial": {
      "type": "boolean"
    },
    "section_indexed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "mcp"
        ]
      },
      "uniqueItems": true,
      "description": "Publisher-declared capabilities. An MCP declaration does not prove availability or protocol compatibility."
    },
    "section_headings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "level": {
            "type": "integer"
          },
          "path": {
            "type": "string"
          },
          "line": {
            "type": [
              "integer",
              "null"
            ]
          },
          "format": {
            "enum": [
              "markdown",
              "loose",
              "setext",
              "indexed_link"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "key",
          "label",
          "level",
          "path",
          "line",
          "format"
        ],
        "additionalProperties": false
      }
    },
    "verified_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "nested_llms_txt": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "contact": {
      "type": [
        "string",
        "null"
      ]
    },
    "sections": {
      "type": [
        "integer",
        "null"
      ]
    },
    "links": {
      "type": [
        "integer",
        "null"
      ]
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ]
    },
    "registered_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ]
    },
    "badge": {
      "type": "string"
    },
    "claim": {
      "type": "object",
      "properties": {
        "agent_prompt": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        },
        "verification": {
          "type": "string"
        },
        "verify": {
          "type": "string"
        },
        "docs": {
          "type": "string"
        },
        "mcp": {
          "type": "string"
        },
        "benefits": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "agent_prompt",
        "hint",
        "verification",
        "verify",
        "docs",
        "mcp",
        "benefits"
      ],
      "additionalProperties": false
    },
    "domain_country": {
      "type": [
        "string",
        "null"
      ]
    },
    "country_checked_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "country_status": {
      "type": "string"
    },
    "country_evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "checked_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "method": {
            "type": "string"
          }
        },
        "required": [
          "country",
          "source",
          "url",
          "checked_at",
          "method"
        ],
        "additionalProperties": false
      }
    },
    "why": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "match_score": {
      "type": "number"
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "excerpt": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": true
      }
    },
    "category_evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "ai-ml",
              "developer-tools",
              "infrastructure",
              "data-analytics",
              "cybersecurity",
              "finance-payments",
              "ecommerce",
              "productivity",
              "marketing",
              "education",
              "healthcare",
              "media",
              "design",
              "gaming",
              "travel",
              "community",
              "legal",
              "recruiting-careers",
              "industrial-manufacturing",
              "real-estate",
              "arts-culture",
              "sports-fitness",
              "food-dining",
              "automotive",
              "government-public-services",
              "science-research",
              "ai-agents-mcp",
              "apis-sdks",
              "databases",
              "auth-identity",
              "devops-observability",
              "no-code-automation",
              "communications",
              "crypto-web3",
              "saas-business-software",
              "open-source",
              "documentation-reference",
              "fashion-beauty",
              "home-garden",
              "consumer-electronics",
              "pets",
              "insurance",
              "telecom",
              "logistics-shipping",
              "energy-utilities",
              "construction-architecture",
              "agriculture",
              "nonprofit",
              "events",
              "personal-blog",
              "entertainment",
              "local-business"
            ]
          },
          "confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Deterministic rule strength, not a calibrated probability."
          },
          "evidence": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "source": {
            "enum": [
              "publisher_metadata",
              "llm"
            ]
          }
        },
        "required": [
          "id",
          "confidence",
          "evidence",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "category_version": {
      "type": [
        "string",
        "null"
      ]
    },
    "categorized_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "capability_evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "const": "mcp"
          },
          "url": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          },
          "status": {
            "const": "publisher_declared"
          }
        },
        "required": [
          "id",
          "url",
          "source_url",
          "status"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "domain",
    "status",
    "tier",
    "authority",
    "verified",
    "title",
    "summary",
    "llms_txt",
    "llms_full_txt",
    "last_checked",
    "agent_terms",
    "categories",
    "capabilities"
  ],
  "additionalProperties": false
}