# sxs-material

孙小圣淘宝 / 天猫 / 1688 商品与抖音 / YouTube / 快手 / 小红书作品素材技能。

## 接入分流（先看）

- **ChatGPT / 需 OAuth**：MCP URL `https://api.sxsai.cn/mcp`，添加连接器后用孙小圣账号登录授权，**不要贴 API Key**。详见 https://sxsai.cn/install/CHATGPT_OAUTH.md
- **Cursor / Claude Code / 脚本**：用 API Key（`SXS_API_KEY` 或 `Authorization: Bearer sk-sxs-...`），按下方安装。

## 触发

用户要获取 / 解析 / 整理 1688、淘宝、天猫商品链接或抖音、YouTube、快手、小红书作品分享的标题、主图/封面、SKU 图、详情图、视频、规格价格、卖点时使用。

## 指令（Skill / 脚本）

1. 确认环境变量 `SXS_API_KEY` 已设置；否则请用户到 https://sxsai.cn → 获取 API → API Keys 创建密钥后再继续。若用户用 ChatGPT，改走上方 OAuth，勿要 Key。
2. 保留用户提供的完整商品或作品分享，包括原文与链接参数；不要把时间、页码或普通数字猜作作品 ID。
3. 在本技能目录执行：
   - `python3 sxs_material.py "<url>"` 获取 JSON；或
   - `python3 sxs_material.py "<url>" --download <dir>` 同时保存图片/视频。
4. 向用户摘要：标题、平台、主图/SKU/详情数量、是否计费成功。
5. 定价：成功 ¥0.02/次，失败不扣费。

## 文件

- `sxs_material.py` — Python 3 标准库脚本
- `sxs_material.mjs` — Node 零依赖脚本
- 完整安装说明见 https://sxsai.cn/install/sxs-material.md

## MCP

- ChatGPT：`https://api.sxsai.cn/mcp` + 账号登录授权（无 Key）
- 其他客户端：`https://api.sxsai.cn/mcp`，Header `Authorization: Bearer $SXS_API_KEY`
- 工具：`get_product_material(url)`、`get_aweme_material(url)`、`get_balance()`

## 抖音作品示例

```bash
curl https://api.sxsai.cn/v1/ecom/aweme \
  -H "Authorization: Bearer $SXS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/e3x2fjE/"}'
```

成功时 `object` 为 `ecom.aweme`，`product.type` 为 `aweme`，含封面 `main_images`、视频 `video`、作者 `author`。也可用 `get_aweme_material` MCP 工具。


## 快手与小红书

- 统一入口 `POST /v1/ecom/product` 和 `get_product_material(url)` 按完整分享自动识别；保留小红书短链、查询参数及整段分享文案。
- 独立接口：`POST /v1/ecom/kuaishou`、`POST /v1/ecom/kuaishou/download`、`POST /v1/ecom/xiaohongshu`、`POST /v1/ecom/xiaohongshu/download`。
- MCP：`get_kuaishou_material(url, download)`、`get_xiaohongshu_material(url, download)`，也可显式传入真实 `photo_id` / `note_id`；普通数字不自动识别为作品 ID。
- 小红书图文 `media_kind=images`，`detail_images` 是原始图集，`video` / `videos` 为空；视频时返回封面与视频。`/download` 只对视频转存并返回 48 小时有效下载地址，图集图片不承诺 48 小时有效。
- 新平台成功仍 ¥0.02 / 次，失败自动退款。下载或本机重新查看已有结果不重新调用解析；网络重试复用 Idempotency-Key。
- 新平台不提供预设作品演示，请仅使用用户明确提供且有权使用的实际分享。文档：https://sxsai.cn/docs/kuaishou 与 https://sxsai.cn/docs/xiaohongshu。