Unbrowse

Unbrowse

每个网站，即使没有官方 API 或 MCP，也仍会依赖第一方 API 与其后端通信。 Unbrowse 调用这些网站的第一方 API，使 Agent 式浏览比使用浏览器快 50–100 倍，成本低 95%。

这是托管式 Unbrowse 服务 （https://unbrowse.ai）的开源客户端：用于其 REST API 的 @unbrowse/sdk TypeScript 客户端，以及基于它构建的 unbrowse CLI。

安装 Agent 技能：

npx skills add unbrowse-ai/unbrowse --skill unbrowse

连接你的 Agent：

claude mcp add --transport http unbrowse https://unbrowse.ai/mcp

在你的客户端中完成 OAuth 登录。从终端执行：npx unbrowse login（在浏览器中进行 OAuth，无需粘贴任何内容），然后执行 npx unbrowse run 'top stories on hacker news'。

安装 · CLI · MCP · SDK · 故障排除

工作原理

1. 发现。 Unbrowse 会搜索你的私有能力，然后搜索已编译为工具的网站公共注册表。
2. 运行。 匹配的能力会重放网站自身的第一方 HTTP 请求。无需浏览器。 只有在结果经过验证后，运行才算成功。
3. 学习一次。 没有匹配项时：Agent 会在 Unbrowse 录制的云端浏览器中完成任务（MCP），或者 你上传两份 HAR 录制文件（unbrowse learn）。Unbrowse 会将这些请求编译为一次调用即可使用的能力。下次只需执行第 2 步。

密码会保存在 Unbrowse 密码管理器中；CLI 不会接收密码。

更多内容：docs/how-it-works.md · 论文：你只需要内部 API（arXiv:2604.00694）

命令

unbrowse login [--key ub_live_…]    sign in (browser OAuth) or store an API key
unbrowse discover <query>           your capabilities, then the public registry
unbrowse run <task…> [--set k=v]    run a task from your IP (--from-unbrowse: from Unbrowse); waits for a verified result
unbrowse resume <runId> k=v…        answer what the run asked for, on the same run
unbrowse scrape <url>               read one page as markdown
unbrowse index <url>                teach Unbrowse a site: each flow becomes a tool
unbrowse learn a.har b.har          compile two recordings into a capability
unbrowse logins                     saved logins, masked
unbrowse registry [query]           public compiled sites (no account)

所有命令：docs/cli.md。退出代码：0 表示成功，1 表示错误，2 表示需要输入， 3 表示需要注册或登录，4 表示未验证。

SDK

import { Unbrowse } from "@unbrowse/sdk";
const ub = new Unbrowse(); // UNBROWSE_API_KEY
const run = await ub.wait((await ub.run({ task: "top stories on Hacker News", idempotencyKey: crypto.randomUUID() })).runId);

支持的 REST 方法：docs/sdk.md。

Agent

Agent 连接到托管式 MCP（https://unbrowse.ai/mcp，请参阅 docs/install.md） 并遵循 skill/SKILL.md。CLI 是 REST 方式的替代方案。unbrowse mcp 会运行一个本地 stdio 代理，连接到托管式 MCP，供需要 stdio 或纯工具名称（unbrowse_scrape）的宿主使用。

Claude Code、Codex、Grok Build、OpenClaw、Hermes 和 elizaOS 的插件会打包该技能，并让 Unbrowse 成为宿主的浏览器：plugins/。Grok、ChatGPT、Claude、Perplexity、Le Chat 和 Gemini CLI 可作为自定义连接器接入：docs/connect.md。

定价

查看你当前的账户套餐，并使用 unbrowse usage 查看配额和定价。 docs/pricing.md

开发

bun install
bun test packages     # SDK route tests + CLI tests against a local stand-in API
bun run typecheck
bun run build         # packages/sdk/dist, packages/cli/dist/cli.js (Node 18.17+)
bun run cli help

发布

CI/CD 会在版本标签上发布：docs/release.md。

此处包含的内容以及仍由托管服务提供的内容：docs/open-source.md。MIT © Unbrowse AI