OpenCLI 适配器编写
给一个新站点写 OpenCLI adapter:从站点侦察、抓包找接口、字段解码到草稿代码,最后跑通 opencli browser verify 校验。
功能与用途
本技能用于为新网站编写 OpenCLI 适配器或为已有站点扩展 CLI 命令。用户输入目标站点 URL、待提取字段及查询需求,技能通过站点侦察、网络抓包与状态分析挖掘底层真实接口,完成字段解码与输出列设计,生成适配器代码并跑通 verify 验证。最终输出可直接执行的 CLI 适配器脚本、测试样本及站点记忆配置。使用门槛为本地已安装 opencli 环境、运行 Chrome 且 opencli doctor 检查通过。
适用场景
- 新站点 CLI 适配器开发:针对尚无命令行工具的目标网站,通过分析网络请求与页面状态定位真实数据接口,编写并验证全新适配器代码。
- 加密或混淆字段逆向映射:面对接口返回代号无自解释性的复杂页面,结合网页真实可见数据进行对比推导,建立规范统一的输出列命名与类型。
- 改版站点适配器修复与更新:当目标网站调整导致现有适配器校验失败或返回空值时,重新排查接口存活性并同步更新站点记忆与测试样本。
适用人群
- 给内部系统写数据采集命令的开发者
- 维护开源 CLI 适配器仓库的贡献者
- 需要把公司后台数据接进 AI Agent 的工程负责人
使用步骤
- 先跑 opencli doctor,确认浏览器桥接正常,再读 ~/.opencli/sites/<site>/ 下已有的接口与字段记忆。
- 用 opencli browser analyze 或 open 加 wait 加 network 做站点侦察,定出 Pattern A 到 E 中的一种。
- 按 Pattern 去 network 响应、页面初始状态、bundle 或 token 里找候选接口,直接 fetch 验证是否返回 200 且数据非空。
- 解码不认识的字段代号,设计输出列名和顺序,再用 opencli browser init 生成骨架、复制最像的邻居 adapter 改 name、URL 和字段映射。
- 跑 opencli browser verify 并通过 --write-fixture 生成校验种子,最后把接口、字段映射和样本回写到站点记忆目录。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-14
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when writing an OpenCLI adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to opencli, see opencli-usage.
使用前准备
- 已全局安装 opencli(Node >= 20)、Chrome 在运行且已登录目标站点、opencli Browser Bridge 扩展已加载,opencli doctor 返回正常。
依赖与权限
- 读取用户主动提供的内容