clify

clify：为 Agent 重塑网络

clify 可将大多数网站转换为 JSON 命令行工具和 MCP 服务：目前已有 156 个公共网站提供经过验证的命令（开放数据和政府、开发者注册目录、科学、地图和天气、文化、新闻、体育、招聘）。Agent 在无头浏览器中探索网站一次，记录点击操作背后的请求，为每个请求编写类型化命令，并在保留每条命令前在线测试。之后，Agent 会调用网站自己的端点，而不是逐页点击：答案相同，耗时、令牌和 RAM 只需一小部分。网站需要账户时，clify 会使用自己的身份（邮箱和电话号码）或你的身份登录。遇到 CAPTCHA 时，它会暂停并请求人工协助。

_{一次实时运行的回放（2026-10-18T09-57-57-642Z），已加速：GIF 从比赛计时器 0:17 开始，此时浏览器已加载首个页面；视频以 4× 速度播放，又加速了 4×（共 16×）。相同模型（Claude Opus 5.5）在五个已登录的 SaaS 仪表板和一个论坛上完成相同的六个任务：一次通过浏览器，一次通过 clify，使用 clify add 生成的规格（成功生成 6 个 CLI 中的 5 个；svix 的 robots.txt 禁止探索，因此其规格为手动编写）。本次运行：速度快 4.0×，成本低 7.3×。全部 6 次运行：按平均耗时计算快 3.3×（288 秒对 87 秒），配对后的每次运行平均快 3.5×；按平均成本计算低 7.3×，配对后低 7.4×。详见下文和 race/。}

数据一览： 156 个网站通过 CLI 和托管 MCP 提供 1,802 条经过实时验证的读取命令，其中新增一组美国／旧金山网站，涵盖活动、初创公司招聘、公共交通、房源、本地新闻、公共数据和预测市场。

为 YC 的 Make Something Agents Want 黑客松（2026 年 10 月 17–18 日）打造。

用 curl 即可使用，无需安装

公共 Agent API 位于 https://clify-dev.netlify.app。无需安装、密钥或账户：

curl "https://clify-dev.netlify.app/search?q=SF+tech+events"
curl "https://clify-dev.netlify.app/luma/discover-events?city=San%20Francisco"
curl "https://clify-dev.netlify.app/bart/get-departures?station=16TH"

使用 /sites.json 查看目录，使用 /llms.txt 查看完整的 Agent 指南，使用 /<site>.json 查看命令和经过验证的示例 URL。针对特定任务的入口包括旧金山和美国 Agent 任务、Luma 活动、YC 初创公司职位、BART 实时发车信息、Craigslist 旧金山房源和 DataSF。目录中仍保留芬兰网站；其任务页面也仍然可用。机器可读的发现清单位于 /agent.json 和 /.well-known/webmcp.json。

实时演示：6 个浏览器 Agent 对比 6 个 clify Agent

12 个 Claude Code Agent（Claude Opus 5.5）同时启动：在上述六个网站中的每个网站上，一个 Agent 使用浏览器，另一个使用 clify；提示词和账户均相同。每个账户都由 Agent 使用自己的邮箱自行创建。独立检查确认对象出现在实时网站上后，相应的方块就会变绿。2026 年 10 月 18 日太平洋时间 08:58 的实时录制：clify 的 6 个任务全部在 0:27.6 内验证完成，成本为 $0.64；浏览器 Agent 的 6 个任务全部在 1:43.8 内验证完成，成本为 $2.06。你可以自行运行：在有会话的机器上运行 race/bin/grid，或通过 ssh 从笔记本电脑运行 race/bin/mac-demo；详见 race/。

10 秒内开始体验（托管 MCP，无需安装）

claude mcp add --transport http clify https://bold-cloud-h4u6s.run.mcp-use.com/mcp

然后向你的 Agent 提出类似 “crates.io 上 serde 的最新版本，以及旧金山的 NWS 天气预报” 这样的问题。该服务通过 3 个核心工具（clify_sites、clify_help、clify_run）和 4 个热门命令的直接快捷工具，提供 156 个站点和 1,802 条经过实时验证的命令；整个工具列表约占 2.5k 个 token，而不是 569k（每条命令对应一个工具），仅 3 个核心工具约占 1.4k。Codex：codex mcp add clify --url https://bold-cloud-h4u6s.run.mcp-use.com/mcp。只读且公开；写入命令会返回预览，并需要 confirm: true。更多信息请见 mcp/。

