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组 idgroupids,,131241（可选，不传返回全部）page页码1``pagesize每页数量20``filt_type过滤条件redisstore,1（有货）scene场景 id0（主搜）

场景 ID 对照#

• 0 - 主搜关键词
• 1 - 优惠券搜索默认跳转
• 5 - 类目列表页
• 9 - 店铺内全部商品
• 10 - 店铺内关键词

编码注意事项#

• 中文参数需要用 UTF-8 编码后再 URL encode
• 空格必须 encode 为 %20，不能用 + 号
• 逗号 , 需要 encode 为 %2C

使用方法#

基本搜索#

bash

jd-search "断路器"

指定页码和数量#

bash

jd-search "断路器" --page 2 --pagesize 50

按类目搜索#

bash

jd-search --catid 14081

带价格过滤#

bash

jd-search "断路器" --price 100-500

输出格式#

bash

jd-search "断路器" --format table    # 表格格式（默认）
jd-search "断路器" --format json     # JSON 格式
jd-search "断路器" --format csv      # CSV 格式

显示类目信息#

bash

jd-search "断路器" --with-category

返回字段#

字段说明wareid商品 IDitem_sku_idSKU IDwarename商品名称brand品牌dredisprice价格totalsales销量cid1/cid2/catid类目 IDcid1name/cid2name/catname类目名称

类目层级#

商品可能分布在多个类目下，常见类目路径：

text

家装建材 / 电工电料 / 断路器
工业品 / 中低压配电 / 断路器

示例输出#

text

SKUID           商品名称                                               品牌                           价格      类目路径
100005261983    正泰 (CHNT) 空气开关 家用小型断路器 空开 NBE7 2P 32A               正泰                   ¥   39.84  家装建材 / 电工电料 / 断路器
100005259429    正泰 (CHNT) 空气开关 家用小型断路器 空开 NBE7 2P 63A               正泰                   ¥   42.47  家装建材 / 电工电料 / 断路器

注意事项#

1. 接口为内网服务，需在京东内网环境调用
2. 默认 expression_key 不传，返回全部商品
3. 中文关键词自动进行 UTF-8 URL 编码
4. 响应时间约 15-20ms