=== Shop2LLM ===
Contributors: athenalion
Tags: ai, woocommerce, llms.txt, ai agent, ai visibility
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.3
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WooCommerce store visible to ChatGPT, Claude & AI agents. Auto-generate llms.txt, product schema & MCP endpoint — free, open source.

== Description ==

**Shop2LLM** is the simplest way to make your WooCommerce products discoverable by AI assistants like ChatGPT, Claude, and Gemini. One-click setup — no complex configuration.

The free version supports **ChatGPT** with 2 AI tools. Upgrade to Pro for 5 AI tools, always-on AI connection, analytics dashboard, and support across 6 platforms.

= Supported AI Platforms (Free) =

* 🧠 **ChatGPT Desktop** — products appear in ChatGPT's tool palette

= Pro Platforms =

* 🧡 **Claude Desktop** — Claude can search and recommend your products
* 🔵 **Google Gemini** — connect via A2A Agent Card
* 🪟 **Microsoft Copilot** — expose your store as a Copilot extension
* 🟣 **Meta AI** — connect to Meta's agent platform
* ☁️ **Amazon Bedrock** — add your store as a Bedrock action group

= How It Works =

1. **Activate** the plugin (requires WooCommerce)
2. **Copy** the AI connection URL from the settings page
3. **Paste** into ChatGPT
4. **Done** — AI agents can now search your products

= Features =

* **2 AI tools** — product search and product detail
* **AI agent standard** — the protocol used by ChatGPT, Claude, and other AI assistants
* **Product search** — AI agents search by keyword, category, price, stock
* **Product details** — full product info including description, images, ratings
* **No usage limits** — unrestricted AI calls
* **Auto-generated API key** — secure Bearer token authentication
* **ChatGPT support** — one-click setup
* **Auto Product Schema** — JSON-LD for AI readability
* **AI directory page** — auto-generated llms.txt
* **Crawler-friendly robots.txt** — invite AI bots to index your store

= What AI Agents Can Do (Free) =

* "Search for wireless headphones under $100"
* "Show me the top-rated summer dresses in stock"
* "What's the price of product #42?"
* "Find products in the 'electronics' category"

== Installation ==

1. Upload the `shop-to-llm` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings → Shop2LLM 🤖
4. Copy your AI connection URL
5. Paste into ChatGPT

= Requirements =

* WordPress 6.0+
* PHP 8.1+
* WooCommerce 8.0+

== Frequently Asked Questions ==

= What exactly does Shop2LLM do? =

It makes your WooCommerce products discoverable by AI assistants like ChatGPT, Claude, and Gemini. Think of it as SEO for AI — without it, these AI tools can't find or recommend your products. Setup takes 60 seconds.

= How do I connect my store to ChatGPT? =

Install → activate → Settings → Shop2LLM → copy the AI connection URL → paste into ChatGPT as an MCP tool. Done. Full instructions on the settings page.

= Why do I need this? Aren't AI assistants just browsing the web? =

No. AI assistants don't browse HTML like humans do. They read structured data. Without Shop2LLM, ChatGPT sees your store as a blank wall — your products simply don't exist to AI. Over 200 million people ask AI what to buy weekly.

= What is MCP (Model Context Protocol)? =

MCP is the standard OpenAI created for AI assistants to connect to external tools. It's what powers ChatGPT's code execution, web search, and now — your store. Think of it as USB for AI: one protocol, any AI, any tool. Your store becomes a tool ChatGPT can use.

= What is llms.txt? =

A proposed standard (similar to robots.txt) by fast.ai's Jeremy Howard. It's a machine-readable file at /llms.txt that tells AI models what your site contains. Shop2LLM auto-generates and updates this file.

= Is this the same as an AI chatbot on my store? =

No — that's the opposite direction. A chatbot helps visitors ON your site. Shop2LLM makes your products visible OFF your site — inside ChatGPT, Claude, and other AI assistants. Both are useful, but they solve different problems.

= How is this different from SEO? =

SEO helps Google find you. Shop2LLM helps AI find you. They're complementary — you need both. Google handles search queries. ChatGPT, Claude, and Gemini handle conversational product discovery. The channels are growing rapidly.

= Does this replace my SEO plugin? =

No. Shop2LLM works alongside Yoast, Rank Math, and other SEO plugins. Keep your SEO plugin. Add Shop2LLM for the AI layer they don't cover.

= Does this require a cloud account or subscription? =

No. The free version runs entirely on your server. No external cloud dependency. Optional analytics require opt-in consent. Pro adds always-on cloud connection for 6 AI platforms.

