=== Agent Ready Shops ===
Contributors: agentreadyshops
Tags: woocommerce, easy digital downloads, ai, chatgpt, product feed
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free audit: can ChatGPT, Gemini and Perplexity read your WooCommerce or Easy Digital Downloads store? Get a 0–100 score and the top fixes.

== Description ==

Shoppers are starting to ask AI assistants what to buy. ChatGPT, Gemini, Perplexity and other shopping agents recommend the products they can read and trust: clear identifiers, complete attributes, real specs, good images and clean structured data. A product page that looks fine to a person can be close to invisible to an agent.

Agent Ready Shops checks your WooCommerce or Easy Digital Downloads catalog the way an AI shopping agent sees it. In under a minute you get:

* **A score from 0 to 100**, from 13 weighted checks (11 for Easy Digital Downloads).
* **Your top fixes**, ranked by how many points each one is worth.
* **The exact products to fix** for every check, linked straight to their edit screens.
* **A weekly re-audit**, so the score stays current without anyone clicking.

= What it checks =

* **Product data:** GTIN / MPN coverage (with check-digit validation), required attributes such as brand, color and size, description quality and specs, variant completeness, images and alt text, title quality, attribute structure and offer hygiene (price, stock status, SKU).
* **Markup and reach:** Schema.org Product markup on your product pages, AI crawler access in robots.txt, Google category mapping, Merchant Center connection and agent protocol discovery (/.well-known/ucp).

= Easy Digital Downloads =

Sell software, ebooks, music or video with Easy Digital Downloads? The audit has its own checks for digital downloads, under Downloads > Agent Ready Shops:

* **Download data:** description quality, the key facts buyers ask about for each kind of download (version, requirements and licence terms for software; format, length and author for ebooks; format and length for audio and video), images, title quality, named price options, offer hygiene (price, and SKU when SKUs are turned on), and categories and tags.
* **Markup and reach:** Schema.org Product markup on your download pages, a published refund and licence policy, AI crawler access in robots.txt and agent protocol discovery (/.well-known/ucp).

Running both WooCommerce and Easy Digital Downloads? Each gets its own screen, report and AI shopper test.

Checks that can't run on your setup, for example on a password-protected staging site or while the store is in "Coming soon" mode, are marked "Not measured" and left out of the score, so you're never marked down for something the audit couldn't see.

= Private by default =

The audit runs entirely on your site. Nothing is sent anywhere, and there's no account to create.

= Optional: AI shopper test =

Want to hear it from an AI directly? Add your own Anthropic API key and an AI model plays a shopping agent: it writes three shopper requests your store should win, says which of 10 sampled products it could confidently recommend from your product data alone, and tells you what's missing from the rest. You see exactly what will be sent before you click. Each run costs a few cents on your Anthropic account.

== Installation ==

1. Install and activate WooCommerce or Easy Digital Downloads, if it isn't already.
2. In WordPress, go to Plugins > Add New, search for "Agent Ready Shops", then click Install and Activate. Or upload the zip under Plugins > Add New > Upload Plugin.
3. Go to WooCommerce > Agent Ready Shops (or Downloads > Agent Ready Shops for Easy Digital Downloads) and click "Run audit".

== Frequently Asked Questions ==

= Is it really free? =

Yes. The audit, the report and the weekly re-audit are free and have no limits. The optional AI shopper test uses your own Anthropic API key, so Anthropic bills you directly for those runs (a few cents each).

= Does it change my products? =

No. It only reads your catalog and reports what to fix. You make the changes yourself, in WooCommerce or Easy Digital Downloads as usual.

= Does it send my store data anywhere? =

Not the audit: it runs entirely on your site. The only thing that ever leaves your site is the optional AI shopper test, and only when you add your own key and click its button. See "External services" below for exactly what it sends.

= Will it slow down my store? =

No. The audit only runs when you click "Run audit" in the admin, and once a week through WP-Cron. It looks at up to 100 of your newest and best-selling products (or downloads) and never runs on your shoppers' page views.

= Why is a check "Not measured"? =

Some checks fetch your product pages, robots.txt or /.well-known/ucp the way an outside crawler would. If your site is password-protected, in WooCommerce's "Coming soon" mode, or blocks loopback requests, those checks can't see the real pages. They're left out of the score instead of counting as zero. Launch the store (or run the audit on the live site) to measure them.

= Do I need a feed plugin or Google Merchant Center? =

No, but they help. The Google category mapping and Merchant Center checks look for Google for WooCommerce and common feed plugins. Without them, those checks score low and the report says what to connect.

