Unbrowse

Unbrowse

公式 API や MCP がないウェブサイトも含め、すべてのウェブサイトはバックエンドとの通信にファーストパーティ API を利用しています。 Unbrowse はこれらのウェブサイトのファーストパーティ API を呼び出し、ブラウザーを使う場合と比べて、エージェントによるブラウジングを 50〜100 倍高速にし、コストを 95% 削減します。

これはホスト型 Unbrowse サービス （https://unbrowse.ai）向けのオープンソースクライアントです。REST API 用の TypeScript クライアント @unbrowse/sdk と、 それを基盤に構築された unbrowse CLI が含まれています。

エージェントスキルをインストールします：

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

エージェントを接続します：

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. 一度学習。 一致する機能がない場合、エージェントが Unbrowse の記録済みクラウドブラウザー（MCP）でタスクを実行するか、HAR 記録を 2 つアップロードします（unbrowse learn）。Unbrowse がリクエストをコンパイルし、1 回の呼び出しで使える機能を作成します。次回からは手順 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。

エージェント

エージェントはホスト型 MCP（https://unbrowse.ai/mcp。詳細は docs/install.md を参照）に接続し、skill/SKILL.md に従います。CLI は REST を使う代替手段です。unbrowse mcp は、stdio またはプレーンなツール名（unbrowse_scrape）が必要なホスト向けに、ホスト型 MCP へのローカル stdio プロキシを実行します。

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