AEO / GEO Readiness Auditor (Apify Actor)

Audit any public web page for how ready it is to be cited by AI answer engines (ChatGPT, Google AI Overviews, Perplexity) and by classic search — then get a 0–100 score, a letter grade, and concrete fixes. HTML-only (no headless browser), so it is fast and cheap to run.

What it checks (14 signals)

Structured data (JSON-LD) · answer-up-front · title · meta description · canonical · Open Graph · Twitter card · single H1 · heading structure · substantive content (word count) · freshness/date · author / E-E-A-T · declared language · image alt coverage. Plus a noindex block warning.

Input

{
  "startUrls": [{ "url": "https://example.com/blog/post" }],
  "maxConcurrency": 5,
  "maxPages": 1000
}

Output (one dataset item per URL)

{
  "url": "https://example.com/blog/post",
  "readiness_score": 86,
  "grade": "A",
  "blocked_from_indexing": false,
  "schema_types": ["Article"],
  "word_count": 612,
  "title": "...",
  "meta_description": "...",
  "checks": { "jsonLd": { "pass": true, "detail": "schema: Article" }, "...": {} },
  "recommendations": ["Lead with a direct, quotable answer ..."],
  "audited_at": "2026-05-29T..."
}

Why it's useful (and money-first)

Every site owner in 2026 wants to know "will AI tools cite my page?" — there is no clean, cheap answer for that. This gives a per-page score + a fix list. It is also dual-use: the system runs it on its own (and clients') sites for the GEO/AEO citation service.

Run locally / test (no Apify account needed)

npm install
npm test          # unit tests on the pure audit logic (node:test)

Publish to Apify (the account-holder's step)

The free Apify account covers building + publishing free actors (no KYC, no payment). Monetization (pay-per-result pricing + payout) requires the adult account-holder's KYC and is a later step.

npm install -g apify-cli
apify login            # in the free Apify account
apify push             # from this directory — uploads + builds the actor

Then, in the Apify Console: set the actor to Public, write the store listing (use this README), and keep it free initially to learn the discovery algorithm and earn reviews. Only enable pricing later, via the adult account-holder, once the actor shows real repeat organic usage and clears a margin gate (profit = 0.8·revenue − compute).

Notes / safety

• Only audits pages the user supplies; respects maxPages. Read-only, no PII, no logins.
• Honors robots/site access via Crawlee defaults. Don't point it at sites that forbid automated access in their ToS.
• Core logic is in src/audit.js (pure, unit-tested); src/main.js is the Apify wrapper.