10 分钟上手 API Anything:快速安装并调用第一个网站 API 的完整步骤

原创2026-10-19 10:26:521,931 阅读

10 分钟上手 API Anything:快速安装并调用第一个网站 API 的完整步骤

API Anything 是一个把任意网站变成 AI agent 可直接调用的 API 的本地工具。装好一条 api-anything 命令后,你不再需要让 agent 逐页点击浏览器,而是直接拿到网站返回的 JSON。接下来的 10 分钟,你将完成环境检查、快速安装、调用第一个网站 API,并把整套能力接入你的 AI 编码助手。

它是什么:一次教学,之后像 API 一样调用网站

API Anything 的核心思路只有三句话:

  • 🧠 向网站自己学习:观察页面前端发出的真实请求,把其中随输入变化的部分自动变成参数
  • 🔁 自我修复:网站改版导致调用失败时,自动重新学习,且回放验证成功才保存新版本
  • ⚡ 纯 HTTP 返回 JSON:内置功能大多不需要浏览器,一条命令直接拿到结构化数据

下面是一场真实录制的竞速:同一个 AI agent 完成同一个查询任务,左边靠浏览器逐页点击,右边通过 API Anything 直接调用网站接口——右侧用时明显更短,消耗的 token 也少得多。

两个 AI agent 竞速同一任务:左边驱动浏览器,右边调用 API Anything 的网站接口

安装前准备:3 条命令检查环境

API Anything 完全本地运行,不需要账号、API key 或云服务。先检查环境:

node --version && npm --version && git --version
依赖 要求 用途
Node.js ≥ 22.13 运行环境(必须)
npm + git 常规版本 构建与安装(必须)
Chromium 内核浏览器 可选 仅"教会它新网站"时需要,内置站点用不上

💡 浏览器支持 Google Chrome(默认)、Brave、Edge、Chromium、Vivaldi、Arc,任何 Chromium 内核都可;非默认浏览器可用环境变量 API_ANYTHING_BROWSER 指定。

完整安装步骤可参考 INSTALL.md 与 docs/QUICKSTART.md。

快速安装:两种方式任选

方式一:让 AI 编码 agent 替你装(最快)

先克隆仓库:

git clone https://gitcode.com/gh_mirrors/ap/api-anything && cd api-anything

然后对 Claude Code、Codex 等编码 agent 说:"请按照 INSTALL.md 的步骤帮我安装 API Anything"。agent 会自动检查 Node 版本、构建安装 api-anything 命令、执行一次真实调用验证、再配置好 MCP 连接——全程你只需在失败时看它给出的提示。

方式二:手动安装(3 条命令)

git clone https://gitcode.com/gh_mirrors/ap/api-anything && cd api-anything
npm ci
npm install -g "$(npm pack --silent)"

两个易踩的坑:

  • ⚠️ 该包尚未发布到 npm,不要用 npm install -g github:...,在 npm 11 下会失败
  • ⚠️ 全局安装若报权限错误(EACCES),不要直接 sudo,先修正 npm 全局目录权限

安装后的命令是完整的构建产物,不依赖克隆目录保留。

第一次调用:搜索 Hacker News 验证安装

安装完成,马上验证。两条命令:

api-anything sites
api-anything call hacker-news search query=sqlite

第一条列出所有内置站点(Google Flights、Hacker News、Amazon、YouTube、Airbnb、Instagram、LinkedIn、X 等);第二条对 Hacker News 发起一次真实搜索——不需要账号、不需要浏览器。实际输出如下:

安装 API Anything 后调用第一个网站 API 的终端输出:Hacker News 搜索返回 JSON

返回的是紧凑的 JSON,关键字段:

字段 含义
ok 调用是否成功
class 结果类型,如 ok
tier 传输层级:1 = 纯 HTTP(无浏览器),更高档位逐步依赖浏览器
data 真正的数据(这里是 30 条搜索结果)
ms 耗时,通常百毫秒级

调用失败时也不会"裸奔":ok: false 会附带 class(错误类型)、reason(原因)和 next(下一步该做什么),并以非零状态码退出,人和脚本都能接住。

连接 AI 助手:MCP 配置一步到位

API Anything 自带 MCP 服务器,接入后 agent 就能自主发现和调用网站接口,工具共 4 个:list_sites(列站点)、list_operations(列接口)、call_operation(调接口)、login(登录)。

Claude Code:

claude mcp add --scope user api-anything -- api-anything mcp

Codex:

codex mcp add api-anything -- api-anything mcp

其他任意 MCP 客户端,在配置里合并这一段即可(若找不到命令,用 command -v api-anything 的绝对路径):

{ "mcpServers": { "api-anything": { "command": "api-anything", "args": ["mcp"] } } }

连接后重启 agent 会话,就可以问它:"API Anything 能调用哪些站点?"或"Goodreads 给《Piranesi》打了多少分?"教会 agent 创建新接口的技能文件位于 skills/api-anything/SKILL.md。

进阶:教会它一个新网站(可选)

内置的 22 个只读操作覆盖 9 个站点。想调用清单之外的网站时,"教"它:给出页面 URL 模板(用 {参数} 占位)和两组示例输入,无头浏览器会把页面加载两次,请求中随输入变化的部分自动成为参数,其余存为模板——整个学习过程不经过 LLM:

api-anything add hn-demo links \
  --trigger 'https://news.ycombinator.com/from?site={domain}' \
  --example domain=github.com --example2 domain=github.io --match path=/from \
  --html '{"items":"tr.athing","fields":{"title":".titleline > a","url":".titleline > a@href"}}'

api-anything call hn-demo links domain=arxiv.org

第二条命令用了学习时从未出现的 arxiv.org,依然通过纯 HTTP 返回 30 条正确结果。以后网站改版导致失效,它会自动重新学习修复。该步骤需要装有 Chromium 内核浏览器,完整可运行的演示脚本见 examples/teach-once.sh。

用两个示例输入教会 API Anything 一个新网站接口,再用全新参数调用

常见问题 FAQ

需要装浏览器吗? 内置站点不需要。内置操作全部是纯 HTTP(tier 1),完全不启动浏览器;只有学习新网站、或调用个别需要浏览器的功能时才用到。

数据存在哪里? 全部在本地 ~/.api-anything(可用 API_ANYTHING_HOME 覆盖)。规格文件里只保存凭据的引用,不存真实值。

能向网站写数据吗? 当前版本只内置只读操作;写操作需要显式加 --allow-writes 才会放行。

有什么限制? 它是本地工具(用你自己的机器、网络与会话),只会你教过的接口,也无法自动过验证码。详见 docs/REFERENCE.md。

延伸阅读

登录后查看全文
api-anything