OpenCLI Homebrew 适配器实战不登录、不打开浏览器用三个命令查 Formula、Cask 与官方安装量排行【免费下载链接】OpenCLIMake Any Website into CLI Use your logged-in browser by AI agent.项目地址: https://gitcode.com/gh_mirrors/ope/OpenCLI本文讲解 OpenCLI 仓库中 Homebrew 适配器docs/adapters/browser/homebrew.md的完整用法与实现原理通过homebrew formula、homebrew cask、homebrew popular三个只读命令直接调用formulae.brew.sh/api的公开 JSON 端点无需认证、无需浏览器即可获取 Formula/Cask 的元数据以及 Homebrew 官方统计的安装量排行。读完本文你既能复制即用的命令示例与输出字段说明也能从源码层面理解 token 校验、HTTP 错误处理与安装量数值强制转换等细节。适配器定位为什么 Homebrew 可以不需要浏览器OpenCLI 的绝大多数适配器围绕复用已登录浏览器设计但 Homebrew 属于例外它在命令注册时声明browser: false、strategy: Strategy.PUBLIC、access: read见 formula.js、cask.js、popular.js 中各自的cli({...})声明即这是一个纯公开 API 的只读适配器。从源码注释可以看出设计取舍utils.js端点为formulae.brew.sh/api下的公开、免认证 JSON 接口以静态文件形式从 GitHub Pages 分发、每日重新生成Formula/Cask 的 token 遵循 Homebrew 自身的命名规则小写 ASCII 加-_.如gcc13、imagemagick6、c、0-ad、php-cs-fixer所有请求都不携带登录态适配器只是给这些静态 JSON 加一层参数校验、字段规整和表格化输出。命令在仓库中的登记信息站点homebrew、各命令的 args 与 columns可以在 cli-manifest.json 中检索到homebrew站点条目适配器总览见 docs/adapters/index.md。三个命令速览文档将三个命令概括为Inspect Homebrew formulae and casks, plus the official install-rank analytics, without auth or browser. Three commands.命令说明opencli homebrew formula name查询单个 Homebrew core formula 的元数据opencli homebrew cask token查询单个 Homebrew caskmacOS 应用包的元数据opencli homebrew popular查询安装量最高的 formula 或 caskHomebrew 官方 analytics 排行对应的实现文件与注册信息一一对应clis/homebrew/formula.js、clis/homebrew/cask.js、clis/homebrew/popular.js共享逻辑集中在 utils.js。命令用法与示例查询 Formula 与 Cask 元数据# Inspect a formula opencli homebrew formula wget opencli homebrew formula gcc13 opencli homebrew formula imagemagick # Inspect a cask (macOS package) opencli homebrew cask firefox opencli homebrew cask visual-studio-codeformula命令的 positional 参数为nameformula 名称cask命令的 positional 参数为tokencask token二者在 cli-manifest.json 中均标记为required: true、positional: true。查询官方安装量排行# 默认formula / 30d / top 30 opencli homebrew popular # 切换类型与时间窗口 opencli homebrew popular --type cask --window 90d --limit 50 opencli homebrew popular --type formula --window 365d --limit 100 # JSON 输出 opencli homebrew popular -f jsonpopular命令的三个选项默认值与来源均可在 popular.js 的args声明中确认选项说明--typeformula默认或cask--window30d默认/90d/365d--limit最大行数1-500默认 30注意--window只有三个合法取值源码中WINDOWS [30d, 90d, 365d]是一个硬编码的白名单popular.js因为 Homebrew analytics 端点只发布这三种窗口传其他值会先被本地requireOneOf拦下并报ArgumentError不会浪费一次 404 请求。输出字段Columns逐列说明命令输出列formulaformula, tap, version, license, description, homepage, dependencies, deprecated, disabled, source, urlcaskcask, tap, name, version, description, homepage, deprecated, disabled, download, urlpopularrank, token, type, installs, percent, window, url各列的取值来源可以从源码直接核对formulaformula.jsformula取 API 的name字段version取versions.stabledependencies是依赖数组join(, )后的逗号串source取urls.stable.url源码 tarball 地址url是拼接出的https://formulae.brew.sh/formula/name详情页deprecated/disabled为布尔值。caskcask.js与 formula 类似但name可能是数组cask 的友好名列表源码会filter(Boolean).join(, )拼成可读串download取 API 的url字段即实际的 .dmg/.pkg 下载地址。popularpopular.jsrank优先取 API 的row.number缺失时回退为i 1token根据type分别取row.formula或row.caskinstalls经过强制数值转换见下节url指向https://formulae.brew.sh/{cask|formula}/token。一个关键用法popular输出的token列可以直接回灌到formula/cask命令——typeformula时喂给homebrew formula tokentypecask时喂给homebrew cask token。这让先排行、后详情的两段式查询可以完全脚本化例如opencli homebrew popular -f json解析出 token 后逐条查元数据。实现细节token 校验、HTTP 处理与数值规整Homebrew 适配器最值得参考的是它对公共静态 API这一前提的防御式处理全部集中在 utils.js。token 正则与长度上限requireToken使用正则/^[A-Za-z0-9][A-Za-z0-9._-]*$/校验 tokenutils.js且长度上限 100 字符。这与文档 Caveats 一节的描述一致不合法输入会抛出ArgumentError错误提示还附带示例e.g. wget, gcc13, firefox和允许的字符集说明。校验在本地完成意味着非法输入不会发起任何网络请求。统一的 fetch 封装与错误语义brewFetchutils.js对三个命令共用行为包括固定User-Agent为opencli-homebrew-adapter (https://github.com/jackwener/opencli)并声明accept: application/json网络异常DNS、超时等包装为CommandExecutionError并提示检查 formulae.brew.sh 是否可达HTTP 404 抛EmptyResultError资源不存在HTTP 429 抛带等待几秒后重试建议的CommandExecutionErrorHomebrew 会对突发流量限流其余非 2xx 状态码以及 JSON 解析失败都归为CommandExecutionError避免把上游的畸形响应静默吞掉。安装量的字符串数字强转Homebrew analytics 把安装量发布为带千分位逗号的字符串如139,972。parseInstallCountutils.js先replace(/,/g, )去掉逗号再转数字非有限值返回null。这就是文档 Caveats 中we coerce them to plain numbers的落地实现——不经过这一步installs列会输出带引号语义的字符串无法排序或做数值比较。行数截断与空结果popular先取body.items全量数组再slice(0, limit)截取前 N 行popular.js若items为空则抛EmptyResultError并说明type/window组合而不是输出空表格。limit由requireBoundedInt保证为正整数且不超过 500。已知限制Caveats文档明确列出四条限制结合源码可以确认其成因token 校验规则[A-Za-z0-9][A-Za-z0-9._-]*、最长 100 字符非法输入报ArgumentError--type与--window只接受 Homebrew analytics 实际发布的值formula/cask30d/90d/365d其余取值报ArgumentErroranalytics 的安装量是逗号格式字符串适配器已强制转换为普通数字端点是每日重新生成的静态 GitHub Pages JSON数据最多滞后约 24 小时——用popular做决策时应记住这一点它反映的是截至上一次每日构建的匿名聚合安装统计不是实时计数。前置条件与适用前提无浏览器依赖、无认证依赖仅使用三个公开端点https://formulae.brew.sh/api/formula/name.jsonhttps://formulae.brew.sh/api/cask/token.jsonhttps://formulae.brew.sh/api/analytics/(install|cask-install)/window.json基础 URL 常量BREW_BASE https://formulae.brew.sh/api定义在 utils.js。网络需能访问formulae.brew.sh受网络限制时命令会给出明确的可达性提示被限流时提示等待重试。命令声明为access: read纯查询、无副作用适合放进 Agent 工具链或 CI 脚本中做软件包元数据查询。小结Homebrew 适配器是 OpenCLI 中典型的公开 API 型命令组不依赖已登录浏览器靠严格的本地参数校验token 正则、枚举白名单、有界整数、统一的 HTTP 错误映射404/429/5xx和数值规整千分位安装量转数字把三个静态 JSON 端点包装成可直接表格化、可 JSON 化、可被popular → formula/casktoken 回灌串联使用的命令行工具。源码集中在 clis/homebrew/ 四个文件formula.js、cask.js、popular.js、utils.js若要编写类似的公共数据源适配器这是一个紧凑且完整的参考实现。【免费下载链接】OpenCLIMake Any Website into CLI Use your logged-in browser by AI agent.项目地址: https://gitcode.com/gh_mirrors/ope/OpenCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考