**或者给 Agent 发邮件：**向 [email protected] 发送类似 “tokio 的最新版本及其下载量” 这样的问题。全天候运行的 clify Agent 会在自己的 InstaBox 上使用 clify 执行任务，并在你的邮件对话中回复，通常在一分钟内完成（仅限只读的公开站点，每位发件人每天最多 5 个任务）。

它在运行吗？ https://clify-agent-b3d326.inkboxwire.com/status：Agent 的只读状态页（运行时间、今天的任务数、上次回复、模型），由其 InstaBox 通过 Inkbox 网络地址提供。

快速入门（本地 CLI）

Node 22+。clify 未发布到 npm（npm i clify 安装的是无关的软件包）：请克隆仓库。运行 clify add 和登录需要 Chromium；使用 CLI 则无需其他依赖。

git clone https://github.com/ToukoUrsin/clify && cd clify/clify
npm install
npx playwright install chromium               # for `clify add`, `repair`, `login` (or set CLIFY_CHROME)
export PATH="$PWD/bin:$HOME/.clify/bin:$PATH"

clify list --query "SF events"                 # find a site: 156 verified site CLIs ship built in
clify crates search-crates --q "http client" --sort downloads --limit 3
clify weather get-point --lat 37.77 --lon -122.42

export ANTHROPIC_API_KEY=...                  # model access, only for `clify add` / `repair`
clify add https://metacpan.org/               # explore → generate → verify live → install (2–6 min typical, up to ~15 on big sites)

每条命令都会输出一个 JSON 对象（{"ok":true,"count":N,"nextPage":...,"data":...}）；错误会附带 next，即下一步要运行的确切命令。clify mcp 会将所有已安装内容作为本地 MCP 服务提供。Agent 应从 AGENTS.md、clify/AGENTS.md、llms.txt 或 clify guide 开始。

核心数据

所有运行都在真实网站上使用 claude-opus-5-5 完成。比率为 clify 与使用相同模型和提示词执行相同任务的浏览器 Agent 之间的对比。

测试	结果	证据
竞速测试，规格由 clify add 生成（在 5 个已登录的仪表板和 1 个论坛上执行 6 项任务；运行 6 次，每次竞速中均为 6/6 验证通过；6 份规格中有 5 份为生成的：svix 的 robots.txt 禁止探索，因此其规格为手写并已标注）	按平均耗时快 3.3×（288 s 对 87 s）；按每轮配对计算的平均值为 3.5×。按平均成本计算，便宜 7.3×（$2.06 对 $0.28；配对后为 7.4×），包含缓存的 Token 数减少 14.4×（配对后为 14.8×），RAM 使用量减少 9.5×（配对后为 9.4×）	race/README.md、generated-r5-runs.txt、规格 + 生成日志，视频 accounts-4x.mp4
竞速测试，手写规格（相同任务，运行 7 次）	按平均耗时快 4.5×（314 s 对 69 s）；按每轮配对计算的平均值为 4.4×。按平均成本计算，便宜 6.2×（$1.87 对 $0.30；配对后为 6.2×），包含缓存的 Token 数减少 13.0×（配对后为 12.9×），RAM 使用量减少 10.0×（配对后为 10.1×）	accounts-runs.txt，视频 accounts-4x-handwritten.mp4
使用页面 JavaScript 的浏览器（模式 B，强基准），第 5 轮	同一轮中，B 为 253 s / $1.74，clify 为 108 s / $0.30：clify 快 2.3×，便宜 5.9×，包含缓存的 Token 数减少 10.6×。页面 JavaScript 对这些仪表板几乎没有帮助（B 为 253 s，而仅点击的 A 平均为 288 s）；B 在前几轮的平均耗时为：341 s（第 3 轮，n=3）、435 s（第 4 轮，n=2）	race/README.md、generated-r5-runs.txt
基准测试：在 11 个网站上执行 20 项简单的公开只读任务（其中 20 项任务中的 10 项在 4 个爬取练习网站上执行），使用手写规格，每种模式运行 40 次（这 11 个网站的 CLI 均在基准测试前手写，而非生成；每次运行前都用 clify 重新计算真实结果，且不使用 clify 的独立复核对 20 项任务均给出一致结果：truth-check.txt）	所有模式均 40/40 正确。clify 总计耗时 9.0 s / 16.5k 个 Token / $1.28，而仅点击的浏览器为 16.1 s / 79.4k / $4.12：速度快 1.8×，Token 数减少 4.8×，成本降低 3.2×。与浏览器 + 页面 JS 相比：1.4× / 3.1× / 1.8×	bench/README.md、汇总、bench/runs/ 中每次运行的提示词和结果

