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.
Angeo AEO Audit — AI Engine Optimization Auditor for Magento 2
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.
| 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.
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.