AB
AB
AiBoss站

全部分类

project

Hycli - 把任意网站转成带类型的 CLI 与 MCP 工具集

Hycli 是 Hybirdss 维护的开源工具，据项目自述，它能读取任意网站地址与使用目标，自动生成带类型的 CLI 子命令和 MCP 工具，供 AI 代理读写网站内容，并使用本机浏览器登录态。本文整理其维护状态、主要能力、安装入口与许可边界。

Hycli 是一个把网站界面转成命令行工具与 MCP 工具集的开源项目，由 Hybirdss 维护。按项目自述，用户只需给出一个网站地址和想完成的事情，Hycli 就会分析该站点的文档、前端打包产物与浏览器实时网络流量，生成一套带类型的 CLI 子命令和 MCP 工具，覆盖读取与写入两类操作。它面向的是希望让 AI 代理直接操作真实网站、又不想把登录凭据交给模型的使用者：命令行用户、把 Claude Code、Cursor、Codex、Windsurf 等编码代理接入工作流的人，以及需要把网页操作脚本化的自动化场景。

维护者与状态

仓库由 Hybirdss 维护，地址为 Hybirdss/Hycli。仓库创建于 2026-10-09，最后提交时间为 2026-10-30，最新 release 为 v0.1.1，发布于 2026-10-29。截至 2026-11-06，仓库星标数为 451。从时间线看，这是一个非常年轻的项目，首个正式版本距今不足一个月，接口与行为仍可能随版本变化。

主要能力

以下能力均据项目 README 自述整理，未经独立验证。

  • 网站到 CLI/MCP 的自动生成：据项目说明，Hycli 会派出三个 AI worker 分别检查站点文档、前端 bundle 和实时浏览器网络流量，据此合成带类型的 CLI 与 MCP 工具集，读写操作都在准备阶段被发现并写入规格。
  • 多类接口形态覆盖：README 中称，REST 与 OpenAPI 接口会依据 JSON/YAML schema 与 API 文档生成带类型的读写动作；GraphQL 会解析 query 与 mutation 文档并生成带类型的 JSON 变量；HTML 与 JS 渲染页面通过本地 Chromium 引擎提取结构化记录、链接、分页与渲染后的 GET 读取；JSON 与 URL 编码表单则生成带说明的输入、默认值和账号范围内的表单提交。
  • 写入默认关闭：每个新建的网站 CLI 初始为 writes: false。据项目自述，准备、检查阶段从不执行写请求，即使是被伪装成 GET 的变更路径、GraphQL mutation 或 HTML 表单动作也会被拦截；AI 代理首次需要写入时，会针对该 CLI 向用户请求一次确认，用户可通过 hycli writes SITE allow 或 MCP 的 hycli_writes 开启，也可随时用 hycli writes deny 或仪表盘开关收回。
  • 凭据留在本地：README 称浏览器 cookie、localStorage/sessionStorage 令牌与 API key 只存放在本地保险库中，通过操作系统钥匙串加密（Windows Credential Manager、macOS Keychain、Linux Secret Service），或限制为仅用户可读的 0600 权限；模型只看到账号标签、存储键名和脱敏后的响应结构，真实密钥在执行时由本地注入并从输出与日志中清除。
  • 会话导入范围受限：据项目说明，导入浏览器会话时只从临时只读快照中读取目标域名的 cookie 与存储，不会导出其他网站的数据。
  • 反爬与限速策略：项目自述不会对线上服务器做端点字典猜测或模糊测试，而是从文档、OpenAPI/GraphQL schema、静态 JS 与观察到的网络请求形态中学习；请求按站点与账号串行并限速，遵守 Retry-After；遇到 403/429 或机器人挑战时，断路器会切换传输方式（HTTP → 页面内 window.fetch → 隐身 Chromium）或干净地暂停，而不是重复请求同一被拦截地址。
  • 写入不自动重试：据 README，失败或中断的写请求不会自动重试；若连接在 mutation 发出后断开，会报告 action_outcome_unknown，提示用户自行核对网站状态，避免重复下单或重复发帖。

使用入口

项目仓库为 Hybirdss/Hycli，安装包与源码构建说明均以仓库为准。

据项目说明，Hycli 以单个原生二进制分发，内含网站引擎与本地仪表盘（http://127.0.0.1:4318），运行发布包不需要 Rust 或 Node.js。README 给出的典型流程如下：

hycli prepare https://your-website.example --intent "Search posts, save drafts, and publish articles"
hycli describe your-website
hycli your-website search-posts --query "release notes"
hycli writes your-website allow
hycli your-website create-draft --title "Hello from Hycli" --body "Automated from my terminal."

接入编码代理时，README 给出的 MCP 配置为 "command": "hycli", "args": ["mcp"]，可配合 Claude Code、Cursor、Codex 或 Windsurf 使用。首次使用需运行 hycli open 打开本地仪表盘，在 AI connections 中连接模型服务，并通过 Accounts → Find my sign-in 导入已登录站点的浏览器会话。源码构建方式为安装构建依赖后执行 node scripts/build.mjs，再用 ./dist/hycli open 启动。

许可与限制

项目采用 Apache-2.0 许可证。使用前需注意以下边界，均来自项目自述：

  • 项目处于早期阶段，最新版本为 v0.1.1，README 提到已发布的 v0.1.0 中 Windows 与 macOS 便携包不含安装脚本，需改用对应的 *-setup.exe 或 .dmg 安装器；便携包中的 install.sh/install.ps1 需要来自当前源码构建的包。
  • 平台支持范围为 Windows 10/11（x64 与 ARM64）、macOS 13 及以上（Apple Silicon 与 Intel）、Linux（x64 与 ARM64，提供 .deb 与 tar.gz）。
  • 写入能力默认关闭，需要用户按 CLI 逐个授权；效果不明确的操作会在发送前留待人工复核。
  • 遇到验证码、机器人挑战或限流时，工具可能切换传输策略或暂停执行，因此并非所有站点都能稳定自动化。
  • 凭据安全依赖本地保险库与操作系统钥匙串，使用者需自行评估在目标站点上自动化操作是否符合该站点的服务条款。
返回