=== Shop2LLM ===
Contributors: athenalion
Tags: ai, woocommerce, llms.txt, ai agent, ai visibility, ai search, ai discovery, mcp, chatgpt, product search, ai readiness
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.4
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WooCommerce store visible to AI assistants. Auto-generates llms.txt, robots.txt, JSON-LD, and MCP tools. Free: AI visibility. Pro ($9/mo): AI transactions. Ultra ($29/mo): AI revenue attribution, ACP/UCP protocols, Google Indexing API.

== 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

= Ultra (v4.0) — Full Agentic Commerce =
* Stripe ACP payment with SharedPaymentToken and instant checkout
* UCP protocol support for Google AI Mode and other UCP-compliant platforms  
* OpenAI Product Feed for ChatGPT product discovery
* AI Visibility health scanner for product data quality
* One-click AI Channel enable for 6 platforms
* Post-purchase tracking, returns, and refunds via AI agents
* AI merchant assistant for natural language store management
* B2B quote, MOQ, and volume discount MCP tools
* A2A protocol for agent-to-agent negotiation

= 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 ==

= Does this require a FinCore cloud account? =

No. Shop2LLM runs entirely on your WordPress server. No external cloud dependency for the core features. Optional analytics and crawler tracking require opt-in consent — see the data privacy section below.

= Is my store data sent to external servers? =

Product data stays on your server. AI agents connect directly to your WordPress REST API.

= What data does the plugin send to external servers? =

External data transmission is **opt-in** and disabled by default. When you enable Analytics in the plugin settings, basic site metadata (site URL, site name, platform type, plugin/WooCommerce/WordPress/PHP version numbers) is sent to our cloud service at api.aiproductscout.shop for registration purposes. AI crawler visits are also reported — this includes the crawler type, page URL, user agent, and an anonymized site identifier.

No personal customer, order, or product data is transmitted. You can disable analytics at any time in Settings. See our privacy policy at https://aiproductscout.shop/ for details.

= What's the difference between Free and Pro? =

Free supports ChatGPT with 2 AI tools (product search + product detail). Pro adds cart, checkout, and order tools, always-on AI cloud connection, analytics dashboard, and AI-channel order attribution across 6 platforms. Upgrade at https://api.aiproductscout.shop/fincore/v1/page/prolanding

= Is this secure? =

Yes. All AI connections require Bearer token authentication. The API key is auto-generated and can be rotated anytime.

== Screenshots ==

1. AI Visibility Dashboard — visibility score, 7-day trends, AI value estimation
2. AI Search Activity & Crawler Visits — see what AI searches for and which platforms visit
3. AI Platforms — 7 supported platforms with Free/Pro badges + smart upgrade CTA

== Changelog ==

= 4.0.0 - June 2026 =
* Major: Stripe ACP deep integration with SharedPaymentToken and idempotency key support
* Major: UCP Checkout Handler with MCP endpoint and full protocol support
* Major: OpenAI Product Feed (/openai-feed.json) with automatic regeneration
* Major: AI Visibility Score — 7-dimension product data health scanner
* Major: AI Channels dashboard — one-click enable for 6 AI platforms with health monitoring
* Major: Post-purchase loop — order tracking, return/refund MCP tools
* Major: AI Merchant Assistant — natural language store management in dashboard
* Major: B2B MCP tools — request quote, MOQ check, volume discount calculation
* Major: A2A (Agent-to-Agent) Server with negotiation capabilities
* New: ACP Payment Health monitoring dashboard card
* New: AI operations suggestions auto-generated from search logs
* New: Weekly report upgraded to AI-generated natural language summary
* Enhanced: checkout/complete returns structured order_confirmation JSON
* Enhanced: get_order returns tracking number, carrier, and estimated delivery
* Enhanced: UCP discovery document with mcp_endpoint and payment_handlers
* Breaking: checkout/complete return format changed from URL to structured JSON

= 3.0.0 =
* New: Ultra tier ($29/mo) — AI revenue attribution, ACP/UCP protocols, Google Indexing API, Merchant Center sync
* New: AI Revenue Attribution — track real AI-driven orders and GMV by platform
* New: ACP (Agentic Commerce Protocol) — 4 checkout endpoints for AI agents
* New: UCP (Universal Commerce Protocol) — discovery endpoint for AI platforms
* New: Google Indexing API — 2-hour Google indexing for Ultra users
* New: Google Merchant Center Content API sync with native_commerce support
* New: 30-day trend chart with 7d/30d toggle for Ultra users
* New: Search term auto-classification (brand/category/price/attribute/generic)
* New: MCP health monitoring with email alerts
* New: Crawler spike detection with alerts
* New: Weekly email report for Ultra users
* New: REST API data export (crawlers, attribution, searches)
* New: Webhook notifications with HMAC signatures
* New: Ultra Landing Page
* Improved: Smart CTA now supports Pro→Ultra upgrade prompts
* Improved: Data retention dynamically adjusts by tier (7/30/90 days)
* Improved: AI value estimate shows real attribution for Ultra users

= 2.0.0 =
* Add: IndexNow proactive push — auto-notify Bing/ChatGPT/Copilot when products are published or updated
* Add: Google Sitemap Ping — auto-notify Google when products change
* Add: AI Visibility Score — 0-100 score with 5 dimensions (llms.txt, robots.txt, JSON-LD, MCP, crawler visits)
* Add: 7-day AI activity trend chart with crawler visits and API calls
* Add: AI Channel Value Estimation card
* Add: llms.txt preview card — see what AI sees when it visits your store
* Add: OpenAI Product Discovery guide — submit your store directly to ChatGPT
* Add: First AI crawler visit notification — email + admin notice celebration
* Add: Smart Pro CTA — dynamic upgrade prompts based on user behavior
* Add: Custom database tables for 30-day data retention (replaces 1-day transients)
* Add: 5 new AI crawler detections (Claude Search, Claude User, Applebot, Common Crawl, Cohere AI)
* Add: robots.txt expansion with Sitemap declarations and new AI crawler rules
* Improve: Dashboard layout reorganized with visibility score, trends, and value estimation
* Improve: Data display changed from "Today" to "7 days" for better trend visibility
* Improve: Crawler visits separated into independent card

= 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.
* **api.aiproductscout.shop/fincore/v1/page/ultralanding** — Ultra tier landing page.
* **indexing.googleapis.com** — Google Indexing API for 2-hour indexing (Ultra tier only).
* **shoppingcontent.googleapis.com** — Google Merchant Center Content API sync (Ultra tier only).

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/
