← 返回 Skills 市场
148
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install jd-search
功能描述
Execute keyword-based product searches on JD Gongcai Cloud with filters for category, price, pagination, and return results in multiple formats.
使用说明 (SKILL.md)
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
安全使用建议
This skill appears to document a JD-internal CLI for searching private JD services, but the published bundle is inconsistent: package.json suggests a Node CLI, README mentions Python and an executable at a local developer path, yet the actual executable file is missing. Before installing or running anything: 1) Don’t run unreviewed binaries — request the jd-search script/source code and inspect it. 2) Confirm the skill’s origin and whether you’re on JD’s internal network (the endpoints are internal-only and will fail or may expose internal data if reachable). 3) Ask the author to provide a complete, reproducible package (source code, build/install steps) or a published release URL (GitHub releases). 4) If you cannot verify the code, avoid symlinking or executing unknown files and do not run network calls to internal hostnames from an environment you don’t trust.
功能分析
Type: OpenClaw Skill
Name: jd-search
Version: 1.0.0
The skill bundle is a utility for wrapping an internal JD (Jingdong) search API (vproxy-search.jd.local), allowing an AI agent to perform product searches with filters like category and price. The documentation (SKILL.md) and configuration (skill.yaml) are consistent with this purpose and show no signs of data exfiltration, malicious execution, or prompt injection. Although the main executable 'jd-search' is referenced in the README and package.json but not provided in the source text, the available metadata and instructions are entirely benign.
能力评估
Purpose & Capability
The skill claims to be a CLI wrapper for JD Gongcai search APIs and the SKILL.md documents exactly those internal endpoints (http://vproxy-search.jd.local/, http://gcy.p-search.jd.local/). That capability is coherent with the name/description. However, the package metadata and README disagree about implementation (package.json declares a Node CLI, README mentions a Python dependency and a ./jd-search script), and the file manifest does not include an actual jd-search executable. These mismatches mean the published bundle does not contain the runtime it advertises.
Instruction Scope
SKILL.md limits runtime behavior to forming HTTP GET requests against JD internal endpoints and formatting results. It does not instruct the agent to read unrelated files or credentials. Caveat: the endpoints are internal-only hostnames — calling them from a machine that has network access could expose internal data or fail outside JD's network. The instructions do not attempt data exfiltration to third-party hosts.
Install Mechanism
No install spec is present (instruction-only), which is low risk. But README shows installation steps that reference an executable path (/Users/zhangrongfa/.joyclaw/...) and symlinking a jd-search binary; that script is not present in the published files. This suggests incomplete packaging or missing artifacts rather than a standard, installable release.
Credentials
The skill declares no required environment variables, credentials, or config paths — appropriate for a simple HTTP search wrapper. No undeclared env access is instructed in SKILL.md. Note: README contains a user-specific absolute path which is irrelevant but indicates this copy may have been packaged from a developer workspace.
Persistence & Privilege
always:false and no special privileges are requested. The skill does not request persistent system-wide changes in its manifest. Autonomous invocation is allowed (platform default) but not accompanied by other red flags.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install jd-search - 安装完成后，直接呼叫该 Skill 的名称或使用
/jd-search触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of the jd-search skill, providing a wrapper for 京东工采云垂搜 search API.
- Supports keyword search, category filtering, price range filtering, and pagination.
- Multiple output formats available: table (default), JSON, and CSV.
- Includes options for filtering in-stock items, specifying scene IDs, and displaying category details.
- Guides provided for usage examples, required parameters, and encoding considerations.
元数据
常见问题
Jd Search 是什么？
Execute keyword-based product searches on JD Gongcai Cloud with filters for category, price, pagination, and return results in multiple formats. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 148 次。
如何安装 Jd Search？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install jd-search」即可一键安装，无需额外配置。
Jd Search 是免费的吗？
是的，Jd Search 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Jd Search 支持哪些平台？
Jd Search 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Jd Search？
由 zhangr19（@zhangr19）开发并维护，当前版本 v1.0.0。
推荐 Skills