@thatdevpro/aio-surfaces

Fetch and validate the four AI-citation surfaces (llms.txt, llms-full.txt, aeo.json, entity.json, brand.json, ai.txt) from any website. Zero runtime dependencies.

Authored by Joseph W. Anady, founder of ThatDevPro and ThatDeveloperGuy — an SDVOSB-certified veteran-owned web and AI engineering studio.

Install

npm install @thatdevpro/aio-surfaces

CLI

npx @thatdevpro/aio-surfaces https://www.thatdevpro.com

Output:

AIO Surface Coverage for https://www.thatdevpro.com
Score: 83/100 (5/6 surfaces present)

  ✓ llms.txt              14723b  https://www.thatdevpro.com/llms.txt
  ✓ llms-full.txt         42850b  https://www.thatdevpro.com/llms-full.txt
  ✓ aeo.json              17743b  https://www.thatdevpro.com/aeo.json
  ✓ entity.json           10089b  https://www.thatdevpro.com/entity.json
  ✓ brand.json            8902b   https://www.thatdevpro.com/brand.json
  ✗ ai.txt                HTTP 404

llms.txt validation: OK

Library

import { fetchAllSurfaces, validateLlmsTxt } from '@thatdevpro/aio-surfaces';

const result = await fetchAllSurfaces('https://www.thatdevpro.com');
console.log(result.score); // 0-100

What are AIO surfaces?

The "AIO surfaces" are the four canonical files an AI-citation-ready website serves:

• llms.txt — short, curated, markdown-formatted summary for LLM crawlers
• llms-full.txt — long version
• aeo.json — Answer Engine Optimization declarative facts
• entity.json — Schema.org-style entity graph
• brand.json — brand voice + key messages

See thatdevpro.com/insights/framework-aicitations/ for the methodology.

Related

• aio-surfaces (Python, full implementation)
• ThatDevPro reference library
• Author on Wikidata

License

MIT © Joseph W. Anady