JD Search Skill - 工采云垂搜接口封装
概述
封装京东工采云垂搜搜索接口，支持关键词搜索、类目筛选、价格过滤等功能。
接口信息
- 接口地址:
http://vproxy-search.jd.local/ - 后台域名:
http://gcy.p-search.jd.local/ - 调用方式: HTTP GET
必需参数
| 参数 | 说明 | 示例 |
|---|
client | 调用方标识（13 位数字） | 1614133550001 |
key | 搜索关键词 | 手机 |
charset | 编码 | utf8 |
urlencode | 返回编码 | yes |
client_type | 客户端类型 | pc 或 app |
可选参数
| 参数 | 说明 | 示例 |
|---|
expression_key | 组 id | groupids,,131241（可选，不传返回全部） |
page | 页码 | 1 |
pagesize | 每页数量 | 20 |
filt_type | 过滤条件 | redisstore,1（有货） |
scene | 场景 id | 0（主搜） |
场景 ID 对照
0 - 主搜关键词1 - 优惠券搜索默认跳转5 - 类目列表页9 - 店铺内全部商品10 - 店铺内关键词
编码注意事项
- 中文参数需要用 UTF-8 编码后再 URL encode
- 空格必须 encode 为
%20，不能用 + 号 - 逗号
, 需要 encode 为 %2C
使用方法
基本搜索
jd-search "断路器"
指定页码和数量
jd-search "断路器" --page 2 --pagesize 50
按类目搜索
jd-search --catid 14081
带价格过滤
jd-search "断路器" --price 100-500
输出格式
jd-search "断路器" --format table # 表格格式（默认）
jd-search "断路器" --format json # JSON 格式
jd-search "断路器" --format csv # CSV 格式
显示类目信息
jd-search "断路器" --with-category
返回字段
| 字段 | 说明 |
|---|
wareid | 商品 ID |
item_sku_id | SKU ID |
warename | 商品名称 |
brand | 品牌 |
dredisprice | 价格 |
totalsales | 销量 |
cid1/cid2/catid | 类目 ID |
cid1name/cid2name/catname | 类目名称 |
类目层级
商品可能分布在多个类目下，常见类目路径：
家装建材 / 电工电料 / 断路器
工业品 / 中低压配电 / 断路器
示例输出
SKUID 商品名称 品牌 价格 类目路径
100005261983 正泰 (CHNT) 空气开关 家用小型断路器 空开 NBE7 2P 32A 正泰 ¥ 39.84 家装建材 / 电工电料 / 断路器
100005259429 正泰 (CHNT) 空气开关 家用小型断路器 空开 NBE7 2P 63A 正泰 ¥ 42.47 家装建材 / 电工电料 / 断路器
注意事项
- 接口为内网服务，需在京东内网环境调用
- 默认
expression_key 不传，返回全部商品 - 中文关键词自动进行 UTF-8 URL 编码
- 响应时间约 15-20ms
