SuperAPI AI 工具集

liftoff

通用与其它

查看项目

更新于 10-16 10:18

技能介绍

用途

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 失败。免费档仅验证结果计数。发布、购买、发送或删除操作需用户明确同意。