“按平均值”是指浏览器的平均值（仅点击运行）除以 clify 的平均值（所有运行）；“配对”是指仅点击运行中每轮比率的平均值，此时两种竞速方案在同一时刻运行。使用生成的规格时，clify Agent 现在的模型调用次数与使用手写规格时相当（每次运行 16.8 次对 17 次），成本也大致相同（$0.28 对 $0.30）：clify add 会自动填入已登录账户的项目/组织/团队 ID，并输出简洁的帮助信息（race/README.md，第 5 轮）。两组数据均已发布。本 README 中的所有数据均根据源文件计算，并由 scripts/counts.mjs 检查。

与使用 curl 的 Agent 对比

使用相同模型和提示词，只给 Agent 提供 curl、jq、python3、WebFetch 和 WebSearch，而不是 clify（不使用浏览器）：

• 公开只读基准测试：curl 胜出。 curl 为 40/40，7.5 s / 10.2k 个 token / $1.12；clify 为 40/40，9.0 s / 16.5k 个 token / $1.28（中位耗时、中位 token 数、总成本）。这些网站有文档齐全的 JSON API，或者是模型熟知的抓取沙盒，因此 curl 通常一次调用就能给出答案；clify 则会先读取帮助信息。bench/README.md
• 已登录的控制面板（竞赛模式 D，curl 获得了相同的已保存 Cookie 和令牌文件）：两者均为 6/6，clify 更快。 在相同的 2 次运行中，D 为 97 s / $0.52，clify 为 66 s / $0.29（每次运行 D 和 clify 均为 6/6；配对比较：D 慢 1.5 倍，成本高 1.8 倍）。curl 每次运行都要额外调用以重新发现表单、CSRF 字段和 API 路径；在公开论坛上，它的表现胜过 clify。race/README.md（模式 D）

因此，clify 的价值不在于模型已经熟悉其 API 的网站，而在于那些已登录但未公开文档的部分：通过 clify add 一次性发现并验证请求，而不是每次运行都重新发现；将会话保存在保险库中（生成 D 所用会话的登录、注册和双重验证都是由 clify 完成的）；并填入账户 ID。与浏览器 Agent 的差距大部分来自浏览器本身：使用会话的 curl 也快 3 倍、便宜 4 倍。

已验证成果

