AIA Matrix

Semantic Knowledge Graph

The Semantic Knowledge Graph is a structured JSON layer — typically hosted at /semantic/ — that represents your website's content, identity, and offerings in a format built for machine consumption rather than human reading.

What It Is

Where your regular website is built for human visitors (navigation, visual design, marketing copy), the Semantic Knowledge Graph is built for AI agents, crawlers, and structured-data consumers that need precise, unambiguous facts without parsing HTML or prose.

https://yourdomain.com/semantic/
├── index.json
├── site_metadata.json
├── home.json
├── about.json
├── services.json
├── projects.json
├── contact.json
├── testimonials.json
└── (subdirectories)
    ├── services/
    ├── projects/
    ├── blog/
    ├── schema/
    └── faq/

Why It Matters for Your AIA Score

A well-formed Semantic Knowledge Graph directly strengthens two parts of your AIA Score:

  • Explicitness Index (E) — structured JSON is the clearest possible machine-readable signal, maximizing your Schema Score
  • Accessibility Index (A) — per the AIA scoring methodology, a valid structured JSON endpoint dedicated to AI retrieval can raise your Accessibility Index to its maximum (A = 100), even on sites that are otherwise heavily JavaScript-rendered or technically difficult to crawl

This makes the Semantic Knowledge Graph one of the highest-leverage things you can add to a site, particularly if your main site has known accessibility challenges.

The Index File

/semantic/index.json is the entry point — it tells any AI system or crawler what else is available in the directory:

{
  "title": "Your Company Semantic Knowledge Graph",
  "description": "Public AI-readable directory.",
  "base_url": "https://yourdomain.com/semantic/",
  "core_files": [
    "site_metadata.json",
    "home.json",
    "about.json",
    "services.json",
    "projects.json",
    "contact.json",
    "testimonials.json"
  ],
  "directories": [
    "services/",
    "projects/",
    "blog/",
    "faq/",
    "schema/"
  ],
  "recommended_use": "AI systems, search engines, crawlers, and developers may use these files to understand this organization's services, expertise, projects, and semantic structure.",
  "ai_summary": "Index file for the semantic directory."
}

Core File Reference

FileContents
site_metadata.jsonCompany name, identity, brand metadata
home.jsonHomepage summary and primary value proposition
about.jsonCompany story, mission, team
services.jsonStructured list of services or products offered
projects.jsonPortfolio, case studies, or featured work
contact.jsonAddress, phone, email, hours, service areas
testimonials.jsonClient reviews and social proof

Each file should use plain, unambiguous keys and values — avoid marketing language in favor of factual statements an AI system can extract directly.

Subdirectories

For sites with more content depth, organize detail files into subdirectories that mirror your site structure:

  • services/ — one file per individual service
  • projects/ — one file per case study or portfolio item
  • blog/ — post metadata and summaries
  • faq/ — structured question/answer pairs
  • schema/ — raw Schema.org structured data definitions referenced elsewhere on the site

Where to Place It

The entire /semantic/ directory lives at your site root:

https://yourdomain.com/semantic/index.json

See Installation for upload instructions, and Troubleshooting if you encounter a 403 error when visiting the folder directly.

How AIA Matrix Generates This

AIA Matrix builds your Semantic Knowledge Graph automatically based on what it detects during a scan — pulling structured facts from your actual page content rather than relying on a fixed template. On the Professional plan, this expands to cover every page AIA Matrix detects on your domain, with monthly re-scans keeping the data current as your site changes.

Related