jisu-find-skill（技能查找）

ClawHub 上发现与安装技能；包名是 jisu-find-skill，请用 Python 跑 find_skills.py（不在 PATH 里当命令用）。

入口说明

python3 skills/jisu-find-skill/find_skills.py installed

目录可能是 skills/ 或 skill/，按本仓库实际路径改。Windows 可用 py / python。

做什么

• search：调 clawhub search（含变体与解析）。默认可读（摘要 + 每条 detail_line / description_line，不整段贴 CLI 原始输出）；要结构化结果加 --json。默认对解析到的条目拉 ClawHub API，再按 下载量 → 星标 → match_score → 名称 排序后按 --limit 截断。--no-details 不拉 API，只按 match_score 截断。
• list：clawhub search jisuapi，默认可读；--json 输出完整 JSON。需本机有 clawhub。
• 其它：inspect / install / stats / verify / installed 同样默认可读，--json 可切回机器格式。

不依赖仓库内任何 Markdown 清单文件；极速相关能力请通过 ClawHub 与 list/search 自行发现。

依赖与环境

| 项 | 必需 | 说明 |

|----|------|------|

| python3 | 是 | 运行脚本 |

| clawhub | 对 search/list 需要 | 否则 search 无结果、list 报错 |

| 环境变量（可选） | 作用 |

|------------------|------|

| OPENCLAW_SKILLS_DIR | 已安装技能根目录，默认 ~/.openclaw/workspace/skills |

子命令

| 子命令 | 说明 |

|--------|------|

| search | 默认可读；--json 结构化；默认拉 API 后按下载量排序再 --limit；--no-details 仅按匹配分；--no-clawhub 不调 CLI |

| list | clawhub search jisuapi；--json 输出 JSON |

| inspect | clawhub inspect |

| stats | ClawHub HTTP API |

| install | 默认 dry run，--execute 真装 |

| verify | 检查本机 SKILL.md |

| installed | 目录扫描 + 可选 clawhub list |

search 说明

• 输入：普通字符串、{"q":"…"}、@文件、stdin -。中文会拆 2/3 字做 slug 匹配分；发给 clawhub 仍是原查询。
• 默认拉 API（--no-details 跳过）：sort_by 为 downloads_stars_match_score，否则 match_score。每条含 detail、stars、downloads、description（接口 summary）、author 及展示用 detail_line / description_line（缺省为 —）。merge_note、clawhub_queries_tried 便于排查；HTTP 次数约等于本次 CLI 解析条数。
• 展示序号：name 为 1、org/skill 形式，sort_rank 从 1 起；clawhub_path / install_hint 无序号（供安装）。list 的 results 相同规则。

展示示例（detail_line → description_line）：

1、jisu
星标: 12 | 下载: 340 | 作者: 极速数据 (@jisuapi)
描述: 提供所有的极速数据技能包，供选择使用。

示例

python3 skills/jisu-find-skill/find_skills.py search 天气 --limit 15          # 默认可读
python3 skills/jisu-find-skill/find_skills.py search 天气 --limit 5 --json   # 结构化
python3 skills/jisu-find-skill/find_skills.py search weather --no-details
python3 skills/jisu-find-skill/find_skills.py list
python3 skills/jisu-find-skill/find_skills.py list --json
python3 skills/jisu-find-skill/find_skills.py stats jisuapi/jisu-weather

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。