用途:给定一个 URL 和一句话目标描述,快速生成单个 OpenCLI 命令,走四步流程:打开页面并抓包、锁定一个接口、验证接口可复现、套模板生成 TS adapter 并测试。适合单点快速生成;完整探索式开发请用 opencli-explorer skill。
主要能力与流程:
- 打开页面并抓包:browser_navigate 打开目标 URL,等待 3-5 秒,用 browser_network_requests 筛选返回 application/json 的请求;若未自动触发 API,可手动点击目标按钮或标签再抓一次。
- 锁定接口:关注 URL 路径 pattern、Method、Headers(Cookie/Bearer/CSRF/自定义签名)、Response 数据路径。
- 验证接口:在 browser_evaluate 中用 fetch 复现请求。Cookie 场景用 fetch('/api/endpoint', { credentials: 'include' });需要额外 header 时(如 Twitter)取 ct0 并加 Authorization、X-Csrf-Token 等。fetch 能拿到数据则用 TS adapter(cli() pipeline 或 func());拿不到则用 intercept 策略(TS func() + installInterceptor)。
- 生成 adapter:按认证层级选模板。认证速查:fetch(url) 直接可拿为 Tier 1 public(TS pipeline,browser: false);fetch(url, {credentials:'include'}) 为 Tier 2 cookie;加 Bearer/CSRF header 后拿到为 Tier 3 header;都不行但页面自己能请求成功为 Tier 4 intercept。
使用方式:按模板在 clis/<site>/<name>.ts 中编写 adapter,使用 @jackwener/opencli/registry 的 cli 与 Strategy,配置 site、name、description、domain、strategy、browser、args、columns 和 func。测试命令:npm run build 做语法检查;opencli list | grep mysite 确认注册;opencli mysite mycommand --limit 3 -v 实际运行。
适用场景:需要从特定网页快速生成一个可复用 CLI 命令时。
限制:资料未提供安装方式、依赖版本、收费与平台支持等细节;仅覆盖单点快速生成,复杂场景需参考 opencli-explorer skill。