开发者接口

CLI Finder 注册表 API 与 CLI

通过公开 HTTP API 或仓库内 CLI 搜索 Agent-ready 工具、检查证据，并生成 Skill、策略和机器可读 Manifest。

选择使用方式

API 和 CLI 读取同一份注册表。服务端集成适合直接调用 HTTP；终端工作流适合使用 CLI 的稳定输出和退出码。

Registry API

无需认证的只读 JSON 接口，支持跨域读取、搜索过滤、工具详情和 Artifact 生成。

适合服务端、CI 和自定义 Agent 集成
成功响应采用 code/message/data 包装
公开 Registry Manifest 可整体同步

查看 API 参考

CLI

零运行时依赖的 Node.js 命令行客户端，用于搜索、检查并把 Artifact 输出到 stdout。

适合人工终端、脚本和 Agent shell
普通文本便于阅读，--json 便于解析
稳定退出码区分用法、未找到、网络和 API 错误

查看 CLI 参考

从一次搜索开始

HTTP 示例可以直接请求线上注册表。CLI 尚未发布到 npm；下面的 CLI 命令应在项目仓库检出目录中运行。

通过 HTTP 搜索

curl

curl --get 'https://clifinder.net/api/registry/tools' \
  --data-urlencode 'q=review pull requests' \
  --data-urlencode 'agent=codex' \
  --data-urlencode 'risk=R0' \
  --data-urlencode 'limit=5'

从仓库检出目录运行 CLI

shell

npm exec --package ./packages/cli -- clifinder search \
  "review pull requests" --agent codex --risk R0 --limit 5

CLI 分发状态

packages/cli 当前标记为 private。请勿使用 npm install clifinder，也不要假定公共 npm 包存在。你可以在仓库根目录使用上面的 npm exec 命令，或直接运行 node packages/cli/bin/clifinder.mjs。

机器可读入口

使用具体查询接口进行按需读取，或通过完整 Manifest 同步工具库。所有链接都是可直接访问的普通 URL。

入口	格式	用途
/api/registry/tools	JSON envelope	搜索全部工具并应用 Agent、环境、风险、输出、分类和证据过滤。
/api/registry/tools/:slug	JSON envelope	读取一个工具的安装、输出、命令、风险、Readiness 和证据。
/api/registry/use-cases	JSON envelope	读取完整的双语 Agent 工作流列表，以及每个工作流的工具、步骤、确认节点、回滚和证据。
/api/registry/use-cases/:slug	JSON envelope	按 Slug 读取一个完整工作流。
/api/registry/artifacts/:slug	JSON envelope	按 type、agent 和 mode 生成 Skill、策略、Manifest 或自动化文件。
/registry.json	JSON manifest	直接返回整个注册表，不使用 API envelope，适合缓存和离线索引。

打开搜索响应打开工具详情响应打开工作流响应打开完整 Registry Manifest