用途
Liftoff 工具集是 Unbrowse 为 liftoff.ai 编译的一套面向智能体的工具作用域。它让智能体能够搜索 liftoff.ai、读取该站点上的页面,并通过 Unbrowse 作用域内的 MCP 进行调用。该工具为非官方,未获得 liftoff.ai 的隶属或背书。
主要能力
该服务基于 liftoff.ai 自身的第一方请求编译而成:每次调用会在服务端重放站点的第一方 API 请求,并返回经验证的结果。无需抓取渲染后的页面,用户端无需浏览器,也不需要 liftoff.ai 的 API 密钥。
核心工具包括:
-
liftoff_ai__get_search — 使用 liftoff.ai 自身的搜索(首页搜索表单)搜索该站点,并以标题、文本和链接的形式读取结果页。单次第一方 HTTP 请求,无需浏览器。输入参数为 query(字符串,必填),返回结果页的标题、可读文本和链接。对 liftoff.ai 为只读操作。
-
liftoff_ai__read_page — 读取 liftoff.ai 上的任意页面,路径形式如 /news/2026/some-story,或完整的 liftoff.ai URL,并获取其标题、可读文本和链接。单次第一方 HTTP 请求,无需浏览器。可通过将返回链接的 href 作为路径传回以继续跟随链接。输入参数为 path(字符串,必填),例如以 "/" 表示的路径或站点上的完整 URL。返回该页面的标题、可读文本和链接。对 liftoff.ai 为只读操作。
此外还始终提供:unbrowse.run(用自然语言描述在 liftoff.ai 上的任务)、unbrowse.inspect、unbrowse.resume、unbrowse.scrape 和 unbrowse.map(liftoff.ai 上任意页面),以及记录的云端浏览器 unbrowse.browse.open → unbrowse.browse.act → unbrowse.browse.finish。对于拒绝带点名称的主机,这些工具会以 _ 显示(如 unbrowse_run)。
使用方式
连接 liftoff.ai MCP:
claude mcp add --transport http liftoff https://unbrowse.ai/mcp/liftoff.ai
codex mcp add liftoff --url https://unbrowse.ai/mcp/liftoff.ai && codex mcp login liftoff
MCP 配置:
{"mcpServers":{"liftoff":{"url":"https://unbrowse.ai/mcp/liftoff.ai"}}}
该服务器是一个仅包含 liftoff.ai 的工具作用域:其中的编译工具加上运行它们的 Unbrowse 工具,因此智能体的工具列表保持精简,每次调用都停留在 liftoff.ai 上。
首次连接会通过 OAuth 登录 Unbrowse(免费档,仅验证结果计数)。对于脚本,发送 Authorization: Bearer $UNBROWSE_API_KEY 请求头(密钥来自 https://unbrowse.ai/app/keys;请保存在密钥管理器中,切勿放在会提交的配置里)。
如果本会话的工具列表中不包含上述任何工具,说明服务器未连接或未登录:应如实说明并停止,不要以其他方式获取 liftoff.ai 并将其作为该技能的结果呈现。
调用方式:选择标题与任务匹配的工具并传入其输入。除非用户明确要求,否则不要传入站点记录的参数。
读取状态:succeeded 携带经验证的结果。input_required 并非失败:用 unbrowse.resume {runId, answers} 在同一运行中回答未填字段。
没有合适的工具时:使用 unbrowse.run {task}。当尚无对应编译能力时,它会以 no_capability 失败:可先用 unbrowse.browse.open 打开 liftoff.ai → unbrowse.browse.act → unbrowse.browse.finish 执行一次,这会编译出一个新工具,该服务器下次便会列出。任何离开 liftoff.ai 范围的操作会在此被拒绝(not_in_scope):请改用通用 Unbrowse 服务器。
登录:切勿向用户索要密码。unbrowse.browse.act 使用 action: "autofill",会从其 Unbrowse 密码管理器填充 liftoff.ai 的登录。
仅报告 succeeded 结果所述内容。outcome_unknown 表示可能已发生更改:重试前请先检查。发布、购买、发送或删除操作需要用户同意。
不使用 MCP 时
每个工具同时也是 REST 调用:
curl -s https://unbrowse.ai/api/v1/sites/liftoff.ai/call/liftoff_ai__get_search \
-H "authorization: Bearer $UNBROWSE_API_KEY" -H "content-type: application/json" \
-d '{"query":"mobile"}'
OpenAPI:https://unbrowse.ai/api/v1/sites/liftoff.ai/openapi.json。其他站点请使用通用 Unbrowse 技能(https://github.com/unbrowse-ai/unbrowse)和 https://unbrowse.ai/mcp。
适用场景
适用于希望让智能体在 liftoff.ai 上执行搜索或页面读取任务的场景,且保持在 liftoff.ai 范围内运行。
限制
该工具为非官方,与 liftoff.ai 无隶属或背书关系。操作范围限定于 liftoff.ai;超出该范围的操作会被拒绝(not_in_scope),需改用通用 Unbrowse 服务器。若某能力尚未编译,unbrowse.run 会以 no_capability 失败。免费档仅验证结果计数。发布、购买、发送或删除操作需用户明确同意。