@ainyc/aeo-audit

A public audit engine for the technical side of Answer Engine Optimization.

A public CLI and JavaScript library that audits 13 factors we believe correlate with AI citation readiness. AEO is an emerging field, and this tool represents our best working model, not a guaranteed formula.

Documentation

  • README with CLI and API examples
  • Public changelog and roadmap
  • Contribution guide for collaborators

CLI

npx @ainyc/aeo-audit https://example.com
npx @ainyc/aeo-audit https://example.com --format json

JavaScript API

import { runAeoAudit } from '@ainyc/aeo-audit'
const report = await runAeoAudit('https://example.com', { includeGeo: false })

Structured Data (JSON-LD)

12%

Presence of LocalBusiness, FAQPage, Service, and HowTo schemas.

Content Depth

10%

Word count, heading hierarchy, paragraph structure, and list usage.

AI-Readable Content

10%

llms.txt, llms-full.txt, robots.txt, and sitemap.xml availability.

E-E-A-T Signals

8%

Author meta, trust pages, credentials, and review-oriented trust signals.

FAQ Content

8%

FAQPage schema, question headings, and direct-answer formatting.

Citations & Authority

8%

External references, authoritative links, and sameAs-style corroboration.

Schema Completeness

8%

Property depth and richness across the structured data stack.

Entity Consistency

7%

Naming consistency across schema, title tags, and on-page identity.

Content Freshness

7%

dateModified, Last-Modified, sitemap dates, and current copyright signals.

Content Extractability

6%

How easy the content is for answer engines to parse and cite.

Definition Blocks

6%

Direct definitions, step lists, and HowTo-style explanation blocks.

Named Entities

6%

Brand mentions, founder references, and proper-noun density.

AI Crawler Access

4%

robots.txt rules for GPTBot, ClaudeBot, PerplexityBot, and peers.

npm

Install and run the package through npx or your own Node workflow.

Open npm package

Planned improvements on the roadmap — these are directions we're exploring, not shipped features.

  • npm release and CI integration for broader developer adoption
  • site audit and baseline diff workflows
  • policy-pack checks for engine-specific crawler rules
  • trend tracking and export formats for recurring monitoring

We Open-Sourced Our AEO Audit Engine

Why AI NYC published @ainyc/aeo-audit, what the 13-factor model measures, and what teams can learn from it.

Read the article

Try the audit, then let us handle the rest.

Use the open-source package to see how your site scores, then work with AI NYC to turn those insights into a full optimization strategy.