• 大多数 URL → 已验证的 CLI。 在从未见过的 44 个公开网站上运行 clify add：41 个（93%） 最终拥有 3 条或更多经实时验证的命令，总计验证了 514 条，每个网站耗时 2–6 分钟，无需人工编辑。3 个未成功的网站设有机器人防护墙，clify 会报告这些防护墙，但不会绕过它们。clify/proofs/sites.md。在 Blaxel 沙箱中对另外 116 个网站进行第二轮测试后，达到 160 个网站中有 133 个拥有 3 条以上已验证命令，且共有 1,634 条已验证命令（其中 1,628 条来自这 133 个网站，列于 wall.json；另外 3 个未达到 3 条的网站共有 6 条）；所有未成功的情况都列出了原因。133 个网站中有 132 个已内置于 clify（RubyGems 自动生成的 spec 仍保留在 proofs/sites/ 中）。clify/proofs/sites-blaxel.md
• Agent 无需协助即可使用。 新启动的 claude -p Agent 的 Bash 权限仅限于 clify，但成功完成了 6/6 项真实任务（handoff.md）。**冷启动：**在空目录中新启动的 Agent 克隆了这棵公开代码树，安装 clify，自行运行 clify add https://flathub.org/（8 条命令全部通过验证），并在 177 秒内正确作答（cold-start.md）。
• 使用自己的账户。 使用一个身份（Inkbox 邮箱和电话号码），Agent 在 19 个网站上自行注册，其中 18 个通过电子邮件链接或验证码完成验证，而且这 19 个账户都能在浏览器关闭的情况下通过纯 HTTP 使用。它读取了 短信验证码，在 Appwrite 上验证了电话号码，并通过了 短信 2FA 登录。clify/test/accounts/results.md、clify/ACCOUNTS.md
• 通过电子邮件向人类求助。 遇到 CAPTCHA 阻拦或即将执行写入操作时，clify 会使用自己的 Primitive 邮箱地址向人类发送邮件，附上截图和固定选项；它只接受来自其求助对象且通过 DMARC 验证的回复，也可以将邮件对话转发给同伴 Agent。三段实时记录：clify/test/ask/。
• 在自己的计算机上运行的 Agent。 一个始终在线的电子邮件 Agent 在 InstaBox 沙箱中通过邮件接收任务，在邮件对话中提出澄清问题，将任务委派给同伴 Agent，使用自己的账户调用 clify，并通过回复发送附件。它经受住了完整的 instabox stop / start 测试（服务在启动时恢复，并能处理下一个任务），也经受住了沙箱自身的空闲暂停。任何人都可以给它发邮件：陌生人会获得受每日限额约束的只读公开层级，限额由代码强制执行（public-tier.md）。无需发邮件即可确认它是否在线：状态页（status.md）。agent/、证明材料、88 秒视频。
• Manufact. 上的 MCP。 托管的 mcp-use 服务在 4 个客户端中都正确完成了同一项涉及两个网站的任务：Claude Code、Codex CLI、mcp-use Agent 和 mcp-use Inspector。mcp/README.md、交互记录。
• 每个网站一个沙箱，并行运行。 已验证网站的测试在 Blaxel 沙箱中进行，每个网站对应一个 Chrome，并在沙箱内运行 clify check。clify/proofs/wall.json

工作原理

flowchart LR
  URL["a URL"] --> EX["explore<br/>headless Chrome, Claude drives it<br/>robots.txt obeyed, writes held"]
  EX --> REC["recording<br/>every XHR / fetch / form + response"]
  REC --> SYN["synthesize<br/>Claude writes typed commands"]
  SYN --> VER["verify + repair<br/>each read command run live, up to 3 rounds"]
  VER --> SPEC[("spec.json<br/>verified commands")]
  SPEC --> CLI["clify &lt;site&gt; &lt;command&gt;<br/>JSON CLI"]
  SPEC --> MCP["clify mcp / hosted MCP<br/>(Manufact)"]
  ACC["accounts<br/>identity: email + phone<br/>encrypted vault, sessions"] -.-> EX
  ACC -.-> CLI
  ASK["ask a human<br/>email / SMS"] -.-> ACC
  CLI --> SITE["the site's own HTTP API"]
  MCP --> SITE

目录	内容
clify/	产品：clify add/repair/check、运行时、账户和保管库、向人类求助、stdio MCP、132 个内置 spec、测试和证明材料
mcp/	基于 clify 运行时核心的托管 MCP 服务（mcp-use，部署在 Manufact 上）
race/	实时竞速面板：浏览器 Agent 对比 clify Agent，实时显示耗时 / 令牌数 / 成本 / CPU / RAM，并提供回放和录制
bench/	20 项任务基准测试，三种模式，以及每次运行的提示词和结果
agent/	使用 clify、运行在 InstaBox 沙箱中的始终在线电子邮件 Agent
film/	2 分钟短片（Remotion）；每个数字都可追溯到本代码库中的文件

以责任为设计原则

只有网站能够信任接收到的内容，为 Agent 提供账户和快速访问 Web 的能力才有用。clify 旨在成为一个行为规范的客户端，并通过代码强制执行以下规则：

• 绝不破解 CAPTCHA。 reCAPTCHA、hCaptcha、Turnstile、Arkose、隐形 CAPTCHA，以及“验证你是人类”页面都会中止流程，并显示 captcha at <url>。不使用求解服务、音频或视觉技巧，也不注入令牌。Agent 会转而向人类寻求帮助。
• 不规避机器人检测。 使用原版无头 Chrome 和如实标识的 clify/<version> user agent。不使用隐身插件、UA 欺骗、代理或指纹伪装。
• 先阅读条款。 在注册前，Claude 会阅读网站的条款和 robots.txt；若条款明确禁止自动化账户，流程就会停止；如果根本找不到条款，也会停止。浏览期间会遵守 robots.txt。
• 身份真实且唯一。 注册时使用名称“clify agent”，以及 Agent 自己的邮箱和电话号码。使用一个持久身份，而非一次性账户；可选字段留空，不勾选营销订阅选项，绝不填写付款信息。
• 写入操作须经确认。 探索过程会记录写入操作，但不会发送（除非明确允许）。写入命令会返回试运行预览；未使用 --yes / confirm: true，或未通过电子邮件获得经验证的人类“批准”，任何内容都不会发送。不在使用真实身份的社交网络（LinkedIn、X、Facebook、Instagram 等）上发帖。
• 机密信息留在本地。 密码、2FA 密钥和会话都存储在 AES-256-GCM 保管库中；模型只会输入 {{password}} 占位符，永远看不到实际值。会话只会发送到网站自己的域名。
• 每次尝试都公开记录。 results.md 中记录了全部 65 次注册尝试，包括 46 次中止：33 次遇到 CAPTCHA 或机器人检测，4 次因条款禁止而中止，4 个网站找不到条款，5 次拒绝（VPN 标记、欺诈标记、地理位置封锁、仅支持 OAuth，以及 Agent 无法操作的表单）。

这些注册旨在证明 Agent 能够拥有真实且可验证的身份，而不是批量创建账户：每个网站只注册一个账户，使用 Agent 自己的姓名公开注册，且仅在条款允许的网站上进行；race 和 Agent 始终只操作自己创建的对象（名称以 race-* 开头，并在每次运行后删除）。

黑客松赛道 → 证据

赛道	我们为此构建的内容	证据
Armature（编码 Agent 自主选择和使用的产品）	面向 Agent 的文档和错误信息：AGENTS.md、llms.txt、SKILL.md、clify guide；全程使用 JSON，每个错误都提供 next。全新的 Agent 可以自行克隆、安装并生成 CLI。	cold-start.md、handoff.md、clify/AGENTS.md、SKILL.md
Manufact（MCP）	部署在 Manufact Cloud 上的 mcp-use v2 服务：135 个网站、1,619 条命令、3 个核心工具（+4 个快捷工具），完整工具列表仅占 2.5k 个 token；与 CLI 使用相同的运行时	mcp/README.md、probe-deployed.txt、4 个客户端的记录
Primitive（面向 Agent 的电子邮件）	clify 的求助于人工流程和常驻 Agent 均通过 Primitive 地址运行：回复经过 DMARC 检查、邮件线程作为上下文、转发即委派	clify/test/ask/、agent/proofs/
Inkbox（Agent 身份）	Agent 的邮箱和电话号码：19 次自主注册均通过电子邮件、短信验证码和短信 2FA 验证；一个对等 Agent 使用自己的 Inkbox 邮箱；还有 Agent 的互联网地址：其公共状态页通过该身份的 Inkbox 隧道提供服务	results.md、ACCOUNTS.md、2-delegate.md、status.md
Blaxel（人类绝不会想要的东西）	一个适用于大多数网站的 CLI（目前覆盖 160 个网站中的 133 个）：没人类想要它，但每个 Agent 都想要。网站扫描在 Blaxel 沙箱中运行	clify/proofs/wall.json
InstaBox（运行在自己电脑上的 Agent）	clify 邮件 Agent 以 systemd 服务的形式运行在自己的 InstaBox 上，拥有自己的保险库，可在完全停止后重新启动，并通过电子邮件接受任何人的任务（只读公共层级）；公共状态页显示其正在运行	agent/README.md、instabox.md、status.md、视频

限制

clify 并不适用于所有网站。机器人防护墙、CAPTCHA、仅在繁重的客户端渲染后才会出现且没有 API 支持的数据，以及 robots.txt 禁止访问的区域，都会报告为阻碍，而不会尝试绕过。网站变更时，生成的规范可能会过时；clify check 会重新运行每个示例，clify repair 会修复出错之处。要重现这场竞赛，Agent 需要在五个仪表板上拥有自己的已登录账号；如需重现，请注册一个身份（clify signup），或使用你的账号登录（clify login --user）。

许可证

MIT，详见 LICENSE。