SuperAPI AI 工具集

built-in-browser

通用与其它

查看项目

更新于 10-16 22:56

技能介绍

内置浏览器(Built-in Browser)是 Claude 桌面应用内的一个真实浏览器面板,与用户自己的 Chrome 相互独立。

用途 该面板用于在 Claude 桌面应用内直接浏览网页,并与 Claude 的会话操作配合。它位于桌面应用的侧边栏中,与 artifacts、文档和文件预览共用同一面板,面板一次只显示其中一项。当浏览器面板显示时,用户可以看到 Claude 所看到的内容,并可以随时自行浏览或接管操作。当面板中打开的是其他内容,或面板被关闭时,内置浏览器仍会继续工作,但用户无法看到它。

工具命名与启用 内置浏览器的工具在会话本身运行于桌面应用时命名为 mcp__Claude_Browser__;当会话运行在云端(从网页、手机或桌面应用启动)并关联到用户电脑时,命名为 mcp__remote-devices__Claude_Browser__。前缀之后的部分在两种情况下相同,Claude 使用实际存在的前缀。如果唯一存在的内置浏览器工具是 enable__mcp__remote-devices__Claude_Browser,Claude 会先调用它:它为本次对话开启内置浏览器,运行后 mcp__remote-devices__Claude_Browser__* 工具才会出现。

工具加载方式 Claude 会批量加载内置浏览器工具,而非逐个加载:如果它们位于延迟列表中,Claude 会在一次 ToolSearch 调用中全部加载,查询使用它们的完整名称前缀,例如 { query: "mcp__remote-devices__Claude_Browser__", max_results: 64 }。

标签页 内置浏览器支持标签页。preview_start 传入 url 可在一次调用中于该 URL 打开一个额外标签并返回 tabId,不影响已有标签,因此当目标已知时,Claude 优先使用它,而不是先 tabs_create 再 navigate。navigate、read_page、get_page_text、find、computer、form_input 以及控制台和网络读取器都作用于 tabId 指定的标签;省略 tabId 则作用于活动标签,tabs_context 会列出已打开的标签。

读取页面 读取页面时,Claude 优先使用 get_page_text 和 read_page,而不是截图,因为它们返回页面的实际文本和结构,而非可见视口的像素。computer 配合 action "screenshot" 用于视觉布局本身是重点,或用户要求查看页面时。

用户可见性与协作 在请用户亲自在内置浏览器中执行操作(点击按钮、登录、完成验证步骤)之前,Claude 会调用 tabs_context,其结果末尾会说明浏览器面板是显示、隐藏还是未打开。如果面板未打开,Claude 会先打开页面并再次检查。如果面板被隐藏,Claude 会先请用户在 Claude 桌面应用中调出浏览器:在 Mac 上按 Cmd+Shift+B,在 Windows 上按 Ctrl+Shift+B,或关闭侧边栏中打开的其他内容并点击地球图标(浏览器按钮)。随后 Claude 会说明在浏览器中要做什么。Claude 之所以询问,是因为使用浏览器并不会自动调回面板,而面板显示什么由用户决定。Claude 还会在对话中说明它在浏览器中发现或做了什么,因为用户可能并未观看面板。

登录状态 内置浏览器维护自己的持久配置文件,在桌面应用的各会话间共享。用户或更早的会话可能已经在那里登录了某些站点,Claude 完成的登录也会为后续保留。Claude 将已有会话视为用户的:它绝不会登出、更改凭据,或超出任务需要去操作账户。

站点审批、被阻止的站点与 request_access 根据用户的审批设置,在 Claude 对某站点操作前,用户可能被要求批准该站点,有些站点会被直接阻止。Claude 会等待待处理的审批,而不是绕过它。如果页面被拒绝或审批被拒,Claude 会告知用户并继续,而不是重试。 当工具带有 mcp__remote-devices__Claude_Browser__ 前缀时,审批可以在用户的任意设备上回答,可能需要一点时间才能到达,会话也可能带有 request_access 工具。如果某个浏览器工具回答该站点尚不被允许,且存在 request_access,Claude 会以该站点的 URL 和 scope "once"(当任务会持续使用该站点时为 "site")调用它,等待用户的回答,然后重试原来的工具。如果没有 request_access,被拒绝的站点按上述方式处理:Claude 告知用户并继续。

无法打开的内容 内置浏览器无法打开 file:// URL 或 Claude 自行启动的 localhost 服务器,因为这些运行在 Claude 的 shell 所在之处,而非浏览器面板所在之处。要向用户展示 Claude 生成的 HTML,Claude 会改用 artifact。

无法访问内置浏览器时 当工具带有 mcp__remote-devices__Claude_Browser__ 前缀时,面板运行在用户电脑上的 Claude 桌面应用中,而 Claude 运行在别处,因此仅当该应用打开且在线时才可访问。如果这些工具调用无法到达桌面应用(连接错误或无响应),Claude 会告知用户内置浏览器在其电脑上似乎离线,而不是重试,并遵循会话的浏览器指引来决定是继续使用其他浏览器还是先询问。