fastbrowse：带页面引用的 AI 浏览器自动化工具

fastbrowse 是一款开源的 AI 浏览器自动化工具，让智能体按照自然语言任务阅读网页、点击控件、填写字段并检查结果。它面向开发者和智能体构建者，既提供命令行与 SDK，也能通过 MCP 或托管 API 接入现有工作流。它特别强调结果证据：答案附带页面原文引用，任务是否完成还要经过检查。

通俗理解：这个网站到底是干什么用的？

可以把 fastbrowse 理解为给 AI 配上的一套“操作浏览器的手”和“核对结果的笔记”。你告诉它要在什么网站完成什么任务，它根据页面上真实存在的按钮、链接和输入框选择下一步，再读取操作后的页面。比如查找软件包版本、收集商品信息，或在获得授权的测试网站上完成表单流程。

官网是这套工具的说明和使用入口，同时提供独立的云端托管服务。自行运行需要配置模型密钥和浏览器；接入托管版则由服务方管理浏览器。因此，选择它之前，应先判断自己需要的是可嵌入项目的浏览器智能体，还是云端执行接口。

从网页操作到可核验的答案

fastbrowse 会把页面控件编成索引，由 Jev 选择操作和目标，大语言模型负责规划任务和阅读较长内容。每次行动后重新观察页面，尽量避免只凭上一屏的印象继续操作。

• 查找和整理网页信息：把任务范围、目标字段和起始网址说清楚，再检查返回的引用是否支持答案。
• 执行多步骤流程：处理点击、输入和导航，并依据页面状态核实要求的动作是否完成。付款、发送或删除等操作涉及授权判断。
• 提取应用可用的数据：Python 和 JavaScript SDK 支持按 schema 校验输出，适合把结果交给后续程序。字段类型通过校验，仍需核对数据对应的来源与任务范围。
• 定位失败原因：查看运行状态、步骤、模型调用和费用，区分没有完成、证据不足与资源限制。

complete 才表示工具通过了完成检查；unverified 表示证据仍不足。引用能帮助复核，但网页本身可能过期或不准确，不能把“有引用”等同于事实永远正确。

如何完成第一次本地浏览任务

按照官方首次运行指南，准备 uv、Chrome 或 Chromium，以及 OpenRouter API 密钥。uv 会按需要获取 Python 运行环境。先从只读任务开始，例如读取一个公开网页的标题。

1. 在运行环境中配置 OPENROUTER_API_KEY，不要把真实密钥写进任务文本。
2. 运行下面的命令，用 --start 指定页面，--local 选择本机浏览器，--json 保留完整结果。
3. 先检查状态，再检查答案引用、步骤和费用；确认页面内容确实对应你的任务。
4. 若停在登录页、验证码或预算限制，先处理具体原因，再决定是否重试。

uvx fastbrowse "读取当前头条的标题，并附上页面引用" --start https://news.ycombinator.com/ --local --json

模型调用可能收费。正式接入时，应按文档设置步骤、模型费用和运行时长等上限；单独限制步骤或美元预算不能替代总时长限制。

本地、云端与 MCP：选择合适的接入方式

本地 Chrome 适合在自己的环境调试；Browser Use Cloud 是另一种云浏览器选择，需要相应密钥；CDP 可连接已经运行的浏览器。已登录的浏览器配置文件可以复用，但也意味着任务可能接触该会话有权限看到的内容。

Python SDK 可调用 run_task；JavaScript/TypeScript SDK 要求 Node.js 20 或更新版本，无需额外安装 Python。fastbrowse-mcp 向 MCP 客户端提供 browse 工具，服务端可以设定权限和资源上限。官方还提供智能体技能，但安装技能仅添加使用说明，仍需配置密钥和浏览器。

托管版通过 POST /v1/runs 接收任务，由服务方维护浏览器、模型连接和队列。测试密钥运行的是模拟器，不会真的访问网站，适合验证集成的请求与响应，不能据此证明真实网页任务已经成功。

免费额度、付费套餐与实际运行成本

以下为 2026 年 11 月 1 日核实的官网美元月付标价，未含适用税费，以官方定价与限制及结账页面为准。

• 开源自行运行：代码采用 MIT 许可，仍需承担所选模型 API 与可选云浏览器的费用。
• Free：无需信用卡，每月 2 美元运行额度，1 个并发任务，历史保留 7 天；每月最多 500 次运行，包含充值后的运行。2 美元按每次最低 0.005 美元计算，理论上最多覆盖 400 次，实际次数还取决于每次用量。
• Starter：29 美元/月，含 35 美元运行额度，5 个并发任务，历史保留 30 天。
• Pro：199 美元/月，含 250 美元运行额度，25 个并发任务，历史保留 90 天。
• Scale：999 美元/月，含 1,400 美元运行额度，100 个并发任务，历史保留 180 天。
• Enterprise：按协议报价，浏览器资源、保留期和数据驻留条件另行约定。

托管任务按“单次运行费用加用量”计费，每次最低 0.005 美元。月度额度不结转，购买的充值额度不设到期日。被登录、验证码或确认步骤阻挡的运行，也可能因已经执行的工作收费；平台错误、提供商不可用、取消、排队过期和测试密钥运行不计费。因此，不能把免费套餐、额度上限或任务成功率互相混为一谈。

登录凭据、隐私与使用边界

凭据按名称引用，只在允许的网站来源中输入，模型看到的是名称而非密码值。工具支持复用登录配置文件，以及通过已解锁的 Bitwarden CLI 使用保存的登录信息。托管版存储的 secret 采用加密和来源范围约束。

这并不意味着网页数据完全留在本地。官方隐私政策明确说明，执行任务所需的任务文本和页面内容会发送给模型提供商。托管运行记录按套餐历史窗口保留；本地浏览器运行也不能直接解释为模型完全离线。

对被识别为不可逆的操作，未授权时会停在 needs_confirmation；官方同时提醒分类器可能漏判。涉及真实业务提交时，仍应明确允许操作的范围并复核结果。验证码和登录限制也可能阻断任务，工具没有保证所有网站都能自动完成。

常见问题

fastbrowse 可以免费使用吗？

开源代码可以按 MIT 许可使用，但模型和云浏览器可能产生费用。托管 Free 只有有限的月度运行额度，也受到并发、历史和次数上限约束。

需要把网站密码直接告诉 AI 吗？

官方路径是使用来源受限的 secret、浏览器登录配置文件或支持的密码库，让模型引用凭据名称。网页中其他业务内容仍可能为完成任务而发送给模型，应分别评估。

遇到验证码或任务没有完成怎么办？

blocked 通常表示未通过的网站机器人检查，needs_login 表示登录条件未满足，budget_exceeded 表示资源或费用约束触发。读取具体状态后再调整登录方式、任务范围或预算，不要把非 complete 的运行当作已完成。

官方资源与开发者入口

• 使用文档与集成指南：查阅 CLI、SDK、MCP 和模型配置。
• GitHub 源码与问题反馈：核查 MIT 许可、实现和已知问题。
• 服务健康检查与故障报告说明：了解检查接口，并按运行 ID 和错误码反馈。该页尚不提供公开事故流或实时可用率。