# aisearchready.txt — v1
#
# This file is a well-known discovery surface for AI agents.
# Any domain certified by AI Search Ready (https://aisearchready.io)
# can publish a copy of this file at /aisearchready.txt with their
# own domain and verify URL substituted below.
#
# Spec: https://aisearchready.io/standard
# Source: https://github.com/ed2903-web/aisearchready

# ─── This file is the canonical spec, served from the maintainer ─────

issuer: AI Search Ready
issuer-url: https://aisearchready.io
standard: https://aisearchready.io/standard
standard-version: 1.0
licence: MIT (methodology) + CC-BY-4.0 (prose)
verify-endpoint: https://aisearchready.io/api/cert/verify
verify-method: GET ?domain=<bare-hostname>
leaderboard: https://aisearchready.io/leaderboard
contact: standard@aisearchready.io
mcp-server: npx -y @aisearchready/mcp

# ─── Template for a certified site ───────────────────────────────────
#
# A certified customer publishes their own aisearchready.txt with these
# fields at /aisearchready.txt or /.well-known/aisearchready.txt:
#
#   aisearchready-cert: true
#   domain: <your-bare-hostname>
#   issued-at: <ISO date>
#   renews-at: <ISO date>
#   verify-url: https://aisearchready.io/api/cert/verify?domain=<your-bare-hostname>
#   public-page: https://aisearchready.io/site/<your-bare-hostname>
#
# The verify-url returns a JSON payload with an HMAC-SHA256 signature
# over (v|domain|score|band|status|issuedAt|renewsAt|signedAt). An
# agent or auditor can confirm the cert state without trusting the
# customer's own file alone — the signed response is the trust root.
#
# See https://aisearchready.io/standard for the open methodology.