Hyperbrowser Browser 代理工具

Hyperbrowser 是一个用于运行、运行浏览器代理和扩展无头浏览器的平台。它允许您大规模启动和管理浏览器会话，并为任何网络抓取需求提供易于使用的解决方案，例如抓取单个页面或抓取整个站点。

主要特点：

即时可扩展性 - 在几秒钟内启动数百个浏览器会话，而不会遇到基础设施问题
简单集成 - 与 Puppeteer 和 Playwright 等流行工具无缝协作
强大的 API - 易于使用的 API 用于抓取/抓取任何站点等等
绕过反僵尸程序措施 - 内置隐身模式、广告拦截、自动 CAPTCHA 解决和轮换代理

此笔记本提供了 Hyperbrowser 工具入门的快速概述。

有关 Hyperbrowser 的更多信息，请访问 Hyperbrowser 网站，或者如果您想查看文档，可以访问 Hyperbrowser 文档。

浏览器代理

Hyperbrowser 提供强大的浏览器代理工具，使 AI 模型能够以编程方式与 Web 浏览器交互。这些浏览器代理可以导航网站、填写表单、单击按钮、提取数据以及执行复杂的 Web 自动化任务。

浏览器代理特别适用于：

从复杂网站进行 Web 抓取和数据提取
自动执行重复的 Web 任务
与需要身份验证的 Web 应用程序交互
跨多个网站进行研究
测试 Web 应用程序

Hyperbrowser 提供三种类型的浏览器代理工具：

浏览器使用工具：通用的浏览器自动化工具
OpenAI CUA 工具：与 OpenAI 的计算机使用代理集成
Claude Computer Use Tool：与 Anthropic 的 Claude 集成以供计算机使用

概述

集成详细信息

工具	包	本地化	序列化	JS 支持
Browser Use Tool	langchain-hyperbrowser	❌	❌	❌
OpenAI CUA Tool	langchain-hyperbrowser	❌	❌	❌
Claude Computer Use Tool	langchain-hyperbrowser	❌	❌	❌

设置

要访问 Hyperbrowser 工具，您需要安装langchain-hyperbrowser集成包，并创建 Hyperbrowser 帐户并获取 API 密钥。

凭据

前往 Hyperbrowser 注册并生成 API 密钥。完成此作后，设置 HYPERBROWSER_API_KEY 环境变量：

export HYPERBROWSER_API_KEY=<your-api-key>

安装

安装 langchain-hyperbrowser。

%pip install -qU langchain-hyperbrowser

实例

浏览器使用工具

这HyperbrowserBrowserUseTool是一种使用浏览器代理（特别是 Browser-Use 代理）执行 Web 自动化任务的工具。

from langchain_hyperbrowser import HyperbrowserBrowserUseTool
tool = HyperbrowserBrowserUseTool()

OpenAI CUA 工具

这HyperbrowserOpenAICUATool是一种专用工具，它通过 Hyperbrowser 利用 OpenAI 的计算机使用代理（CUA）功能。

from langchain_hyperbrowser import HyperbrowserOpenAICUATool
tool = HyperbrowserOpenAICUATool()

Claude Computer 使用工具

这HyperbrowserClaudeComputerUseTool是一种专用工具，它通过 Hyperbrowser 利用 Claude 的计算机使用功能。

from langchain_hyperbrowser import HyperbrowserClaudeComputerUseTool
tool = HyperbrowserClaudeComputerUseTool()

调用

基本用法

浏览器使用工具

from langchain_hyperbrowser import HyperbrowserBrowserUseTool

tool = HyperbrowserBrowserUseTool()
result = tool.run({"task": "Go to Hacker News and summarize the top 5 posts right now"})
print(result)

{'data': 'The top 5 posts on Hacker News right now are:\n1. Stop Syncing Everything - https://sqlsync.dev/posts/stop-syncing-everything/\n2. Move fast, break things: A review of Abundance by Ezra Klein and Derek Thompson - https://networked.substack.com/p/move-fast-and-break-things\n3. DEDA – Tracking Dots Extraction, Decoding and Anonymisation Toolkit - https://github.com/dfd-tud/deda\n4. Electron band structure in germanium, my ass (2001) - https://pages.cs.wisc.edu/~kovar/hall.html\n5. Show HN: I vibecoded a 35k LoC recipe app - https://www.recipeninja.ai', 'error': None}

OpenAI CUA 工具

from langchain_hyperbrowser import HyperbrowserOpenAICUATool

tool = HyperbrowserOpenAICUATool()
result = tool.run(
    {"task": "Go to Hacker News and get me the title of the top 5 posts right now"}
)
print(result)

{'data': 'Here are the titles of the top 5 posts on Hacker News right now:\n\n1. "DEDA – Tracking Dots Extraction, Decoding and Anonymisation Toolkit"\n2. "A man powers home for eight years using a thousand old laptop batteries"\n3. "Electron band structure in Germanium, my ass"\n4. "Bletchley code breaker Betty Webb dies aged 101"\n5. "Show HN: Zig Topological Sort Library for Parallel Processing"', 'error': None}

