将浏览器操作，变成命令行指令

基于 LLM 与 Chrome CDP 协议，cliany-site 自动探索网页工作流，生成可复用的 CLI 命令。像调用脚本一样操控任何网站。

开始使用 查看 GitHub →
✓ 正在连接 Chrome CDP...
✓ 正在分析页面结构...
✓ LLM 规划工作流...
✓ 生成 CLI 命令至 ~/.cliany-site/adapters/github.com/

{"success": true, "data": {"results": [...]}}

核心特性

十六大核心能力，从探索到生态

零侵入探索

通过 Chrome CDP 协议捕获页面无障碍树（AXTree），无需注入脚本，零侵入分析网页结构。

LLM 驱动代码生成

调用 Claude / GPT-4o 理解页面语义，自动将复杂工作流转化为结构化的 Python CLI 命令。

标准 JSON 输出

所有命令支持 --json 选项，输出统一 {success, data, error} 信封格式，方便管道和自动化集成。

持久化 Session

跨命令保持 Cookie 和 LocalStorage 登录状态，一次登录，多次复用。

动态适配器加载

每个网站自动生成独立适配器，按域名动态注册为 CLI 子命令。随时扩展，按需加载。

Chrome 自动管理

自动检测并启动 Chrome 调试实例，支持 macOS 和 Linux，无需手动配置 CDP。

适配器增量合并

重复探索同一网站时智能合并新旧适配器，保留已有命令，自动处理冲突。

原子命令系统

从工作流中自动提取可复用的原子操作，跨适配器共享登录、搜索等通用步骤，参数化复用。

智能录制验证

纯逻辑验证器校验操作步骤完整性，结构化错误报告，可由调用方集成至工作流。

TUI 管理界面

基于 Textual 的终端 UI，可视化管理适配器、查看操作日志、导入导出配置，全键盘操作。

Headless & 远程浏览器

支持 Headless Chrome 和远程 CDP 连接，可在服务器和 Docker 容器中运行，突破本地 GUI 限制。

YAML 工作流编排

通过 YAML 声明式编排多步骤工作流，支持步骤间数据传递、条件判断和重试策略。

数据驱动批量执行

从 CSV/JSON 读取参数列表批量执行，支持并发控制，自动生成汇总报告。

Python SDK & HTTP API

程序化调用 from cliany_site import explore，或启动 REST API 服务，集成到任意系统。

安全加固

Session 加密存储、沙箱执行模式、生成代码自动 AST 安全审计，全方位安全保障。

适配器市场

打包、发布、安装、回滚适配器，团队间共享自动化能力，版本化管理。

工作原理

三步完成从网页到命令行的转化

1

探索 (Explore)

指定目标 URL 和任务描述，LLM 自动分析页面结构并规划操作路径。

cliany-site explore "https://github.com" "搜索仓库"
2

生成 (Generate)

将探索结果转化为 Python/Click 命令行工具，自动保存至本地适配器目录。

~/.cliany-site/adapters/github.com/commands.py
3

执行 (Run)

通过生成的 CLI 命令一键回放工作流。模糊匹配技术确保页面微调后依然稳定运行。

cliany-site github.com search --query "browser-use" --json

命令行参考

$ cliany-site doctor --json
{"success": true, "data": {"cdp": true, "llm": true}}

$ cliany-site login "https://github.com" --json
✓ 等待浏览器完成登录...
✓ Session 已保存至 ~/.cliany-site/sessions/

$ cliany-site explore "https://github.com" "搜索仓库并查看 README" --json
✓ 探索完成，已生成适配器

$ cliany-site list --json
{"success": true, "data": {"adapters": ["github.com"]}}

$ cliany-site github.com search --query "browser-use" --json
{"success": true, "data": {"results": [...]}}

快速开始

五分钟完成安装与配置

Step 1: 安装

# PyPI 安装（推荐）
pip install cliany-site

# 或源码安装
git clone https://github.com/pearjelly/cliany.site.git
cd cliany-site
pip install -e .

Step 2: 配置 LLM

export CLIANY_LLM_PROVIDER=anthropic
export CLIANY_ANTHROPIC_API_KEY="sk-ant-..."

Step 3: Chrome 配置

# 自动检测并启动（推荐，无需手动配置）
cliany-site doctor --json

# 或手动启动 CDP（高级用户）
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug

Step 4: 开始探索

cliany-site doctor --json
cliany-site explore "https://github.com" "搜索仓库" --json