{
  "$schema": "https://clawseo.com/agentic-discoverability/schema/manifest.v1.json",
  "name": "ClawSEO",
  "url": "https://clawseo.com/",
  "identity": {
    "primary_entity_id": "entity:clawseo",
    "primary_name": "ClawSEO",
    "primary_type": "SoftwareApplication",
    "website_name": "ClawSEO",
    "product_name": "ClawSEO",
    "deployment_model": "Dedicated OpenClaw SEO operator appliance on its own independent Mac, PC, or VPS",
    "primary_purpose": "Audit public page evidence, test supported deterministic retrieval, analyze imported repeated AI observations, and trace supplied claim provenance.",
    "optimization_goal": "Turn documented gaps into prioritized AI SEO work aimed at making relevant documents easier for agents to locate, understand, verify by source, and select.",
    "business_goal": "Support more relevant organic discovery and traffic. No traffic lift is claimed without measurement.",
    "author_entity_id": "entity:organicrankings",
    "author_name": "@organicrankings",
    "professional_service_performer_entity_id": "entity:organicrankings",
    "legal_owner_entity_id": "entity:ao-design-llc",
    "legal_owner_name": "AO Design LLC",
    "legal_owner_scope": "Legal ownership, terms, privacy, and Stripe charge processing. AO Design LLC is not the front-facing website, product, author, or professional service performer."
  },
  "standard": {
    "name": "Agentic Discoverability",
    "version": "2026-08-10",
    "scope": "Advanced agentic retrieval and evidence selection for a public website, beyond basic SEO files.",
    "primary_question": "Can an agent locate the exact evidence, understand what it means, determine where it came from, and identify what it should investigate next?",
    "definition": "A page should function as a machine-queryable information environment with locatable evidence, explicit fields, stable entities, retrieval-aware structure, provenance, and separated evidence, interpretation, prescription, confidence, and next investigations."
  },
  "interfaces": {
    "human_home": "https://clawseo.com/",
    "human_agentic_discoverability": "https://clawseo.com/agentic-discoverability/",
    "llms_txt": "https://clawseo.com/llms.txt",
    "openapi": "https://clawseo.com/openapi.json",
    "release_metadata": "https://clawseo.com/release.json",
    "agent_manifest": "https://clawseo.com/.well-known/agentic-discoverability.json",
    "agent_manifest_alias": "https://clawseo.com/agentic-discoverability.json",
    "evidence_map": "https://clawseo.com/agentic-discoverability/evidence.json",
    "retrieval_benchmark": "https://clawseo.com/agentic-discoverability/retrieval-benchmark.json",
    "provenance_graph": "https://clawseo.com/agentic-discoverability/provenance.json",
    "compliance_report": "https://clawseo.com/agentic-discoverability/report.json",
    "schemas": {
      "manifest": "https://clawseo.com/agentic-discoverability/schema/manifest.v1.json",
      "evidence_map": "https://clawseo.com/agentic-discoverability/schema/evidence-map.v1.json",
      "retrieval_benchmark": "https://clawseo.com/agentic-discoverability/schema/retrieval-benchmark.v1.json",
      "provenance_graph": "https://clawseo.com/agentic-discoverability/schema/provenance-graph.v1.json",
      "compliance_report": "https://clawseo.com/agentic-discoverability/schema/compliance-report.v1.json"
    }
  },
  "entity_ids": [
    "entity:clawseo",
    "entity:organicrankings",
    "entity:iluvseo",
    "entity:ao-design-llc",
    "entity:openclaw",
    "entity:agentic-search-and-evidence"
  ],
  "capabilities": [
    {
      "id": "capability:locatable-evidence",
      "name": "Locatable evidence",
      "requirement": "Critical claims expose exact routes, heading paths, field names, dates, units, identifiers, and evidence references.",
      "public_evidence": [
        "https://clawseo.com/agentic-discoverability/evidence.json"
      ]
    },
    {
      "id": "capability:retrieval-robustness",
      "name": "Retrieval robustness",
      "requirement": "The site publishes query classes and expected evidence targets for lexical, fielded, and structured hybrid retrieval checks without pretending agentic search has one fixed retrieval mechanism.",
      "public_evidence": [
        "https://clawseo.com/agentic-discoverability/retrieval-benchmark.json"
      ]
    },
    {
      "id": "capability:visibility-distribution",
      "name": "AI visibility as a distribution",
      "requirement": "The site rejects single-run rank claims and defines repeated-observation fields for appearance frequency, citation frequency, selected URLs, citation placement, prompt sensitivity, and uncertainty.",
      "public_evidence": [
        "https://clawseo.com/agentic-discoverability/retrieval-benchmark.json",
        "https://clawseo.com/agentic-discoverability/report.json"
      ]
    },
    {
      "id": "capability:provenance-graph",
      "name": "Provenance graph",
      "requirement": "Claim origins, source families, repeated claims, and independence limits are represented separately from simple source counts.",
      "public_evidence": [
        "https://clawseo.com/agentic-discoverability/provenance.json"
      ]
    },
    {
      "id": "capability:evidence-layer-separation",
      "name": "Evidence layer separation",
      "requirement": "Evidence, interpretation, prescription, assumptions, confidence, and next investigations remain separate fields.",
      "public_evidence": [
        "https://clawseo.com/agentic-discoverability/evidence.json",
        "https://clawseo.com/agentic-discoverability/report.json"
      ]
    }
  ],
  "retrieval_contract": {
    "supported_structures": [
      "precise_heading_hierarchy",
      "self_contained_sections",
      "explicit_field_names",
      "dates_attached_to_claims",
      "units_attached_to_numbers",
      "stable_product_and_entity_ids",
      "well_formed_machine_json",
      "metadata_links",
      "stable_entity_terminology"
    ],
    "retrieval_methods_accounted_for": [
      "bm25",
      "fielded",
      "structured-hybrid"
    ],
    "retrieval_methods_not_claimed": [
      "dense_embedding_retrieval_without_an_external_embedding_index"
    ]
  },
  "visibility_measurement_contract": {
    "rank_claim_policy": "Do not report a single AI answer as a stable rank.",
    "public_field_style": "snake_case",
    "runtime_field_style": "camelCase",
    "canonical_observation_fields": [
      "run_id",
      "observed_at",
      "prompt_id",
      "prompt_variant",
      "model",
      "interface",
      "search_enabled",
      "search_provider",
      "session_id",
      "retrieval_method",
      "market",
      "language",
      "personalization_context",
      "query_rewrite_context",
      "corpus_context",
      "retrieved_urls",
      "brand_appeared",
      "cited",
      "citations"
    ],
    "runtime_field_mapping": {
      "run_id": "runId",
      "observed_at": "observedAt",
      "prompt_id": "promptId",
      "prompt_variant": "promptVariant",
      "search_enabled": "searchEnabled",
      "search_provider": "searchProvider",
      "session_id": "sessionId",
      "retrieval_method": "retrievalMethod",
      "personalization_context": "personalizationContext",
      "query_rewrite_context": "queryRewriteContext",
      "corpus_context": "corpusContext",
      "retrieved_urls": "retrievedUrls",
      "brand_appeared": "brandAppeared"
    },
    "unchanged_runtime_fields": [
      "model",
      "interface",
      "market",
      "language",
      "cited",
      "citations"
    ],
    "recommended_metrics": [
      "appearance_frequency",
      "citation_frequency",
      "selected_url_counts",
      "retrieved_url_counts",
      "median_citation_position",
      "prompt_sensitivity",
      "wilson_confidence_interval"
    ]
  },
  "constraints": [
    "No hidden AI-only claims are exposed that users cannot inspect.",
    "No single-run AI answer is treated as a stable ranking.",
    "No source count is treated as independent confirmation without source-family evidence.",
    "No dense retrieval support is claimed unless an external embedding index is supplied and measured.",
    "No private reports, credentials, prompts, or customer data are included in public discovery files."
  ],
  "last_reviewed": "2026-08-10"
}
