# Reference · meitu-ota-order-sync

## MCP / OpenAPI

| Item | Value |
|------|--------|
| Transport | Streamable HTTP |
| MCP URL | `https://service.meitu.io/api/mcp` |
| Auth | `Authorization: Bearer <API_Token>` |
| MCP docs | https://meitu.io/mcp |
| OpenAPI docs | https://meitu.io/openapi |
| Create order REST | `POST /api/open/erp/v1/orders` |

写操作均需 MCP 参数 `confirm: true`（或用户明确确认后再调 REST）。

## Tools

### `list_products`

用于把 OTA 产品名 / 外部编号解析成美途 `productId`（`lineId`）。

常用参数：`keyword`、`lineName`、`page`、`size`。

### `list_orders`

去重：按 `vendorOrderId` 查询。

```json
{
  "vendorOrderId": "OTA-ORDER-123",
  "page": 1,
  "size": 20
}
```

有任意命中 → 本笔跳过，不调用创建。

### `create_draft_order`

创建草稿订单（orderStatus=1）。

| 参数 | 说明 |
|------|------|
| `productId` | 美途线路 ID（包团场景可另议；本 Skill 默认必填） |
| `travelStartDate` | 必填 `yyyy-MM-dd` |
| `travelEndDate` | 可选 |
| `adultCount` / `childCount` | 人数 |
| `adultPrice` / `childPrice` / `amount` | 价格；须满足服务端金额校验 |
| `contactName` / `contactTel` | 联系人 |
| `vendorOrderId` | **OTA 订单号**（去重键） |
| `remark` | 备注 |
| `confirm` | 必须为 `true` |

成功结果含 `orderId`。

### `save_order_guests`（可选）

创建成功后写入游客名单；需 `confirm: true`。字段以 MCP / OpenAPI 游客结构为准。

## Computer use tips

1. 先让用户提供商家后台 URL，再导航；不要在 Skill 中写死品牌域名。
2. 登录页出现时暂停，请用户本人完成账号 / 短信 / 扫码验证。
3. 列表筛选优先找「下单日期 / 创建日期」；若后台只有出行日筛选，向用户确认后再筛。
4. 详情页优先复制结构化字段（订单号、日期、人数、金额）；避免整页 OCR 噪声。
5. 同一 OTA 产品名在本批内缓存已确认的 `productId`，减少重复提问。

## Field mapping cheat sheet

| OTA 详情常见文案 | Meitu |
|------------------|-------|
| 订单号 / 预定号 | `vendorOrderId` |
| 产品名称 / 线路名称 | → `list_products` |
| 出发日期 / 出行日期 | `travelStartDate` |
| 返回日期 | `travelEndDate` |
| 成人 / 儿童 | `adultCount` / `childCount` |
| 联系人 / 手机 | `contactName` / `contactTel` |
| 订单金额 / 应付 | `amount` |
| 特殊要求 / 备注 | `remark` |

## Install (human)

1. Download https://meitu.io/skills/meitu-agent-skills.zip  
2. Unzip into `.cursor/skills/`（或客户端 skills 目录）  
3. 配置 Meitu MCP + PAT  
4. 示例：「读取 https://meitu.io/skills/meitu-ota-order-sync/SKILL.md，登录我的 OTA 后台，把今天的订单同步进美途。」

## AI-friendly URLs

| Resource | URL |
|----------|-----|
| Catalog | https://meitu.io/skills/index.json |
| This skill | https://meitu.io/skills/meitu-ota-order-sync/SKILL.md |
| This reference | https://meitu.io/skills/meitu-ota-order-sync/reference.md |
| Pack README | https://meitu.io/skills/README.md |