alphashop-text
# AlphaShop 文本处理
通过 `scripts/alphashop_text.py` 调用遨虾文本处理 API。
## 前置配置（必须先完成）
⚠️ **使用本 SKILL 前，必须先配置以下环境变量，否则所有接口调用都会失败。**
| 环境变量 | 说明 | 必填 | 获取方式 |
|---------|------|------|---------|
| `ALPHASHOP_ACCESS_KEY` | AlphaShop API 的 Access Key | ✅ 必填 | 可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可 |
| `ALPHASHOP_SECRET_KEY` | AlphaShop API 的 Secret Key | ✅ 必填 | 可以访问1688-AlphaShop（遨虾）来申请 https://www.alphashop.cn/seller-center/apikey-management ，直接使用1688/淘宝/支付宝/手机登录即可 |
**⚠️ AlphaShop 接口欠费处理：** 如果调用 AlphaShop 接口时返回欠费/余额不足相关的错误，**必须立即中断当前流程**，提示用户前往 https://www.alphashop.cn/seller-center/home/api-list 购买积分后再继续操作。
### 配置方式
在 OpenClaw config 中配置：
```json5
{
skills: {
entries: {
"alphashop-text": {
env: {
ALPHASHOP_ACCESS_KEY: "YOUR_AK",
ALPHASHOP_SECRET_KEY: "YOUR_SK"
}
}
}
}
}
```
如果用户没有提供这些密钥，**必须先询问用户获取后再继续操作**。
## 命令速查
脚本路径：`scripts/alphashop_text.py`
| 命令 | 功能 | 必填参数 |
|------|------|----------|
| `translate` | 大模型文本翻译 | `--source-lang` `--target-lang` `--texts` |
| `selling-point` | 生成商品多语言卖点 | `--product-name` `--category` `--target-lang` |
| `title` | 生成商品多语言标题 | `--product-name` `--category` `--target-lang` |
## 使用示例
```bash
# 文本翻译（中文→英文，支持批量）
python scripts/alphashop_text.py translate \
--source-lang zh --target-lang en \
--texts "你好世界" "这是一个测试"
# 自动识别源语种
python scripts/alphashop_text.py translate \
--source-lang auto --target-lang ru \
--texts "Hello World"
# 生成商品卖点（俄语）
python scripts/alphashop_text.py selling-point \
--product-name "纯棉女士T恤" \
--category "女装/T恤" \
--target-lang ru \
--keywords "纯棉" "透气" \
--spec "材质: 纯棉, 季节: 夏季"
# 生成商品标题（生成3条英文标题）
python scripts/alphashop_text.py title \
--product-name "纯棉女士T恤短袖宽松版" \
--category "女装/T恤" \
--target-lang en \
--count 3 \
--keywords "cotton" "casual"
```
## 语言支持
- **翻译**：源语种支持 auto 自动识别，目标语种见语言代码表
- **卖点/标题生成**：支持45种语言，详见 `references/api-docs.md` 语言代码表
- **标题生成语言对**：中文→14种语言，英语→14种语言
## API 详细文档
完整参数说明和语言代码表见 `references/api-docs.md`。
标签
skill
ai
