易智魔方技能 - 商品文案/图片商标侵权检测，以及电商套图生成与重绘（白底图、场景图、功能图、对比图、尺寸图、普通A+、普通A+裁剪版、高级A+；平台 Amazon/亚马逊、AliExpress/速卖通、OZON、Walmart/沃尔玛、TEMU、Allegro、TikTok、Mercado Libre、Shopee/虾皮、eBay、Wayfair）
Scanned 9/23/2026
Skills Directorynpx -y skills add ahang1598/doubao-workbuddy-qwenwork-skills --skill skills --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of easymofang-skill?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/ahang1598-easymofang-skill)More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.
---
name: easymofang-skill
description: 易智魔方技能 - 商品文案/图片商标侵权检测，以及电商套图生成与重绘（白底图、场景图、功能图、对比图、尺寸图、普通A+、普通A+裁剪版、高级A+；平台 Amazon/亚马逊、AliExpress/速卖通、OZON、Walmart/沃尔玛、TEMU、Allegro、TikTok、Mercado Libre、Shopee/虾皮、eBay、Wayfair）
version: "1.0.0"
author: "易佰网络"
---
# 易智魔方 Skill
通过 MCP 调用易智魔方能力：侵权检测（文案 / 图片）、图片上传、电商套图生成（白底图、场景图、功能图、对比图、尺寸图、普通A+、普通A+裁剪版、高级A+；平台 Amazon/亚马逊、AliExpress/速卖通、OZON、Walmart/沃尔玛、TEMU、Allegro、TikTok、Mercado Libre、Shopee/虾皮、eBay、Wayfair）。
## 认证
- 使用开放平台**个人** API Key（`sk-` 前缀），以 `Authorization: Bearer sk-xxx` 注入。
- **团队 Key 不支持**，连接或调用会失败。
## 错误处置
工具失败时返回的文案已按类别归一，**直接转述给用户即可，不要改写成自己的猜测**。按下表判断后续动作：
| 返回文案开头 | 含义 | 该做什么 |
|---|---|---|
| API Key 的魔豆额度已用尽 | 这个 Key 的额度上限用完了，账户本身可能还有魔豆 | 让用户去开放平台**调高该 Key 的额度上限**或换一个 Key。**不要**让他去充值 |
| 账户魔豆余额不足 | 账户余额不够支付本次操作 | 让用户去易智魔方**充值**。文案括号里带了当前余额与本次所需，可一并转述 |
| API Key 无效或已失效 | Key 被删除、禁用或填错 | 让用户重新生成 Key，并在连接器设置中更新 Token |
| 当前 API Key 无权调用该能力 | 多为误用了团队 Key | 确认改用个人 Key |
| 请求过于频繁 / 上一次请求还在处理中 | 限流或并发冲突 | 稍等几秒后**可以重试**，不必改参数 |
| 内容未通过审核 | 文案或素材含违规内容 | 让用户调整文案或更换素材，括号里说明了被拦的字段 |
| 易智魔方服务暂时不可用 | 服务端异常 | 稍后重试；连续失败则建议用户联系客服 |
其余文案（如「参数 xxx 不能为空」「仅支持 jpg/jpeg/png/webp 格式」）是**入参问题**，按提示修正参数后重试，不要向用户报错。
余额与额度类错误发生在扣费之前，**不会产生消耗**，用户充值或调额后可直接重试同样的请求。
## 关键约束（必读）
1. **套图调用顺序**：① 本机图用 multipart 直传 `/ai/obs/image-upload`（或公网图用 `upload_image`）拿 `objectKey` → ② `product_image_series_image_settings` 取 `taskType` / `quality` / `ratio` → ③ `product_image_series_brand_config` 取品牌风格枚举 → ④ 可选 `product_image_series_generate_title` 生成 `productInfo` → ⑤ `product_image_series_submit`。枚举值由服务端配置驱动，**不要凭猜测填写**。
2. **objectKey 与 URL 不能混用**：套图的 `productImages` / `referenceImage` 只认上传返回的 `objectKey`（含 `://` 的值会被拒绝）；`image_compliance_*` 只认公网 `imageUrl`，已有公网地址时不必先上传。
3. **异步与轮询（必须遵守停表规则）**：`product_image_series_submit` / `product_image_series_redraw` 只返回任务标识（`waterNo` / `taskId`）。产物用 `product_image_series_query_tasks` 轮询，**必须带 `waterNo`，只看 `items[0]`**。主任务成功值是 `COMPLETED`，**没有 `SUCCESS`**。`items[0].status`：`PENDING` / `SUBMITTED` → 等 5～8 秒再查；**`COMPLETED` 且 `success=true` → 立刻停止轮询**，把 `subtasks[].result`（OBS key，没有 `https://` 也算成功）展示给用户；**`COMPLETED` 且 `success=false` → 立刻停止**并说明失败。子任务全部为 `SUCCESS` / `FAILED` 也是终态。最多查 20 次，超时让用户去易智魔方查看，禁止无限轮询。
4. **计费**：`text_compliance_check`、`image_compliance_check`、`product_image_series_submit`、`product_image_series_redraw` 扣魔豆；其余工具不计费。
5. **上传限制**：禁止把图片编成 base64 塞进 MCP（请求体过大会被拒）。本机图片用 multipart 直传 `POST /ai/obs/image-upload`；已有公网地址用 `upload_image(imageUrl)`。仅 jpg/jpeg/png/webp，10MB 以内。
支持的上架国家代码（侵权检测 `country`）：`US` / `UK` / `DE` / `JP` / `CA` / `AU` / `FR` / `IT` / `ES` / `NL` / `SE` / `PL` / `IN` / `SG` / `AE` / `SA` / `IE` / `BR` / `MX` / `TR` / `BE` / `EG` / `ZA`。
---
## 一、图片上传
### 本机图片：multipart 直传（推荐）
MCP 入参是 JSON，不能传文件。本机图片请用同一把 `sk-` Key 直传 service-ai：
```bash
curl -X POST "https://app.easymofang.com/api/ai/obs/image-upload" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-F "file=@/path/to/product.jpg"
```
- 成功：返回 JSON，取 `objectKey` 填套图的 `productImages` / `referenceImage`
- 失败：HTTP 400 + 纯文本原因（如「审核未通过」「仅支持 jpg/jpeg/png/webp 格式」）
- 限制：jpg/jpeg/png/webp，10MB 以内；表单字段名必须是 `file`
- **不要**把图片编成 base64 塞进 MCP 工具参数（请求体过大，WorkBuddy 会拒绝）
### upload_image - 按公网 URL 上传到 OBS
仅当图片已有公网可访问地址时使用。返回 `objectKey`（给套图）与 `objectUrl`。不计费。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| imageUrl | string | ✅ | 公网可访问图片地址，服务端下载后上传 |
---
## 二、侵权检测
### text_compliance_parse_amazon_link - 解析亚马逊链接
抓取 ASIN、站点国家、标题与描述，用于填充 `text_compliance_check`。不计费。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| url | string | ✅ | 亚马逊商品详情页链接，需包含 ASIN |
### text_compliance_check - 文案商标侵权检测
同步返回风险词清单。每次调用扣除魔豆。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| title | string | ✅ | 产品标题 |
| country | string | ✅ | 上架国家代码，见上文列表 |
| description | string | - | 产品描述或五点描述 |
| sku | string | - | SKU，仅归档 |
| productLink | string | - | 商品链接，仅归档 |
| asin | string | - | ASIN，仅归档 |
### text_compliance_recent - 最近文案检测记录
不计费。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| size | integer | - | 返回条数，默认 20，上限 50 |
### image_compliance_ocr - 图片 OCR
识别图片文字，结果可作为 `image_compliance_check` 的 `ocrText`。不计费。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| imageUrl | string | ✅ | 图片公网 URL |
### image_compliance_check - 图片商标侵权检测
同步返回风险词。每次调用扣除魔豆。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| imageUrl | string | ✅ | 图片公网 URL |
| country | string | ✅ | 上架国家代码 |
| ocrText | string | - | 图片文字；留空则服务端自动 OCR |
| sku | string | - | SKU，仅归档 |
### image_compliance_recent - 最近图片检测记录
不计费。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| size | integer | - | 返回条数，默认 20，上限 50 |
---
## 三、电商套图
### product_image_series_brand_config - 品牌风格可选值
无入参。返回销售国家/地区、生成图片语言、发布平台、品牌主色、智能字体风格。提交前先调。不计费。
发布平台 `publishPlatforms`（`submit` 的 `publishPlatform`，填英文值）：
| 取值 | 中文名 |
|------|--------|
| Amazon | 亚马逊 |
| AliExpress | 速卖通 |
| OZON | — |
| Walmart | 沃尔玛 |
| TEMU | — |
| Allegro | — |
| TikTok | — |
| Mercado Libre | — |
| Shopee | 虾皮 |
| eBay | — |
| Wayfair | — |
### product_image_series_image_settings - 图片设置可选值
无入参。返回图位类型（imageTypes）、A+ 类型（aPlusTypes）、画质（qualities）、比例（ratios）。`submit` 的 `tasks[].taskType`、`quality`、`ratio` 必须取自本工具或下列枚举。不计费。
图位类型 `imageTypes`（`tasks[].taskType`）：
| taskType | 名称 | 支持模板 |
|----------|------|:--------:|
| WHITE_BG_IMAGE | 白底图 | 否 |
| PRODUCT_IMAGE | 场景图 | 是 |
| FEATURE_IMAGE | 功能图 | 是 |
| COMPARISON_IMAGE | 对比图 | 是 |
| SIZE_IMAGE | 尺寸图 | 是 |
A+ 类型 `aplusTypes`（同样填入 `tasks[].taskType`）：
| taskType | 名称 | 支持模板 | 说明 |
|----------|------|:--------:|------|
| A_PLUS_CROP_IMAGE | 普通A+（裁剪版） | 是 | beta |
| A_PLUS_IMAGE | 普通A+ | 是 | |
| A_PLUS_ADVANCED_IMAGE | 高级A+ | 是 | 可同时出手机 A+（`generateMobileAPlus`） |
画质 `qualities`：`1K` / `2K` / `4K`。
比例 `ratios`：`1:1` / `2:3` / `3:2` / `3:4` / `4:3` / `4:5` / `5:4` / `9:16` / `16:9` / `21:9`。
### product_image_series_generate_title - 生成/润色标题与卖点
同步返回，结果可作为 `submit` 的 `productInfo`。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| productImages | string[] | ✅ | 商品图 OBS objectKey 列表（来自 upload_image），至少一张 |
| title | string | - | 已有标题则润色，否则由图片生成 |
| sellingPoints | string | - | 已有卖点则润色，否则由图片生成 |
### product_image_series_submit - 提交套图任务
异步：立即返回 `waterNo` / `taskId`，产物用 `product_image_series_query_tasks(waterNo)` 轮询。主任务完成是 `COMPLETED`（不是 `SUCCESS`），见到即停，规则见关键约束第 3 条。按生成张数扣魔豆。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| productImages | string[] | ✅ | 商品图 OBS objectKey 列表 |
| tasks | object[] | ✅ | 图位配置，至少一项，见下表 |
| quality | string | ✅ | 画质：`1K` / `2K` / `4K` |
| ratio | string | ✅ | 比例：`1:1` / `2:3` / `3:2` / `3:4` / `4:3` / `4:5` / `5:4` / `9:16` / `16:9` / `21:9` |
| productInfo | string | - | 产品信息（标题+卖点+品牌）；带文案的图位依赖它 |
| sku | string | - | SKU，表单回显 |
| brandMainColor | string | - | 品牌主色，取值见 brand_config |
| intelligentFontStyle | string | - | 智能字体风格，取值见 brand_config |
| salesCountry | string | - | 销售国家/地区，取值见 brand_config |
| generatedImageLanguage | string | - | 生成图片语言，取值见 brand_config |
| publishPlatform | string | - | 发布平台：`Amazon`（亚马逊）/ `AliExpress`（速卖通）/ `OZON` / `Walmart`（沃尔玛）/ `TEMU` / `Allegro` / `TikTok` / `Mercado Libre` / `Shopee`（虾皮）/ `eBay` / `Wayfair` |
| customSettings | string | - | 自定义设置 |
`tasks[]` 字段：
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| taskType | string | ✅ | 图位类型：`WHITE_BG_IMAGE`（白底图）/ `PRODUCT_IMAGE`（场景图）/ `FEATURE_IMAGE`（功能图）/ `COMPARISON_IMAGE`（对比图）/ `SIZE_IMAGE`（尺寸图）/ `A_PLUS_CROP_IMAGE`（普通A+裁剪版）/ `A_PLUS_IMAGE`（普通A+）/ `A_PLUS_ADVANCED_IMAGE`（高级A+） |
| count | integer | ✅ | 该图位生成张数，正整数 |
| baseOnProductInformation | boolean | - | 是否在图上带产品文案，默认 false |
| describe | string | - | 该图位补充描述 |
| referenceImage | string | - | 参考图 OBS objectKey |
| generateMobileAPlus | boolean | - | 仅 `A_PLUS_ADVANCED_IMAGE` 生效，是否同时出手机 A+ |
| templateId | string | - | 模板 ID，A+ 裁剪图用 |
### product_image_series_redraw - 单张重绘
异步：结果用 `product_image_series_query_tasks(waterNo)` 轮询。见到 `COMPLETED` 立刻停止。按张扣魔豆。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| subtaskId | string | ✅ | 子任务 ID，来自 query_tasks |
| describe | string | - | 新描述/提示词；留空则复用原子任务 |
### product_image_series_query_tasks - 查询套图任务
分页查询任务与产物，用于轮询 submit / redraw。不计费。轮询时**必须传 `waterNo`**，只解读 `items[0]`，不要扫整页其它历史任务。
返回是分页结构：`{ current, size, total, items[] }`。看 `items[0]`：
| 字段 | 取值 | 该做什么 |
|------|------|----------|
| status | `PENDING` / `SUBMITTED` | 未完成。等 5～8 秒后再查一次 |
| status + success | `COMPLETED` 且 `success=true` | **立刻停止轮询**。把 `subtasks[].result` 展示给用户 |
| status + success | `COMPLETED` 且 `success=false` | **立刻停止轮询**。告知失败 |
| subtasks[].status | `SUCCESS` / `FAILED` | 该子任务已终态。全部子任务都是二者之一也可停 |
| subtasks[].result | OBS key 数组，如 `["xxx.png"]` | 这就是产物。**不是 URL**，没有 `https://` 也算成功，不要继续查 |
主任务**没有** `SUCCESS` 这个状态，完成就是 `COMPLETED`。最多轮询 20 次。
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| page | integer | - | 页码，从 1 开始，默认 1 |
| size | integer | - | 每页条数，默认 5 |
| waterNo | string | - | 任务流水号，来自 submit 返回；轮询时必传 |
---
## 使用示例
- 文案检测：可先 `text_compliance_parse_amazon_link`，再把标题/描述/国家填入 `text_compliance_check`。
- 图片检测：已有公网图直接 `image_compliance_check`；可选先 `image_compliance_ocr`。
- 套图：按「关键约束」中的顺序调用；提交后用 `waterNo` 查 `product_image_series_query_tasks`。看到 `items[0].status=COMPLETED` 立即停止（`success=true` 展示 `subtasks[].result`，`success=false` 说明失败）。
- 某张图不满意：用返回的 `subtaskId` 调 `product_image_series_redraw`，再用同一 `waterNo` 轮询，同样在 `COMPLETED` 时停止。
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