Claude Computer 使用工具

from langchain_hyperbrowser import HyperbrowserClaudeComputerUseTool

tool = HyperbrowserClaudeComputerUseTool()
result = tool.run({"task": "Go to Hacker News and summarize the top 5 posts right now"})
print(result)

{'data': "Now I'll summarize the top 5 posts on Hacker News as of April 1, 2025:\n\n### Top 5 Hacker News Posts Summary\n\n1. **A man powers home for eight years using a thousand old laptop batteries** (techoreon.com)\n   - 267 points, posted 5 hours ago\n   - An innovative DIY project where someone managed to power their home using recycled laptop batteries for an extended period.\n\n2. **Electron band structure in germanium, my ass** (wisc.edu)\n   - 611 points, posted 8 hours ago\n   - Academic or technical discussion about electron band structure in germanium, possibly with a controversial or humorous take given the title.\n\n3. **Bletchley code breaker Betty Webb dies aged 101** (bbc.com)\n   - 575 points, posted 8 hours ago\n   - Obituary for Betty Webb, who worked as a code breaker at Bletchley Park during WWII, passing away at the age of 101.\n\n4. **Show HN: Zig Topological Sort Library for Parallel Processing** (github.com/williamw520)\n   - 55 points, posted 3 hours ago\n   - A developer sharing a library written in Zig programming language for topological sorting that supports parallel processing.\n\n5. **The Myst Graph: A New Perspective on Myst** (githr.com)\n   - 107 points, posted 5 hours ago\n   - An article presenting a new analysis or visualization of the classic video game Myst, likely using graph theory.\n\nThese are the top 5 posts currently trending on Hacker News as of April 1, 2025.", 'error': None}

使用自定义会话选项

所有工具都支持自定义会话选项：

result = tool.run(
    {
        "task": "Go to npmjs.com, and tell me when react package was last updated.",
        "session_options": {
            "session_options": {"use_proxy": True, "accept_cookies": True}
        },
    }
)
print(result)

{'data': 'I have found that the react package was last published 11 hours ago. This is the most recently updated package I could find.', 'error': None}

异步使用

所有工具都支持异步使用：

async def browse_website():
    tool = HyperbrowserBrowserUseTool()
    result = await tool.arun(
        {
            "task": "Go to npmjs.com, click the first visible package, and tell me when it was updated"
        }
    )
    return result


result = await browse_website()

{'data': 'The page displays information about the "Example Domain," stating that it is used for illustrative purposes and can be utilized without permission. There\'s a link to "More information..." but no specific contact details are provided.', 'error': None}

在代理内使用

以下是在代理中使用任何 Hyperbrowser 工具的方法：

from langchain.prompts import ChatPromptTemplate, MessagesPlaceholder
from langchain_hyperbrowser import browser_use_tool
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

llm = ChatOpenAI(temperature=0)

# You can use any of the three tools here
browser_use_tool = HyperbrowserBrowserUseTool()
agent = create_react_agent(llm, [browser_use_tool])

user_input = "Go to npmjs.com, and tell me when react package was last updated."
for step in agent.stream(
    {"messages": user_input},
    stream_mode="values",
):
    step["messages"][-1].pretty_print()

API 参考：ChatPromptTemplate | 消息占位符 | 聊天OpenAI | create_react_agent

================================[1m Human Message [0m=================================

Go to npmjs.com, and tell me when react package was last updated.
==================================[1m Ai Message [0m==================================
Tool Calls:
  hyperbrowser_browser_use (call_pkAaDjn6kKH9yT3rHDb4hmET)
 Call ID: call_pkAaDjn6kKH9yT3rHDb4hmET
  Args:
    task: Go to npmjs.com and find the last updated date of the React package.
    session_options: None
=================================[1m Tool Message [0m=================================
Name: hyperbrowser_browser_use

{"data": "The last updated date of the React package is a day ago.", "error": null}
==================================[1m Ai Message [0m==================================

The React package was last updated a day ago.

配置选项

Claude Computer Use、OpenAI CUA 和 Browser Use 具有以下可用的参数：

task：使用代理执行的任务
max_steps：座席完成任务可以采用的最大交互步骤数
session_options：浏览器会话配置

有关更多详细信息，请参阅相应的 API 参考：

API 参考

工具概念指南
工具操作指南

浏览器代理

概述

集成详细信息

设置

凭据

安装

实例

浏览器使用工具

OpenAI CUA 工具

Claude Computer 使用工具

调用

基本用法

浏览器使用工具

OpenAI CUA 工具

Claude Computer 使用工具

使用自定义会话选项

异步使用

在代理内使用

配置选项

API 参考

相关