angeo / module-aeo-audit

angeo/module-aeo-audit

Magento 2 AEO (AI Engine Optimization) Audit. v3 covers 15 signals — robots.txt AI bots, llms.txt + llms.jsonl, Product / Organization / FAQ schema, merchant return + shipping policies, sitemap.xml, UCP profile, AI product feed, OG tags, canonical + hreflang, JSON-LD quality, well-known endpoint matrix, Core Web Vitals via CrUX. Score Trend dashboard, Admin UI, cron, dynamic fix commands, dependency-injected extension point for custom checkers.

magento2-module 2.4.6-2.4.9 Compatible Based on composer requirements only QA: failed MIT
Viewing version 1.0.0. Latest version is 3.0.0. Switch to latest

Angeo AEO Audit — AI Engine Optimization Auditor for Magento 2

Packagist Version
License
PHP

One CLI command that tells you exactly why ChatGPT, Gemini, and Perplexity aren't recommending your store — and how to fix it.


🚀 Overview

angeo/module-aeo-audit is a Magento 2 CLI tool that audits your store's AEO (AI Engine Optimization) readiness. It checks all the signals that AI search engines use to discover, index, and cite your store in conversational results.

Run the audit, get a scored report, fix the issues — then watch your store appear in ChatGPT Shopping, Google AI Overviews, and Gemini answers.


✅ What It Checks

Check Why It Matters
robots.txt — AI bot access GPTBot, ClaudeBot, PerplexityBot, anthropic-ai, Google-Extended
llms.txt — AI content map The new standard for guiding LLMs to your best content
sitemap.xml AI crawlers rely on sitemaps for complete discovery
Product JSON-LD schema ChatGPT & Gemini extract product data from structured markup
FAQPage schema Increases AI citation probability for answer-style queries
AI Product Feed Required for ChatGPT Shopping and Gemini product cards
Open Graph tags AI engines use og:description as content fallback
Canonical tags Prevents AI indexing of duplicate Magento URLs

📦 Installation

composer require angeo/module-aeo-audit
bin/magento setup:upgrade
bin/magento cache:flush

🔍 Usage

Basic audit (all stores)

bin/magento angeo:aeo:audit

Audit a specific store

bin/magento angeo:aeo:audit --store=en_us

JSON output (for dashboards / CI)

bin/magento angeo:aeo:audit --format=json

Markdown report saved to file

bin/magento angeo:aeo:audit --format=markdown --output=/var/www/html/aeo-report.md

CI pipeline — fail build if score below 70%

bin/magento angeo:aeo:audit --fail-on=70

📊 Example Output

  ╔══════════════════════════════════════════╗
  ║   Angeo AEO Audit — angeo.dev           ║
  ║   AI Engine Optimization for Magento 2  ║
  ╚══════════════════════════════════════════╝

Store: default — https://mystore.com/

+------------------------------------------+--------+-----------------------------------------------+
| Check                                    | Status | Message                                       |
+------------------------------------------+--------+-----------------------------------------------+
| robots.txt — AI Bot Access               | ✓ PASS | All 7 AI bots are permitted in robots.txt.    |
| llms.txt — AI Content Map                | ✗ FAIL | llms.txt not found.                           |
| sitemap.xml — Search Engine Discovery    | ✓ PASS | sitemap.xml found (1,243 URLs).               |
| Product Schema — JSON-LD Structured Data | ✓ PASS | Product JSON-LD schema found.                 |
| FAQPage Schema — AI Answer Eligibility   | ⚠ WARN | No FAQPage schema on homepage.                |
| AI Product Feed — ChatGPT/Gemini         | ✗ FAIL | No AI-readable product feed found.            |
| Open Graph — Social & AI Preview Tags    | ✓ PASS | All required Open Graph tags found.           |
| Canonical Tags — Duplicate Content       | ✓ PASS | Canonical tag found on homepage.              |
+------------------------------------------+--------+-----------------------------------------------+

  AEO Score: [██████████░░░░░░░░░░] 50% — Needs Improvement
  ✓ Pass: 5  ⚠ Warn: 1  ✗ Fail: 2

  Critical fixes needed:
  → Install angeo/module-llms-txt and generate your llms.txt
  → Install angeo/module-openai-product-feed and run: bin/magento angeo:product-feed:generate

  💡 Fix issues with angeo modules:
     composer require angeo/module-llms-txt
     composer require angeo/module-openai-product-feed

🧪 Running Tests

vendor/bin/phpunit app/code/Angeo/AeoAudit/Test/Unit

🔗 The Angeo AI Suite for Magento 2

This module is part of the Angeo AI Commerce Suite:

Module Purpose
angeo/module-aeo-audit This module — audit your AI readiness
angeo/module-llms-txt Generate llms.txt for ChatGPT, Claude, Gemini
angeo/module-openai-product-feed AI product feed for ChatGPT Shopping
angeo/module-openai-instant-checkout ChatGPT Agentic Commerce / Instant Checkout

🤝 Contributing

Found a bug or want to add a new check? Contributions are very welcome!

Check out the open issues or create a new one. Contact: [email protected]


☕ Support

If this module saves you time, consider buying me a coffee. Your support keeps open-source Magento AI tooling alive. 🙏


📄 License

MIT License — see LICENSE

Keywords: Magento 2 AEO audit, AI engine optimization, ChatGPT SEO Magento, Gemini indexing, llms.txt checker, robots.txt AI bots, structured data audit, Magento 2 AI module, angeo

No changelog yet

The vendor hasn't published a changelog. Tagged releases appear in the Versions tab.

Versions
Version Stability QA Status Released
3.0.0 stable Fail 2026-05-28 18:54:28
2.1.2 stable Not tested 2026-05-15 10:02:00
2.1.1 stable Not tested 2026-04-24 20:27:14
2.1.0 stable Not tested 2026-04-24 19:37:35
2.0.1 stable Not tested 2026-04-19 18:21:18
2.0.0 stable Not tested 2026-04-16 19:27:52
1.0.0 stable Not tested 2026-04-02 18:37:34

Requires 8

Package Constraint
magento/framework ^103.0
magento/module-backend ^102.0
magento/module-catalog ^104.0
magento/module-cms ^104.0
magento/module-config ^101.2
magento/module-store ^101.1
magento/module-ui ^101.2
php ~8.2.0||~8.3.0||~8.4.0

Requires-dev 3

Package Constraint
magento/magento-coding-standard ^33.0
phpstan/phpstan ^1.10
phpunit/phpunit ^10.0

Suggests 2

Package Reason
angeo/module-llms-txt Automatically generate llms.txt after audit.
angeo/module-openai-product-feed Generate AI product feed after audit.

No QA results yet

QA pipelines haven't run for this version. Status appears here once the vendor publishes a tagged release that gets ingested.

License
MIT
Homepage
https://angeo.dev
Authors
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.