Skip to content

yb48666-ctrl/orbexa-agentic-commerce

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ORBEXA Agentic Commerce — WordPress Plugin

Make your WooCommerce store discoverable by AI shopping agents.

WordPress 6.0+ WooCommerce PHP 7.4+ License: GPL v2 Release


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

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

# 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)

# 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)

# 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)

FAQ

Do I need an ORBEXA account? Yes. Sign up free at orbexa.io — 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.

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

License

GPL v2 or later. See LICENSE.

About

WordPress plugin to connect WooCommerce stores to AI shopping agents (ChatGPT, Gemini, Copilot). Open Trust Registry, UCP/ACP/MCP protocols, one-click setup.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors