Skip to content

piiiico/aeo-audit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

aeo-audit

AI-readiness audit tool for Norwegian (and general) websites. Analyzes schema.org markup, meta tags, content structure, technical factors, and AI visibility signals to generate an AEO (Answer Engine Optimization) score.

Features

  • Schema.org analysis — detects LocalBusiness, FAQPage, AggregateRating, OpeningHoursSpecification, and more
  • Meta tag scoring — title, description, canonical, og:, twitter:
  • Content analysis — heading hierarchy, FAQ content, statistics/citations, speakable markup
  • Technical factors — HTTPS, robots.txt, sitemap, llms.txt, structured data validity
  • AI signals — llms.txt detection, AI-specific meta tags, structured query surfaces
  • Live search visibility — Brave Search API integration to check real AI search presence
  • HTML + Markdown + JSON output formats

Usage

bun run src/cli.ts <url> [--json|--html] [--output <file>] [--company <name>]

# Examples:
bun run src/cli.ts colosseumdental.no
bun run src/cli.ts tannlegene.no --html --output report.html
bun run src/cli.ts example.com --json

Scoring

Grade Score Meaning
A 80-100 Excellent AI visibility
B 60-79 Good — minor gaps
C 40-59 Average — significant gaps
D 20-39 Poor — major gaps
F 0-19 Invisible to AI engines

Stack

  • Bun runtime
  • TypeScript
  • Zero external runtime dependencies (node-html-parser for dev only)

About

AI-readiness audit tool for websites — checks schema.org, meta tags, content structure, and generates AEO scores

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors