Content
# ORBEXA Agentic Commerce — WordPress Plugin
**Make your WooCommerce store discoverable by AI shopping agents.**
[](https://wordpress.org/)
[](https://woocommerce.com/)
[](https://php.net/)
[](https://www.gnu.org/licenses/gpl-2.0.html)
[](https://github.com/yb48666-ctrl/orbexa-agentic-commerce/releases)
---
## What is Agentic Commerce?
AI shopping agents (ChatGPT, Google Gemini, Microsoft Copilot, Perplexity, etc.) are helping millions of users discover and purchase products through natural conversation. But these AI agents need a way to:
1. **Find** your store's product catalog
2. **Verify** that your store is trustworthy
3. **Complete** purchases on behalf of users
**ORBEXA Agentic Commerce** bridges this gap by connecting your WooCommerce store to the ORBEXA protocol ecosystem:
| Protocol | Purpose | Auth |
|----------|---------|------|
| **UCP** (Universal Commerce Protocol) | AI agents search and browse your products | Public (no API key) |
| **ACP** (Agentic Checkout Protocol) | AI agents place orders on behalf of users | API Key |
| **MCP** (Model Context Protocol) | AI tool integration (Claude Desktop, Cursor, etc.) | API Key |
| **OTR** (Open Trust Registry) | Trust verification for your store | Public |
## Quick Start
### 1. Download & Install
Download the latest release ZIP:
**[Download orbexa-agentic-commerce.zip](https://github.com/yb48666-ctrl/orbexa-agentic-commerce/releases/latest/download/orbexa-agentic-commerce.zip)**
Then in WordPress:
- Go to **Plugins > Add New > Upload Plugin**
- Upload the ZIP file, click **Install Now**
- Click **Activate**
### 2. Connect Your Store
1. Go to **ORBEXA** in the WordPress sidebar
2. Enter your ORBEXA **email** and **password** ([sign up free](https://orbexa.io/register))
3. Click **Connect to ORBEXA**
4. Done! Takes about 3 seconds.
### What the Plugin Does Automatically
After connecting, the plugin automatically:
- Generates a **secure API key** (`oac_sk_*`, 384-bit entropy)
- Registers your domain with the **Open Trust Registry (OTR)**
- Creates `/.well-known/ucp.json` — UCP discovery manifest for AI agents
- Publishes `/llms.txt` — Protocol discovery file (used by LLMs to find your store)
- Sets up **webhook endpoints** for real-time order sync
- Displays your **OTR Trust Badge** on your storefront
## How AI Agents Find Your Products
Once connected, any AI agent can discover and interact with your store:
### UCP — Product Search (Public, No Auth)
```bash
# Search products
curl -X POST https://orbexa.io/api/v2/ucp/{merchant_id}/search \
-H "Content-Type: application/json" \
-d '{"query": "organic coffee"}'
# Get product catalog manifest
curl https://orbexa.io/api/v2/ucp/{merchant_id}/manifest
```
### ACP — Agentic Checkout (API Key Required)
```bash
# AI agent searches products via JSON-RPC
curl -X POST https://orbexa.io/api/acp/{merchant_id} \
-H "Content-Type: application/json" \
-H "X-Api-Key: oac_sk_YOUR_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "commerce.search",
"params": {"query": "organic coffee"},
"id": 1
}'
```
**ACP Methods:** `commerce.search`, `commerce.product`, `commerce.checkout`, `commerce.order_status`, `commerce.capabilities`
### OTR — Trust Verification (Public)
```bash
# Verify store trust score
curl https://orbexa.io/api/otr/verify/your-store.com
```
## Trust Score
Your store is evaluated across 7 dimensions:
| Dimension | What's Evaluated |
|-----------|-----------------|
| **Identity** | Business registration, brand verification |
| **Technical** | SSL, DMARC, SPF, security headers |
| **Compliance** | Regulatory compliance |
| **Policy** | Privacy policy, refund policy, terms of service |
| **Web Presence** | Schema.org markup, sitemap, mobile readiness |
| **Data Quality** | Product catalog completeness |
| **Fulfillment** | Shipping, delivery tracking |
**Badge Tiers:**
- **PLATINUM** (90-100) — Premium AI placement
- **GOLD** (80-89) — Featured in AI recommendations
- **SILVER** (70-79) — Standard AI visibility
- **BRONZE** (60-69) — Basic AI visibility
## Security
- API keys encrypted with **AES-256-CBC** on your server
- Webhook signatures verified with **HMAC-SHA256**
- Anti-replay protection with timestamp validation
- CSRF protection on all admin actions
- Customer PII is **never transmitted**
- All external communications over **HTTPS/TLS**
## Requirements
- WordPress 6.0+
- PHP 7.4+
- WooCommerce (recommended)
- ORBEXA account ([sign up free](https://orbexa.io/register))
## FAQ
**Do I need an ORBEXA account?**
Yes. [Sign up free at orbexa.io](https://orbexa.io/register) — takes about 2 minutes.
**What data does ORBEXA access?**
Product catalog (titles, prices, images, categories) and anonymized order metrics. Customer PII is never transmitted.
**Is this free?**
Basic OTR listing is free. Premium features available at [orbexa.io/pricing](https://orbexa.io/pricing).
**Which AI agents can discover my store?**
Any agent that queries the ORBEXA protocols — including those built on ChatGPT, Gemini, Copilot, Perplexity, Claude, and others.
**Does it slow down my site?**
No. API calls only happen during admin actions or background cron jobs. No external requests during customer page loads.
## Links
- [ORBEXA Platform](https://orbexa.io)
- [Protocol Documentation](https://orbexa.io/docs)
- [API Reference (llms.txt)](https://orbexa.io/llms.txt)
## License
GPL v2 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-2.0.html).
