> ## 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 API与数据库直连接入

> API与数据库直连接入ORBEXA的完整操作指南：面向自建电商站和非标准电商平台提供最灵活的数据接入方式，涵盖CSV批量导入与智能字段映射、ETL数据管道配置和视觉爬取网页商品信息等多种策略，让任何数据来源的商品都能顺利接入AI代理商务生态系统并被AI发现和推荐

# API与数据库接入

## 概述

对于自建站和非标准电商平台，ORBEXA提供灵活的数据接入方式。当Shopify/WooCommerce/WordPress插件无法覆盖时，商家可以通过CSV导入、ETL管道或视觉爬取将商品数据接入平台。

## CSV导入

### 基本流程

ORBEXA通过ETL Router提供CSV文件导入功能：

1. **上传CSV文件** -- 商家上传包含商品数据的CSV文件
2. **字段映射** -- 平台提供可视化字段映射界面，将CSV列名映射到UCP/ACP标准字段
3. **数据验证** -- 自动检查数据格式、必填字段、数据类型
4. **导入执行** -- 验证通过后批量导入商品数据
5. **AI清洗** -- 导入数据自动进入Refinery Pipeline清洗

### 字段映射

CSV导入的核心是字段映射。不同商家的CSV文件列名千差万别，ORBEXA的映射引擎支持：

* 手动映射：商家在界面中逐列指定对应的标准字段
* 智能建议：基于列名和数据内容自动推荐映射关系
* 映射保存：映射规则保存后可复用，下次导入无需重新配置

## 视觉爬取

### 浏览器自动化引擎

对于没有API也无法导出CSV的平台，ORBEXA提供基于浏览器自动化引擎的视觉爬取能力，可以像人类一样浏览网页并提取商品信息：

* 自动识别商品列表页和详情页
* 提取商品名称、价格、图片、描述等字段
* 处理动态渲染的页面内容
* 支持分页和无限滚动

### 适用场景

* 传统CMS搭建的电商站点
* 没有API接口的老旧平台
* 第三方市场/目录站的商品数据

## 瀑布式数据摄入

ORBEXA实现了瀑布式（Waterfall）数据摄入策略：

```
WooCommerce REST API
        |
        v
   成功？──是──→ 数据入库
        |
       否
        |
        v
  视觉爬取 Fallback
        |
        v
   数据入库
```

**优先使用API**：如果平台提供REST API（如WooCommerce），先通过API获取数据。

**自动降级到视觉爬取**：如果API不可用或数据不完整，自动启用视觉爬取作为降级方案。

这种策略确保无论商家的技术条件如何，ORBEXA都能获取到商品数据。

## 数据提取引擎

ORBEXA的数据提取引擎提供智能数据处理：

* **多源数据归一**：将来自不同来源（CSV、API、爬取）的数据归一化到统一格式
* **智能字段识别**：自动识别非标准字段名并映射到UCP/ACP标准字段
* **数据质量评分**：对每条商品数据评估完整度和质量
* **异常检测**：标记价格异常、描述缺失、图片失效等问题

数据提取引擎是数据进入AI Refinery Pipeline清洗之前的预处理阶段。

## 接入方式对比

| 方式              | 适用场景          | 技术要求    | 数据实时性       |
| --------------- | ------------- | ------- | ----------- |
| Shopify OAuth   | Shopify商家     | 无       | 实时（Webhook） |
| WooCommerce API | WooCommerce商家 | 生成API密钥 | 实时（Webhook） |
| WordPress插件     | 非电商WordPress  | 安装插件    | 低频          |
| CSV导入           | 任意平台          | 准备CSV文件 | 手动触发        |
| 视觉爬取            | 无API平台        | 提供URL   | 定期爬取        |
| API对接           | 自建站           | API开发   | 按需          |

## 小结

API与数据库接入覆盖了Shopify/WooCommerce/WordPress之外的所有场景。CSV导入提供最通用的批量方式，视觉爬取解决无API平台的问题，瀑布式策略确保数据获取的可靠性，数据提取引擎保证数据质量。

***

下一章：[MCP Server](/zh/book-7/ch6-mcp-server) -- 5个工具和3个资源，让AI代理直接查询商品和库存