> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ORBEXA 一体化解决方案

> ORBEXA一体化AI代理商务解决方案概览：平台自动处理UCP/ACP/MCP全部协议端点部署与商品数据清洗工作，支持Shopify、WooCommerce、WordPress和直连API四种接入方式，商家无需编写代码即可实现全协议覆盖，快速提升商品的AI可发现性与OTR信任评分

# ORBEXA 一体化解决方案

## 问题

前面6本书讲了AI代理商务的完整协议栈：UCP商品发现、ACP代理下单、MCP工具连接、OTR信任评分、SEO for AI。

每一个协议都有自己的规范、端点格式、数据要求。独立实现所有协议意味着：

* 部署 `/.well-known/ucp` Profile并维护Checkout/Identity/Order端点
* 按ACP规范格式化商品Feed，配置SFTP通道，实现5个Checkout API端点
* 构建MCP Server暴露商品搜索/库存查询工具
* 编写llms.txt、配置robots.txt、生成Sitemap、部署agent.json
* 实现Schema.org JSON-LD标记
* 持续监控和维护所有端点的数据一致性

对大多数商家来说，这不现实。

## ORBEXA做什么

ORBEXA是一个**AI代理商务基础设施平台（IaaS）**。商家接入ORBEXA后，平台自动处理所有协议合规工作，商家只需专注于商品本身。

| 商家自己做            | ORBEXA自动做                                |
| ---------------- | ---------------------------------------- |
| 管理商品信息（名称、价格、库存） | UCP端点部署和维护                               |
| 处理订单和发货          | ACP商品Feed格式化和同步                          |
| 运营自己的店铺          | MCP Server工具暴露                           |
|                  | llms.txt / robots.txt / sitemap.xml 自动生成 |
|                  | agent.json AI能力声明                        |
|                  | Schema.org JSON-LD标记                     |
|                  | 商品数据AI清洗和标准化                             |
|                  | OTR信任评分监控                                |

## 核心能力

### 1. 协议合规自动化

ORBEXA为每个接入商家自动部署符合官方规范的协议端点：

**UCP端点** (基于UCP 2026-04-08规范):

* `/.well-known/ucp` — UCP发现文档
* `/ucp/v1/products` — 商品列表 (JSON/TSV)
* `/ucp/v1/products/:id` — 商品详情（含变体）
* `/ucp/v1/search` — 全文商品搜索
* `/ucp/v1/checkout-sessions` — 结账会话
* `/ucp/v1/manifest` — 商家能力声明

**ACP端点** (基于ACP 2026-01-30规范):

* JSON-RPC 2.0: `commerce.search` / `commerce.checkout` / `commerce.order_status` / `commerce.product` / `commerce.capabilities`
* REST: `/acp/v1/products` / `/acp/v1/checkout`
* ACP Product Feed: `/ucp/acp-feed.json` (自动格式化为ACP规范字段)

**MCP端点**:

* `/api/mcp/tools` — 工具列表
* `/api/mcp/execute` — 工具执行
* `/api/mcp/resources` — 资源列表
* `/api/mcp/prompts` — 提示词列表

所有端点的商品数据自动从商家的商品库中实时读取，确保价格、库存、状态始终一致。

### 2. 商品数据AI清洗

ORBEXA内置AI数据清洗引擎（Refinery Pipeline），自动处理：

* **字段标准化**: 不同平台的字段名映射到统一UCP/ACP标准字段
* **AI描述优化**: 自动改写低质量商品描述，提升AI代理理解准确度
* **视觉属性提取**: 从商品图片中自动识别颜色、材质、款式等属性
* **分类校正**: 基于分层飞轮学习（商家级→品类级→全局级）持续优化
* **Human-in-the-Loop**: 支持人工审核和修正AI清洗结果

### 3. AI可发现性自动化

接入ORBEXA后，以下文件自动生成并持续更新：

| 文件                   | 作用            | 更新频率          |
| -------------------- | ------------- | ------------- |
| `llms.txt`           | 告诉AI代理商家身份和能力 | 商品变更时实时更新     |
| `robots.txt`         | 允许AI爬虫访问关键资源  | 配置变更时更新       |
| `sitemap.xml`        | 所有商品页面的索引     | 4小时缓存，新商品自动失效 |
| `agent.json`         | AI代理服务能力声明    | 能力变更时更新       |
| `Schema.org JSON-LD` | 商品结构化数据标记     | 商品数据变更时实时     |

### 4. OTR信任评分

ORBEXA运营Open Trust Registry (OTR)，覆盖3,200,000+域名的信任评估：

* 六维度评估: V(身份验证) / S(运营安全) / G(治理合规) / T(信息透明) / D(数据质量) / F(履约与行为)
* 77个评估信号: SSL/DNS/GLEIF/Wikidata/SEC EDGAR/WebRisk等
* REST API: `GET /api/otr/verify/:domain`
* MCP Server: `verify_merchant` / `search_registry` 工具
* `.well-known/otr/verify` — 标准化查询端点
* PDF信任评估报告生成

## 接入方式

ORBEXA支持四种接入方式，覆盖主流电商平台和自建站：

| 方式                                          | 适用平台                    | 技术要求          |
| ------------------------------------------- | ----------------------- | ------------- |
| [Shopify授权插件](/zh/book-7/ch2-shopify)       | Shopify                 | 零代码，OAuth授权即可 |
| [WooCommerce插件](/zh/book-7/ch3-woocommerce) | WooCommerce             | 安装插件，填入API密钥  |
| [WordPress插件](/zh/book-7/ch4-wordpress)     | WordPress(非WooCommerce) | 一键连接          |
| [API/数据库接入](/zh/book-7/ch5-api)             | 自建站/其他平台                | CSV导入或API对接   |

## 章节目录（10章）

1. [平台架构](/zh/book-7/ch1-architecture) — ORBEXA如何自动处理协议合规
2. [Shopify接入](/zh/book-7/ch2-shopify) — OAuth授权、商品同步、Webhook
3. [WooCommerce接入](/zh/book-7/ch3-woocommerce) — 插件安装、API连接、数据同步
4. [WordPress插件接入](/zh/book-7/ch4-wordpress) — 一键连接、内容同步
5. [API与数据库接入](/zh/book-7/ch5-api) — CSV导入、ETL管道、自定义集成
6. [MCP Server](/zh/book-7/ch6-mcp-server) — 5个工具、3个资源、API密钥认证
7. [数据清洗与质量](/zh/book-7/ch7-data-quality) — AI Refinery Pipeline、飞轮学习、HITL
8. [API参考与限速](/zh/book-7/ch8-api-reference) — 端点清单、认证、限速策略
9. [商家控制台](/zh/book-7/ch9-dashboard) — KPI监控、集成管理、数据质量、团队管理
10. [故障排查指南](/zh/book-7/ch10-troubleshooting) — 常见错误、Webhook调试、同步失败、域名验证

<Note>
  ORBEXA是本知识库中涉及的协议合规工具之一。商家也可以选择自己实现所有协议端点 — 前面6本书提供了完整的实现指南和AI提示词。ORBEXA的价值在于将这些工作自动化，让商家专注于商品和运营。
</Note>
