SuperAPI AI 工具集

unbrowse

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

Unbrowse 是托管在 https://v3.unbrowse.ai 的网站调用服务,执行过程、已索引路由与网站会话都保留在服务端。该技能只提供操作指引,不负责用户认证,也不启动本地 MCP 服务器。

接入方式:智能体优先使用远程 MCP,可执行 claude mcp add --transport http unbrowse https://v3.unbrowse.ai/mcp,并通过 MCP 客户端的 OAuth 流程完成登录;其他客户端可使用 {"mcpServers":{"unbrowse":{"url":"https://v3.unbrowse.ai/mcp"}}}。CLI 与 SDK 说明见 https://github.com/unbrowse-ai/unbrowse-skill#readme,应使用其中指定的客户端版本,较旧的 npm 版本可能指向不同服务。自动化场景通过 UNBROWSE_API_KEY 提供 API 密钥,密钥应放在调用方的密钥管理器中,不要写入提交的配置、提示词、命令参数或日志;密钥可在 https://v3.unbrowse.ai/app 的已登录控制台创建。

接口选择:MCP 支持发现、运行、读页、云浏览、保存登录请求和实时画布卡片;CLI 提供 discover、run、inspect、resume、registry 等命令,unbrowse install 可打印 MCP 配置,unbrowse help 描述已安装版本;SDK 用于 REST 集成与脚本。references/tools.json 含导出的核心 MCP 输入模式,但已连接服务器的 tools/list 才是权威依据,还会包含本工作区的动态工具,不得虚构能力 ID 或输入模式。

执行任务时先用 unbrowse.discover 查询,检查返回的输入、选项与提示,优先选择健康匹配的能力(warm 表示 HTTP 回放,rendered 表示需要渲染),必要时用 unbrowse.sites 查看保存的会话与登录状态。按工具模式调用,或使用 unbrowse.run{capability, input};同一预期变更应使用稳定的 idempotencyKey。检查返回状态与实际结果,input_required 表示需要在该次运行中回答,用 unbrowse.resume{runId, answers:{field:value}} 继续;选择项要传所列选项的值,并保留给定的 revision 校验。no_capability 表示没有可复用路由,若可浏览则通过 unbrowse.browse.* 完成任务并在结束时学习。

只有基于已验证结果才能报告完成;outcome_unknown 表示可能已发生变更,重试前先检查效果回执与目标。取消只停止后续派发,不会撤销已完成的效果。不得从 HTTP 200、工具传输成功、截图或生成的计划推断业务成功,也不要承诺普遍覆盖或首次请求即无浏览器执行。发布、发送、购买等外部写入必须获得用户授权。

读页可用 unbrowse.scrape{url},找同站页面用 unbrowse.map{url}。无匹配路由时用 unbrowse.browse.open{url,task} 获取页面与元素引用,再用 browse.act 配合最新引用操作,普通输入应带日期、查询等有意义的名称,并覆盖任务所需的所有筛选条件,页面变化后刷新快照。用 browse.finish{sessionId} 返回最终页面并编译观察到的路由;两个不同输入的会话有助于识别可复用参数。检查 learnError 与 newTool,浏览成功本身不代表存在可复用路由。完成后关闭会话,browse.close 除非 discard:true 否则仍会建立索引。已有的 HAR 对可通过 unbrowse.learn 提交,但只能提交用户授权的记录,且 HAR 可能含隐私数据;托管服务会拒绝私有与回环目标。

网站登录与 Unbrowse 账号登录相互独立,绝不要在对话中索要密码或通过普通工具参数输入凭据。在登录页使用 browse.act{sessionId,action:"autofill"},或在填充动作上用 vault:"username"|"email"|"password"|"totp",值会从保险库直接送到网站。缺少登录时,展示返回的 signIn.url 或 details.url 保存登录链接;unbrowse.credentials.request 可创建链接,credentials.status 检查是否已完成,就绪后再恢复。不得绕过 CAPTCHA、多因素认证或人机验证,应展示支持的交还流程或如实报告受阻。已保存会话会复用,不必因新任务重新登录。只读且无密钥的学习路由可能被清理并共享到公共注册表,所有者可在控制台选择退出;登录、私有会话值和写入不会成为公开工具定义。

当列出 unbrowse.canvas.read 与 .put 时,它们连接同一已登录工作区的 https://v3.unbrowse.ai/app/canvas。静态文本用 notes 与 plans,源数据用 results,拟议回复用 drafts,子卡片用 parentId 从结果展开。更新前读取当前卡片版本,提供 expectedRevision 并保留人工编辑;事实性主张旁放来源链接,拟议文本标注为草稿。canvas.put 只创建卡片,不对外发送;准备回复草稿不等于授权发布,发送需在画布界面单独审核。

限制与恢复:401 应重新连接 Unbrowse 或更换调用方过期密钥;配额或支付错误应展示返回限额与控制台链接,不要盲目重试支付,列出的 unbrowse.credits 可显示免费/付费余额并返回结账链接,打开账单链接不构成支付授权;验证或登录受阻时使用返回的交还流程,不要把验证页当作源内容;写入超时先检查既有运行再重试。定价与配额以账户当前计划和 unbrowse.usage 为准,本技能不固定价格。