= Does it work with variable products? =

Yes. Variations are checked for their own price, stock status, SKU and image.

= Does it work with Easy Digital Downloads? =

Yes, from version 0.3.0. Downloads get 11 checks made for digital products, including price options, the key facts for each kind of download and your refund and licence policy. If you run both WooCommerce and Easy Digital Downloads, each has its own report.

= Which AI model does the AI shopper test use? =

Anthropic's Claude Sonnet, through the Anthropic API with your key. You can also set the key in wp-config.php with `define( 'AGENT_READY_SHOPS_ANTHROPIC_KEY', 'sk-ant-…' );` so it's never stored in the database.

== Screenshots ==

1. Your agent-readiness score and the top fixes, ranked by the points each one is worth.
2. All 13 checks with their scores and weights. Open any check to see the products to fix.
3. The optional AI shopper test: an AI model says which products it could confidently recommend, and what's missing from the rest.
4. Before you run the AI shopper test, you see exactly what is sent for a product.

== External services ==

The audit itself doesn't use any external service. Its checks fetch pages from your own site (robots.txt, /.well-known/ucp and a few product pages) to read them the way a crawler would; those requests stay on your site.

This plugin connects to one external service, the **Anthropic API** (api.anthropic.com), and only for the optional AI shopper test: only after an administrator adds their own Anthropic API key, and only when they click "Run AI shopper test". Nothing is sent before that, and nothing is sent on a schedule.

What is sent, each time the button is clicked:

* Your store's name.
* For 10 sampled products: product ID, title, price and currency, whether it's in stock, category names, brand, attribute names and values, the number of images, whether a valid GTIN is set (yes or no, not the GTIN itself), the first 400 characters of the short description and the first 1,500 characters of the description.
* For Easy Digital Downloads, instead: for 10 sampled downloads, the download ID, title, the kind of download (software, ebook, audio, video or other), price or price options and currency, whether it's free, category and tag names, the number of images, whether a SKU is set (yes or no), which key facts were found, and the first 400 characters of the excerpt and 1,500 characters of the description, with links and shortcodes removed. Never download files or their links, licence keys, customers or orders.
* The administrator's API key, to authenticate the request.

No customer, order, user or personal data is sent. The plugin shows exactly what is sent for a product before you click.

The Anthropic API is provided by Anthropic PBC: [Commercial terms](https://www.anthropic.com/legal/commercial-terms), [Privacy policy](https://www.anthropic.com/legal/privacy).

Nothing is sent to agentreadyshops.com. Agent Ready Shops' own [privacy policy](https://agentreadyshops.com/privacy) and [terms](https://agentreadyshops.com/terms) are on our site.

== Changelog ==

= 0.3.0 =
* New: Easy Digital Downloads support. Under Downloads > Agent Ready Shops, 11 checks made for digital downloads: description quality, key facts for each kind of download, images, titles, price options, offer hygiene, categories and tags, Schema.org markup, refund and licence policy, AI crawler access and agent protocol discovery.
* New: the AI shopper test for Easy Digital Downloads. It never sends download files, file links, licence keys, customer or order data.
* Stores with both WooCommerce and Easy Digital Downloads get a screen, report and AI shopper test for each. The weekly re-audit covers both.
* WooCommerce is no longer required: the plugin works with either. WooCommerce-only stores see no change.

= 0.2.1 =
* Brand colours updated.

= 0.2.0 =
* New name: Agent Ready Shops (formerly Agent Ready for WooCommerce). Your saved report, API key and weekly re-audit carry over automatically.
* Fix: stores in WooCommerce's "Coming soon" mode no longer score 0 on Schema.org markup. Checks the audit can't see are marked "Not measured" and left out of the score.
* Fix: the AI shopper test now sends brand and category names without HTML escaping, sends products with no price as empty rather than " USD", and keeps line breaks in specs lists.
* Form handlers check their security nonce up front, and the plugin passes WordPress.org's Plugin Check.
* Tested up to WordPress 7.1.
* Development: the end-to-end test store can be re-run any number of times and starts from the same catalog each run.

= 0.1.0 =
* First release: 13-check audit, report with top fixes, weekly re-audit, optional AI shopper test.

== Upgrade Notice ==

= 0.3.0 =
Adds Easy Digital Downloads support. WooCommerce stores see no change; your report and settings carry over.

= 0.2.1 =
Brand colours updated. No other changes.

= 0.2.0 =
New name (Agent Ready Shops) and fixes for stores in "Coming soon" mode and for the AI shopper test. Your report and settings carry over.
