=== CheckAEO - Analyze & Fix ===
Contributors: checkaeo
Tags: aeo, seo, schema, structured data, ai
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See what AI answer engines can't read on your site, free - then fix the schema, meta, and OpenGraph gaps in one click. Invisible and reversible.

== Description ==

AI answer engines like ChatGPT, Claude, and Perplexity increasingly decide whether your content gets cited. They can only cite what they can read and understand - and most pages are missing the machine-facing signals that make that possible.

**Start with a free scan - no account needed.** Open **Settings > CheckAEO** and it checks how AI answer engines actually see your site:

* Whether AI crawlers (GPTBot, ClaudeBot, PerplexityBot) are blocked in your robots.txt
* Whether your site returns a block or challenge to AI crawler user-agents
* Whether your content is visible without JavaScript (most AI crawlers don't run JS)
* Whether you have an llms.txt file - and if not, **add one in a single free click** (no account needed). CheckAEO serves a generated llms.txt at /llms.txt built from your own site name, tagline, and pages - nothing invented, and fully reversible.

Then, for each page, CheckAEO finds the structured-data and metadata gaps and lets you apply the fixes in one click:

* **Schema markup** (WebPage/Article, BreadcrumbList) - so engines can identify what your page is
* **Meta description** - a ready-made summary for engines to quote
* **OpenGraph tags** - a clean title, description, and image for previews and AI

Everything the plugin adds is **invisible to your visitors** (it goes in the page `<head>`) and **fully reversible** - fixes are stored as post metadata and injected at render, so deactivating the plugin removes them cleanly. The plugin never rewrites your content.

**Only fills gaps.** CheckAEO analyzes the live rendered page, so anything your theme or SEO plugin (Yoast, Rank Math) already outputs is detected and skipped - no duplicate markup.

The plugin is a thin actuator; the AEO analysis runs on the CheckAEO service. The scan is free and needs no account - a free CheckAEO account is required only to **apply** fixes.

== Installation ==

1. Install and activate the plugin.
2. Go to **Settings > CheckAEO** to see a free scan of how AI answer engines read your site - no account needed.
3. To apply fixes, click **Connect to CheckAEO** (sign in or create a free account), then use the **CheckAEO - Analyze & Fix** box on the homepage or any post: click **Analyze & Fix** and **Apply** the gaps you want.

== Frequently Asked Questions ==

= Will this change how my site looks? =
No. Every fix is machine-facing markup in the page `<head>`. Visitors see nothing change.

= Is it reversible? =
Yes. Fixes are stored as post metadata and injected at render. Deactivate the plugin and every fix is gone; no content is modified.

= Does it conflict with Yoast or Rank Math? =
No. CheckAEO analyzes the live page and only offers what is actually missing, so it does not duplicate schema those plugins already output.

= Is an account required? =
No account is needed to scan your site and see what AI answer engines can and can't read. A free CheckAEO account is required only to **apply** fixes - the analysis runs on the CheckAEO service, and connecting links this site to your account.

= How do I report a bug or get help? =
Report it at https://checkaeo.ai/support (choose "The WordPress plugin"), or email gideon@checkaeo.ai. You can also use the support forum on this plugin's WordPress.org page.

== External services ==

This plugin connects to the CheckAEO service (checkaeo.ai) to analyze your pages and return the fixes. The scan works without an account; connecting a free account is required only to apply fixes.

When you click "Analyze & Fix", the plugin sends that page's rendered HTML (or, as a fallback, its public URL) to the CheckAEO API at https://checkaeo.ai - plus your site's connection key once you have connected. For the homepage scan it also asks the API to check your site's robots.txt, llms.txt, and how your homepage responds to an AI crawler user-agent. The API analyzes the page and returns the machine-facing gap fixes and findings. No page content is stored beyond what is needed to generate and return those results. Connecting your site during setup links it to your CheckAEO account.

This service is provided by CheckAEO. By using it you agree to its terms and privacy policy:

* Terms: https://checkaeo.ai/terms
* Privacy: https://checkaeo.ai/privacy

== Screenshots ==

1. The "Analyze & Fix" box in the post editor - one click finds the machine-facing gaps an AI reads.
2. Each gap (schema, meta, OpenGraph) with a one-click Apply. Fixes are invisible to visitors and reversible.
3. Settings > CheckAEO: connect your site to a free CheckAEO account, and analyze and fix your homepage.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Analyze any post, page, or your homepage the way an AI reads it, and one-click apply the machine-facing gap fixes: schema (WebPage/Article, BreadcrumbList), meta description, and OpenGraph tags.
* Apply all: apply every gap fix at once.
* Only fills genuine gaps (coexists with Yoast and Rank Math). Every fix is invisible to visitors and fully reversible.
