Hybirdss/Hycli

Hycli – 将任何网站转换为面向 AI 代理的类型化 CLI

它是什么

• 一款原生桌面工具（单一二进制文件），可检查您拥有或已登录的网站，然后自动生成类型化命令行界面（CLI）和MCP（多通道协议）服务器，将网站的读写能力暴露给 AI 助手。
• 生成的 CLI 让您可以直接从终端执行搜索、创建草稿、编辑或删除内容等操作，而 MCP 服务器则让编码代理（Claude、Cursor、Codex 等）通过 JSON 消息调用相同的操作。

工作原理

1. 准备 – hycli prepare <url> --intent "…" 启动三个内部“AI 工作器”，分析网站的文档、OpenAPI/GraphQL 规范、静态 JS 包以及从真实浏览器会话捕获的实时网络流量。它们推断可用的端点、请求/响应模式，并生成描述类型化命令的 SiteSpec。
2. 零变更安全 – 在准备期间绝不发送写请求。写操作会被发现但保持禁用（writes: false）。当 AI 首次想要执行写操作时，Hycli 会针对每个站点询问您一次以启用写入（hycli writes <site> allow）。
3. 本地保险库 – 浏览器 Cookie、令牌和其他机密被导入加密的本地保险库（操作系统密钥环），且绝不会出现在 LLM 提示中。当命令运行时，Hycli 在本地注入机密并从日志中清除。
4. 执行 – 命令可以直接运行（hycli <site> search-posts --query "…"）或通过 MCP 服务器（hycli mcp）运行。读取立即执行；写入仅在您授予权限后运行。
5. 弹性 – 如果请求遇到机器人挑战（例如 Cloudflare），Hycli 会切换到隐身 Chromium 引擎或使用导入会话的页面内 fetch，并限制流量速率以避免封禁。

主要功能

• 类型化 CLI：每个端点都成为子命令，自动生成 --help，显示必需参数和 JSON/YAML 模式。
• 多语言界面：仪表盘和生成的文档支持 20 种语言。
• 跨平台：适用于 Windows、macOS、Linux 的原生安装程序（最终用户无需 Rust/Node 运行时）。
• AI 优先集成：提供 MCP 服务器供编码代理调用，并为 Claude、Cursor 或 Codex 等代理提供简单的 JSON 连接配方。
• 安全控制：一次性显式启用写入、无自动重试、严格绑定来源的 Cookie，以及准备（无写入）与执行之间的清晰分离。
• 本地仪表盘：http://127.0.0.1:4318 显示发现的操作、结果，并让您管理账户和 AI 连接。

典型工作流（30 秒快速入门）

# 1. 发现站点和您想做什么
hycli prepare https://example.com --intent "搜索帖子，保存草稿，发布"

# 2. 检查生成的命令
hycli describe example.com

# 3. 立即执行读取
hycli example.com search-posts --query "release notes"

# 4. 当您需要创建/编辑时，启用一次写入
hycli writes example.com allow
hycli example.com create-draft --title "Hello" --body "From Hycli"

AI 连接示例

{
  "mcpServers": {
    "hycli": { "command": "hycli", "args": ["mcp"] }
  }
}

AI 代理随后可以向 MCP 服务器发出 hycli_prepare、hycli_run 等命令。

安全与隐私

• 机密存储在本地加密保险库中；仅符号标识符发送给 LLM。
• 不会向模型泄露凭据，无自动重试，并严格限制速率。
• 可选通过配套扩展导入浏览器会话；Cookie 仅限定于目标域。

适用人群

• 构建需要与现有 SaaS 工具（Notion、GitHub、Slack 等）交互的自主代理的开发人员，无需编写自定义 API 包装器。
• 希望为仅提供 Web 界面的网站编写个人工作流脚本的高级用户。
• 探索安全的 LLM 驱动网页自动化的研究人员。

入门指南

• 从 v0.1.0 发布页面下载相应的安装程序。
• 运行 hycli open 启动仪表盘，连接 LLM 提供商，导入浏览器会话，并开始准备网站。

许可证 – Apache-2.0，并附有明确声明，仅可用于您有权访问的网站。