Browsernode

使 AI 能够操控你的浏览器 🤖 Browsernode 是 Browser-use 的 TypeScript 实现版本。

🌐 Browsernode 是连接你的 AI Agent 与浏览器的最简便方式。 ✅ Browsernode 完全兼容 Browser-use 的所有 API 和功能。

快速开始

请使用 Node.js (v20.19.4 或更高版本) 和 npm。

❌ 注意：Bun 环境目前存在 Playwright 相关的 Bug。

npm install browsernode

安装 Playwright： Installation | Playwright

npm init playwright@latest

playwright install chromium

将你所使用的 AI 提供商的 API Key 添加到 .env 文件中。

mv .env.example .env

OPENAI_API_KEY=

有关其他设置、模型及更多信息，请查看 官方文档 📕。

启动你的 Agent：

CommonJS 风格

const { Agent } = require("browsernode");
const { ChatOpenAI } = require("browsernode/llm");

(async () => {
  const llm = new ChatOpenAI({
    model: "gpt-4.1",
    temperature: 0.0,
    apiKey: process.env.OPENAI_API_KEY,
  });

  const task = "Search for the latest tesla stock price";
  const agent = new Agent({
    task,
    llm,
  });

  const history = await agent.run();
  console.log(history.usage);
})();

ESM 风格

package.json

{
  // ... other properties
  "type": "module"
  // ... other properties
}

import { Agent } from "browsernode";
import { ChatOpenAI } from "browsernode/llm";

const llm = new ChatOpenAI({
	model: "gpt-4.1",
	temperature: 0.0,
	apiKey: process.env.OPENAI_API_KEY,
});

const task = "Search for the latest tesla stock price";
const agent = new Agent({
	task: task,
	llm: llm,
});
agent.run();

运行：

npx tsx quickstart.ts

通过 UI 测试

你可以使用 gadio_demo 来测试 browsernode。

通过交互式 CLI 测试

你也可以使用我们的 browsernode-cli。

演示案例

任务：查找全球最有价值的公司，将前 5 家公司及其市值保存到 companies.txt 中。

输出结果：companies.txt

1. Microsoft: $3.530 T
2. NVIDIA: $3.462 T
3. Apple: $2.934 T
4. Amazon: $2.251 T
5. Alphabet (Google): $2.125 T

任务：在 Google Docs 中写一封给爸爸的信，感谢他所做的一切，并将文档保存为 PDF。

任务：前往 https://en.wikipedia.org/wiki/Banana，并通过点击维基百科页面上的按钮，以最快速度从“香蕉”页面跳转到“量子力学”页面。

结果：

// ... previous actions
🛠️ Action 1/1: {
  "clickElement": {
    "index": 41
  }
}
// ... more actions
 🛠️ Action 1/1: {
"done": {
    "success": false,
    "text": "I navigated through the Banana Wikipedia page, reaching the section on Fusarium wilt TR4. However, I did not complete the task of reaching Quantum mechanics."
  }
}
// ... final result
📄 Result: I navigated through the Banana Wikipedia page, reaching the section on Fusarium wilt TR4. However, I did not complete the task of reaching Quantum mechanics.

更多示例

查看 examples 文件夹获取更多示例。

贡献指南

我们欢迎各种贡献！如有 Bug 或功能需求，请随时提交 Issue。如需参与文档贡献，请查阅 /docs 文件夹。