= Is my product data sent to external servers? =

No. Product, customer, and order data stays on your server. AI agents connect directly to your WordPress REST API. When you opt in to analytics, only anonymous site metadata and AI crawler visits are sent. Disable anytime.

= Can anyone with ChatGPT search my store? =

Only if you give them your connection URL. It's not publicly listed anywhere. The auto-generated API key adds a second layer of protection. You control who can access your store through AI.

= Will this slow down my site? =

No. The MCP endpoint is a thin JSON-RPC layer over the native REST API. All external calls are non-blocking. No frontend scripts. No database bloat. Works with caching plugins. Under 50KB total plugin size.

= Does it work with all WooCommerce themes and plugins? =

Yes. Shop2LLM operates purely at the REST API level — it doesn't touch your theme or frontend rendering. Compatible with all themes and major plugins including caching, SEO, and page builders.

= What AI platforms are supported? =

Free: ChatGPT (MCP protocol). Pro: Claude Desktop, Google Gemini, Microsoft Copilot, Meta AI, Amazon Bedrock. Upgrade at https://api.aiproductscout.shop/fincore/v1/page/prolanding

= What can AI agents actually do with my store? =

Free tier: search products by keyword/category/price/stock, get full product details including images and ratings. Pro tier: add to cart, checkout, track orders, view order history — all through natural language.

= How do I know it's working? =

Check your AI crawler logs (Settings → Shop2LLM → Analytics). When you see visits from GPTBot, ClaudeBot, or OAI-SearchBot, AI assistants are indexing your store. Pro includes a full analytics dashboard with platform attribution.

= Is this secure? =

Yes. Bearer token authentication on all API endpoints. Auto-generated, rotatable API keys. Follows WordPress security best practices — nonces, capability checks, input sanitization, output escaping.

= Need help or have a question? =

Open an issue on GitHub — I respond within 24 hours:
https://github.com/athenalion007/shop2llm/issues

You can also find me in the WooCommerce Slack #built-with-woo channel.

== Screenshots ==

1. AI Visibility Dashboard — daily API calls, search activity, crawler visits
2. AI Connection Config — copy-paste setup for ChatGPT with API key + endpoint
3. AI Platforms — 7 supported platforms with Free/Pro badges + upgrade CTA

== Changelog ==

= 1.0.3 =
* Improve: search keywords and short description for better discoverability

= 1.0.2 =
* Add: HPOS (High Performance Order Storage) compatibility declaration
* Add: WooCommerce Marketplace support
* Fix: remove invalid contributor

= 1.0.1 =
* Security: fix permission_callback granting access when API key is empty
* Security: prevent settings save from clearing API key
* Fix: Author URI and readme URLs to use bare domain
* Fix: add wp_unslash before sanitize_text_field on POST inputs
* Fix: proper escaping for dynamic HTML attributes and display values
* Remove: load_plugin_textdomain (WP 4.6+ auto-loads by slug)
* Dev: bump Tested up to 7.0

= 1.0.0 =
* Initial release
* AI agent standard support (MCP JSON-RPC protocol)
* ChatGPT integration with 2 AI tools (search + detail)
* Auto-generated API key with Bearer token auth
* Auto Product Schema (JSON-LD) for AI readability
* AI directory page (llms.txt)
* Crawler-friendly robots.txt (12 AI crawlers)
* Admin dashboard — AI visibility, search activity, crawler logs
* Full i18n support — POT + 14 G20 language PO templates
* Product feed XML for Google Shopping
* wp_enqueue_style compliant admin CSS
* 295-structure + 32-API + 17-Docker test suite (344 total)

== Upgrade Notice ==

= 1.0.0 =
Initial release — Shop2LLM for WooCommerce!

== Privacy ==

This plugin can optionally connect to external services provided by FinCore. All external data transmission is **opt-in** and disabled by default:

* **Analytics (Settings → Shop2LLM → Analytics)** — when enabled, anonymized site metadata (site URL, name, platform, version numbers) and AI crawler visits (crawler type, page URL, user agent) are sent to our cloud service. This can be disabled at any time.

* **api.aiproductscout.shop/fincore/v1/free/register** — called when analytics is first enabled, to register site metadata.
* **api.aiproductscout.shop/fincore/v1/crawler/log** — called when AI crawlers visit your store, if analytics is enabled.

No personal customer data, order information, or product data is transmitted. All external calls use HTTPS and are non-blocking (will not affect site performance if the service is unavailable).

Privacy Policy: https://aiproductscout.shop/
Terms of Service: https://aiproductscout.shop/
