baidu-ecommerce-search

# baidu-ecommerce-search

百度电商搜索，包括商品对比、榜单、商品参数、品牌品类知识等能力。

## Setup

### 环境依赖

- Python 3.x（使用标准库 `urllib`、`json`、`os`，无需额外安装依赖）

### 配置步骤

1. 访问：https://openai.baidu.com，并登录百度账号
2. 点击权限申请，勾选你需要的能力，未勾选的能力调用时会失败
3. 设置环境变量
   ```bash
   # 必需：设置 API Token
   export BAIDU_EC_SEARCH_TOKEN="your-token"

   # 可选：设置 API 调用 QPS（每秒请求数），默认为 1
   # 设置为 0 表示无限制，设置为 0.5 表示每 2 秒 1 次请求
   export BAIDU_EC_SEARCH_QPS="1"
   ```

**QPS 配置说明：**
- 默认值：`1`（每秒最多1次请求，避免触发限流）
- `BAIDU_EC_SEARCH_QPS=0`：无限制，但容易触发 `token is limit` 错误
- `BAIDU_EC_SEARCH_QPS=0.5`：每2秒1次请求，更保守的限流策略
- 建议保持默认值 `1`，如需更快的请求速度可适当调高

## 何时使用 (触发条件)

当用户提出以下类型的请求时，应优先使用本技能：

**1. 全维度对比决策助手** 
- "[商品A]和[商品B]对比"
- "[商品A]和[商品B]哪个好？"
- "帮我比较一下[商品A]和[商品B]"
- "选[商品A]还是[商品B]？"

**2.1 品牌知识** 
- "[品牌]是什么品牌？"
- "[品牌]品牌介绍"
- "[品牌]品牌故事"

**2.2 品类知识** 
- "[品类]怎么选？"
- "怎么选[品类]？"
- "[品类]选购指南"
- "[品类]选购攻略"

**2.3 商品参数** 
- "[商品]的参数是什么？"
- "[商品]配置"
- "[商品]规格"

**3.1 品牌榜单** 
- "[品类]品牌榜"
- "[品类]排行榜"
- "什么牌子的[品类]好？"
- "[品类]哪个牌子好？"

**4.1 CPS商品查询** 
- "搜索[商品]"
- "查找[商品]"
- "哪里买[商品]"
- "[商品]推荐"

## Usage

### 1. 全维度对比决策助手

提供 SPU 参数/口碑/价格全方位对比评测，协助用户做最优选择。

```bash
# 对比两个商品
python3 scripts/compare.py "iphone16和iphone15对比"
python3 scripts/compare.py "华为mate60和小米14对比"
```

**返回数据包含：**
- SPU 基本信息（名称、品牌、型号等）
- 参数对比（规格、配置等）
- 口碑对比（用户评价、优缺点）
- 价格对比（各平台价格）
- 综合推荐建议

### 2. 商品百科知识

提供品类选购指南、品牌科普知识、全维度参数库的服务。

#### 2.1 品牌知识

查询单个品牌的相关信息，包括品牌简介、品牌定位、明星产品、品牌荣誉...

# 百度电商知识技能包

百度电商知识技能，包括商品对比、全网比价、榜单、商品参数、品牌品类知识等能力。

## 功能特性

- **全维度对比决策助手**: SPU 参数/口碑/价格全方位对比评测
- **商品百科知识**: 品类选购指南、品牌科普知识、全维度参数库
- **实时品牌天梯榜单**: 基于搜索热度、全网声量及销量的品牌排行
- **全网 CPS 商品**: 获取全网 CPS 商品链接及热卖商品信息
- **全网比价**: 获取全网相关 SPU 与优质低价商品链接

## 安装要求

- Python 3.x（使用标准库，无需额外安装依赖）
- 百度电商 API Token

## 配置

1. 访问 https://openai.baidu.com 并登录百度账号
2. 点击权限申请，勾选需要的能力
3. 设置环境变量：

```bash
export BAIDU_EC_SEARCH_TOKEN="your-token"
```

## 目录结构

```
baidu-ecommerce-search/
├── _meta.json           # 元数据配置
├── SKILL.md             # 技能详细说明
├── README.md            # 本文件
└── scripts/
    ├── common.py        # 公共模块（API 请求、Token 管理）
    ├── compare.py       # 商品对比
    ├── knowledge.py     # 品牌/品类/商品参数知识
    ├── ranking.py       # 品牌榜单
    ├── cps.py           # CPS商品搜索
    └── bijia.py         # 全网比价
```

## 使用示例

```bash
# 商品对比
python3 scripts/compare.py "iphone16和iphone15对比"

# 品牌知识
python3 scripts/knowledge.py brand "华为"

# 品类选购知识
python3 scripts/knowledge.py entity "无人机怎么选"

# 商品参数
python3 scripts/knowledge.py param "iphone16"

# 品牌榜单
python3 scripts/ranking.py brand "手机品牌榜"

# CPS商品搜索
python3 scripts/cps.py "机械键盘"

# 全网比价
python3 scripts/bijia.py spu "iphone16价格"
python3 scripts/bijia.py goods "苹果手机价格"
```

## 许可证

MIT License