10 分钟上手 API Anything:快速安装并调用第一个网站 API 的完整步骤
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 也少得多。
安装前准备: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 发起一次真实搜索——不需要账号、不需要浏览器。实际输出如下:
返回的是紧凑的 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。
常见问题 FAQ
需要装浏览器吗? 内置站点不需要。内置操作全部是纯 HTTP(tier 1),完全不启动浏览器;只有学习新网站、或调用个别需要浏览器的功能时才用到。
数据存在哪里? 全部在本地 ~/.api-anything(可用 API_ANYTHING_HOME 覆盖)。规格文件里只保存凭据的引用,不存真实值。
能向网站写数据吗? 当前版本只内置只读操作;写操作需要显式加 --allow-writes 才会放行。
有什么限制? 它是本地工具(用你自己的机器、网络与会话),只会你教过的接口,也无法自动过验证码。详见 docs/REFERENCE.md。
延伸阅读
- 📖 快速上手与演示:docs/QUICKSTART.md
- 🛠 完整命令参考:docs/REFERENCE.md
- 🎬 演示录屏与逐字文本:docs/demos/README.md
- 📐 设计思路:docs/DESIGN.md
- 📊 基准测试方法与数据:bench/README.md


