StudioMeyer Agent Discovery for WooCommerce
| 开发者 | studiomeyerio |
|---|---|
| 更新时间 | 2026年7月14日 03:15 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
StudioMeyer Agent Discovery for WooCommerce publishes the discovery endpoints that AI shopping agents (like Google AI Mode, ChatGPT, Gemini, Claude, and Perplexity) look for when they want to search, browse, or display products from your store.
The Problem
AI shopping agents can only interact with stores that expose a machine-readable catalog and a way to describe their capabilities. Without these endpoints, your products are invisible to agentic commerce.
What This Plugin Does
The plugin adds three discovery documents and a small REST API on top of WooCommerce:
- UCP Manifest at
/.well-known/ucp— Universal Commerce Protocol (Google and Shopify) manifest describing your shop capabilities. - agents.json at
/.well-known/agents.json— Tool catalog so AI agents know which endpoints they can call. - agent-card.json at
/.well-known/agent-card.json— A2A (Agent-to-Agent) discovery document describing your shop as a commerce agent. - UCP REST API at
/wp-json/ucp/v1/— Product search, product details, and category listing with pagination and price filters. - Agent Discovery Score — Admin dashboard widget with a 0 to 7 checklist that helps you verify the shop is ready.
- Rate limiting — 30 requests per minute per IP, with a filter hook for reverse proxy configurations.
- HPOS compatible — works with WooCommerce High-Performance Order Storage.
- No external services — the plugin does not call out to any third-party API.
- UCP Manifest generator for WooCommerce
- agents.json tool catalog with commerce endpoints pre-wired
- A2A agent-card for agent-to-agent discovery
- Product search REST API with text, category, and price filters
- Single product endpoint with variations, attributes, and gallery images
- Category listing endpoint
- IP-based rate limiting with trusted-proxy handling
- Admin score widget and status page
- Internationalization-ready (text domain
studiomeyer-agent-discovery-for-woocommerce)
- AI-Ready WP — make your whole WordPress site discoverable by AI agents (agents.json, llms.txt, JSON-LD, SEO).
- SmartBot — add an AI chatbot that answers visitor questions 24/7.
安装:
Quick start (about 1 minute)
- Make sure WooCommerce is installed and active.
- In WordPress, go to Plugins → Add New, search for "StudioMeyer Agent Discovery", then click Install Now and Activate.
- That is it — the discovery endpoints go live immediately. Open WooCommerce → Agent Discovery to see your Agent Discovery Score and confirm every endpoint is active.
https://yourshop.example/.well-known/ucp in a browser — you should see the UCP manifest as JSON.
Manual installation
- Download the plugin ZIP.
- Go to Plugins → Add New → Upload Plugin, upload the ZIP, then click Install Now and Activate.
- WordPress 6.4+
- WooCommerce 8.0+
- PHP 8.0+
屏幕截图:
常见问题:
Which AI agents work with these endpoints?
Any agent that implements UCP, A2A, or agents.json. This includes Google AI Mode, Gemini, ChatGPT, Claude, Perplexity, and custom shopping assistants built on top of these specifications.
Is this compatible with WooCommerce HPOS?
Yes. The plugin declares full HPOS (High-Performance Order Storage) compatibility on load.
Does this affect my store's performance?
The plugin only responds when an AI agent or browser explicitly requests one of the discovery URLs or REST endpoints. Regular page loads are not affected. Rate limiting protects the endpoints against abuse.
What is the UCP (Universal Commerce Protocol)?
UCP is an open specification published in January 2026 by Google and Shopify that describes how AI agents discover, search, and purchase products. The plugin implements the shopping discovery portion of the specification; /.well-known/ucp returns the manifest.
Does this plugin connect to external services?
No. All endpoints are served from your own WordPress installation. The plugin does not call any third-party API.
Where does rate limiting data live?
Per-IP request counts are stored as WordPress transients and expire after 60 seconds. No IP addresses are logged or persisted beyond that window.
更新日志:
1.2.3
- New: A short setup wizard opens after activation — confirm WooCommerce is active, see your live discovery endpoints, and jump to your Agent Discovery Score. No configuration needed.
- New: A friendly, one-time review request appears a week after setup. Dismiss it once and it never comes back.
- Security: The rate limiter now reads the client IP from the rightmost non-proxy entry of X-Forwarded-For instead of the leftmost. Behind a single reverse proxy the leftmost entry is set by the client, so the per-IP limit could be bypassed by rotating the header. Direct requests (no trusted proxy) already ignored the header and are unaffected.
- Compatibility: Tested up to WordPress 7.0 and WooCommerce 10.7.
- Fix: /.well-known/ucp is now served directly with 200 instead of a canonical 301 redirect to the trailing-slash URL — minimal agent clients that don't follow redirects get the manifest on the spec path.
- Renamed plugin to StudioMeyer Agent Discovery for WooCommerce (slug:
studiomeyer-agent-discovery-for-woocommerce) - Updated class prefix and text domain to match the new slug
- Added
Requires Plugins: woocommerceheader for WordPress 6.5 plugin dependencies - Removed external upgrade link from the settings page
- Agent-card
provideris now the shop owner (correct A2A semantics) - Removed self-promotional
powered_byfield from agents.json - Rewrote description to remove unsupported comparative claims
- Regenerated translation template
- Removed Pro/License code for clean WordPress.org compliance
- Simplified to discovery-only plugin (UCP, A2A, agents.json)
- Improved rate limiter with trusted-proxy support
- Added phpcs annotations for Plugin Check compliance
- Security: Fixed rate limiter IP spoofing via X-Forwarded-For header
- Security: Added trusted-proxy filter for X-Forwarded-For
- Initial release
- UCP Manifest at /.well-known/ucp
- UCP Product Search and Categories API
- agents.json at /.well-known/agents.json
- agent-card.json at /.well-known/agent-card.json
- Agent Discovery Score dashboard widget
- Rate limiting (30 requests/minute)
- HPOS compatibility
- Full i18n support