browser-use について
browser-use は、Web タスクを自動化するオープンソースのブラウザーエージェントです。Python ライブラリ、CLI、ホステッドサービスとして利用でき、ローカルまたはクラウドのブラウザーで実行できます。
主な機能
- 01Python と TypeScript のブラウザーエージェント
- 02ブラウザータスクを自動化する CLI
- 03ローカルまたはクラウドブラウザーへの接続
- 04クラウドのステルスブラウザーとプロキシ
- 05CAPTCHA 対応と実行記録
活用シーン
- 01フォーム入力と予約枠の確保
- 02Web ページの閲覧と情報抽出
- 03既存エージェントへのブラウザー操作追加
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.browser-use.com/v3/mcpclaude mcp add --transport http com-browser-use-browser-use https://api.browser-use.com/v3/mcp{"mcpServers":{"com-browser-use-browser-use":{"type":"http","url":"https://api.browser-use.com/v3/mcp"}}}Cursor で開く{"servers":{"com-browser-use-browser-use":{"type":"http","url":"https://api.browser-use.com/v3/mcp"}}}VS Code で開く{"mcpServers":{"com-browser-use-browser-use":{"type":"http","url":"https://api.browser-use.com/v3/mcp"}}}{"mcpServers":{"com-browser-use-browser-use":{"serverUrl":"https://api.browser-use.com/v3/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://api.browser-use.com/v3/mcp認証が必要ツール
2| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| code | string | はい | 実行する Python コード |
詳細
翻訳後に原文が更新されています。最新の内容は原文をご確認ください。
オープンソースのブラウザーエージェントです。任意のLLMを使ってローカルで実行するか、Browser Use Cloudで実行できます。ステルスブラウザーは1時間あたり$0.02から利用でき、Stealth Bench V2で最高スコア(90.5%)を獲得しています。
人間のようにウェブを操作しましょう。
空き枠を見つけ、日付と時刻を選び、CAPTCHAに対処して、運転免許試験を予約します。
AIエージェントとクローラーの皆様へ: 製品マップ(オープンソース、Browser Harness、Cloudブラウザー、Agents API、料金)についてはbrowser-use.com/llms.txtを、ドキュメントのインデックスについてはdocs.browser-use.com/llms.txtをご覧ください。Browser Useはオープンソースのブラウザーエージェント(PythonおよびTypeScript)であり、ステルス機能、CAPTCHA解決、住宅用プロキシを備えたブラウザーを1時間あたり$0.02で利用できるクラウドブラウザーと、ホスト型エージェントAPIを提供しています。
どの Browser Use を使えばよいですか?
- パス 1:完全ホスト型クラウド: ホスト型エージェントとブラウザーを使って規模を拡大できます。
- パス 2:CLI: 独自のブラウザータスクを自動化できます。
- パス 3:Python ライブラリ: オープンソースの Browser Use エージェントを、独自のコードからローカルで実行できます。
クイックスタート
パス 1:完全ホスト型クラウド
ホスト型エージェント、ステルスブラウザー、プロファイル、録画、データポリシー向けのインフラストラクチャを使って、ブラウザーの自動化を拡張できます。
Google、GitHub、Microsoft で新規登録すると、1 ドル分のクラウドクレジットを利用できます。
パス 2:CLI
このプロンプトを Claude Code、Codex、Hermes、OpenClaw、またはお好みのエージェントに貼り付けてください。
Install or upgrade browser-use to the latest stable version with uv using Python 3.12, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md.
パス 3:Python ライブラリ
モデルとローカルまたはクラウドブラウザーを自由に選択して、Browser Use エージェントを Python からローカルで実行できます。
1. Browser Use をインストールします(Python >= 3.11):
uv をインストールした状態で、新しいプロジェクトを始める場合は、まず uv init --python 3.12 を実行してください。
uv add browser-use
2. OpenAI API キーを .env に追加します:
# .env
OPENAI_API_KEY=your-key
# BROWSER_USE_API_KEY=your-key # Optional: BU2 model or cloud browser
Browser Use のオプションサービスを利用する場合は、Browser Use API キーを取得してください。
3. 次の内容を agent.py として保存します:
import asyncio
from browser_use import Agent, Browser, ChatBrowserUse, ChatOpenAI
from dotenv import load_dotenv
load_dotenv()
async def main():
llm = ChatOpenAI(model='gpt-5.6-luna', reasoning_effort='xhigh')
# llm = ChatBrowserUse(model='bu-2-0') # Use BU2 instead; requires BROWSER_USE_API_KEY
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=llm,
# browser=Browser(use_cloud=True), # Use a cloud browser; requires BROWSER_USE_API_KEY
)
history = await agent.run()
print(history.final_result())
if __name__ == "__main__":
asyncio.run(main())
BU2 を使用するには、ChatOpenAI の行をコメントアウトされている ChatBrowserUse の行に置き換えてください。クラウドブラウザーのオプションはどちらのモデルでも動作します。
4. 実行します:
uv run agent.py
エージェントがブラウザーを開いてリポジトリを検索し、回答を出力します。
5. 同じエージェントをクラウドブラウザーで実行します(Chrome のインストールは不要です。Docker、CI、サーバーレス環境で動作します):
BROWSER_USE_API_KEY を設定し(キーを取得)、agent.py の browser= 行のコメントを解除して、再度実行します。
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=llm,
browser=Browser(use_cloud=True),
)
クラウドブラウザーの料金は、ブラウザー 1 時間あたり 0.02 ドルにネットワークトラフィック料金を加えた金額です(料金)。さらに、ステルス機能、レジデンシャルプロキシ、CAPTCHA の解決、ライブビュー URL が利用できます。コードはそのままで、ほかに変更は必要ありません。
# Claude 向け Browser Use ツールセット
Browser Use がメンテナンスしています。Claude と互換性があります。
Browser Use をドライバーとして、Claude のブラウザツールセットを使用します。Browser Use は 31 種類すべてのブラウザー操作を実装しており、ローカルブラウザー、Browser Use Cloud ブラウザー、または CDP 経由で既存のリモートブラウザーを操作できます。 Browser Use の統合には、データの処理やファイルの書き込みに使える Bash が含まれています。
anthropic.tools.browser を含むバージョンの Anthropic SDK が必要です。
Bash を使用するには、/bin/bash を備えた Linux または macOS のホストが必要です。Windows では WSL を使用してください。
以下のスニペットは非同期関数内で実行されます。完全なスクリプトについてはクイックスタートをご覧ください。
import os
from anthropic import AsyncAnthropic
from browser_use.integrations.toolsets_for_claude import Bash, BrowserUse
task = 'Open example.com and report its page title.'
driver = BrowserUse() # Or BrowserUse(use_cloud=True)
bash = Bash(output_dir='outputs')
async with driver, AsyncAnthropic() as client:
runner = client.beta.messages.tool_runner(
model=os.environ['ANTHROPIC_MODEL'],
max_tokens=32_768,
max_iterations=100,
tools=[driver, bash],
messages=[{'role': 'user', 'content': task}],
)
result = await runner.until_done()
Browser Use Benchmark v2
この非常に難易度の高いベンチマークは、最も難しいブラウザータスクを対象としています。より簡単なタスクでは、小規模なモデルでも非常に高い成功率を達成できます。表示されている結果は、BU Bench V2 の 60 タスクのサブセットによるものです。
統合、ホスティング、カスタムツール、MCP などについては、ドキュメント ↗をご覧ください
よくある質問
フルマネージドのクラウド、CLI、Python ライブラリのうち、どれを使うべきですか?
- フルマネージドクラウド: API 経由でタスクを送信すると、Browser Use がエージェント、ブラウザー、インフラストラクチャを実行します。
- CLI: 既存のエージェント(Claude Code、Codex、Hermes、OpenClaw、Pi、Cursor など)にブラウザーへのアクセスを提供します。対話形式でもスクリプトでも使用できます。
- Python ライブラリ: カスタムツール、構造化出力、お好みのモデルを使って、オープンソースのエージェントをご自身のアプリケーションで実行します。
CLI と Python ライブラリは、それぞれローカルブラウザーまたはクラウドブラウザーに接続できます。クラウドブラウザーはブラウザーをホストし、フルマネージド API はエージェントも実行します。
おすすめのモデルは何ですか?
ブラウザー自動化向けに最適化したモデル、BU2 をおすすめします。ChatBrowserUse(model='bu-2-0') を使用してください。BROWSER_USE_API_KEY を使います。現在、ChatBrowserUse() でも同じモデルが選択されます。
最適な選択肢は、タスク、レイテンシー、予算によって異なります。選択肢を比較するには、BU2 モデルカード、ベンチマーク、対応モデルと料金をご覧ください。
ChatBrowserUse で Claude/GPT/Gemini を使えますか?
はい。ChatBrowserUse は、BROWSER_USE_API_KEY を使用して Browser Use ゲートウェイ経由で、プロバイダー名を接頭辞に含むモデル ID を受け付けます。
from browser_use import Agent, ChatBrowserUse
llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6') # or 'google/gemini-3-pro'
agent = Agent(task='...', llm=llm)
ChatOpenAI、ChatAnthropic、ChatGoogle などのラッパーを通じて、各プロバイダーの API キーを使い、プロバイダーに直接接続することもできます。対応モデルをご覧ください。
システムプロンプトを指定する必要がありますか?
いいえ。モデルを変更した場合も含め、`Agent(...)` が Browser Use のシステムプロンプトを自動的に設定します。タスクは `task=` に指定してください。追加の指示を加えるには `extend_system_message` を、カスタムの動作が必要でデフォルトのプロンプトを置き換えるには `override_system_message` を使用します。カスタムシステムプロンプトの例をご覧ください。
エージェントでカスタムツールを使用できますか?
はい。Tools に関数を登録して、エージェントに渡してください。この例では、現在の UTC 時刻を取得するツールを追加し、.env の BROWSER_USE_API_KEY を使用します。
import asyncio
from datetime import datetime, timezone
from browser_use import ActionResult, Agent, ChatBrowserUse, Tools
from dotenv import load_dotenv
load_dotenv()
tools = Tools()
@tools.action(description='Get the current date and time in UTC.')
def get_current_time() -> ActionResult:
return ActionResult(extracted_content=datetime.now(timezone.utc).isoformat())
async def main():
agent = Agent(
task="What is the current UTC time?",
llm=ChatBrowserUse(model='bu-2-0'),
tools=tools,
)
history = await agent.run()
print(history.final_result())
if __name__ == "__main__":
asyncio.run(main())
無料で使用できますか?
Python ライブラリは無料で、MIT ライセンスの下で公開されています。モデルの推論とホスト型ブラウザーは別途費用がかかります。ChatBrowserUse を含む API プロバイダーと Browser Use Cloud は、使用量に応じて料金が発生します。また、ハードウェアとモデルの要件を満たしていれば、Ollama を介してローカルブラウザーとローカルモデルを使用することもできます。
利用規約
このオープンソースライブラリは、MIT ライセンスの下で公開されています。Browser Use のサービスとデータに関するポリシーについては、利用規約とプライバシーポリシーをご覧ください。
認証を処理するにはどうすればよいですか?
- ローカルブラウザー:
Browser.from_system_chrome()を使用して、Chrome プロファイルを再利用します。実ブラウザーガイドと例をご覧ください。 - クラウドブラウザー: プロファイル同期ガイドに従ってから、
Browser(use_cloud=True, cloud_profile_id='your-profile-id')を使用します。
プロファイル同期で転送されるのは Cookie であり、ローカルストレージ、IndexedDB、拡張機能は転送されません。サイトによっては、再度サインインが必要になる場合があります。
CAPTCHA を解決するにはどうすればよいですか?
Browser Use Cloud では、ボット検出や CAPTCHA の発生を抑えるよう設計されたステルスブラウザーとプロキシを提供しています。Python ライブラリでは、Browser(use_cloud=True) でクラウドブラウザーを有効にし、BROWSER_USE_API_KEY を設定してください。
結果はサイトやチャレンジによって異なります。すべての CAPTCHA の回避または解決を保証するブラウザー設定はありません。
本番環境に移行するにはどうすればよいですか?
管理する範囲を選択してください。
- エージェントコードをそのまま使用する: CLI または Python ライブラリをクラウドブラウザーに接続すると、管理されたブラウザーインフラストラクチャ、ステルス機能、プロファイル、録画を利用できます。
- エージェントの実行も任せる: フルマネージドの Cloud API を使用して、タスクを送信し、結果を取得します。
Python ライブラリとブラウザーを独自のインフラストラクチャでホストすることもできます。
## 関連リポジトリ
| リポジトリ | 用途 |
|---|---|
| Browser Harness | AI エージェントがブラウザーを操作できるようにする CLI です。 |
| Browser Harness JS | JavaScript エージェントが実際のブラウザーを操作できるようにします。 |
| Browser Use Pi | Pi を基盤とする TypeScript 製のブラウザーエージェントを実行します。 |
| Cloud SDK | Browser Use Cloud をアプリケーションに統合します。 |
| Video Use | コーディングエージェントで動画を編集します。 |
| macOS Harness | エージェントが Mac アプリ、ブラウザー、ファイルを操作できるようにします。 |
| Benchmark | ブラウザーのタスクを調べ、エージェントの性能を比較します。 |
引用
Browser Use を研究やプロジェクトで使用する場合は、次のように引用してください。
@software{browser_use2024,
author = {Müller, Magnus and Žunič, Gregor},
title = {Browser Use: Enable AI to control your browser},
year = {2024},
publisher = {GitHub},
url = {https://github.com/browser-use/browser-use}
}
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。