ApiTap

把网站流量转成可复用的 API 技能文件,让代理直接发起请求。

Star 数
★ 132
最近更新
1 个月前
License
Apache-2.0
主语言
TypeScript

30 秒速览

运行形态
命令行工具MCP 服务器代码库 / SDK
可在哪里用
通用 · 跨平台Claude Code
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Node.js 20+Playwright Chromium(可选,用于 capture 和 browse)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
需要让 AI 代理读取网站单页应用数据的开发者,可先捕获流量,再以 fetch() 重放端点。
不适合
  • 必须只调用公开 API、不能依赖网站内部接口的团队
  • 需要纯浏览器自动化来处理红色等级反爬端点的用户
官网
apitap.io ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-21最新版本 v2.3.4(2026-10-21)

这个 Agent 能做什么,适合哪些场景?

ApiTap 提供 CLI、MCP 服务器和 npm 库,让用户通过 API 而非浏览器访问网站数据。它可通过 Playwright/CDP 捕获真实网络流量、自动探测常见 API,或导入 OpenAPI/Swagger 规格,并将结果保存为本地签名 JSON 技能文件。重放时,ApiTap 使用 fetch() 直接调用匹配已捕获路由形状的端点,凭据从加密存储注入,不放入技能文件。它还提供无需浏览器的 peek、read 和 discover 命令,以及可选 Chrome 扩展。需要 Node.js 20+;捕获和浏览需另装 Playwright Chromium,其他路径无需浏览器。

使用 apitap capture <url> 或 apitap attach --port <port> 观察网站的网络请求并生成端点技能文件;通过 apitap discover <url> 探测 API;用 apitap import 从 APIs.guru、URL 或本地文件转换 OpenAPI/Swagger 规格。技能文件存于 ~/.apitap/skills/,包含路由、参数和响应形状;认证信息另行加密保存。使用 apitap replay <domain> <id> [key=val...] 以 fetch() 重放端点,或用 apitap read <url> 提取网页内容、用 apitap peek <url> 做 HEAD 检查。MCP 客户端可调用 12 个工具,包括 apitap_read、apitap_capture 和 apitap_replay。

  1. 需要让 AI 代理读取网站单页应用数据的开发者,可先捕获流量,再以 fetch() 重放端点。
  2. 需要快速探索公开 API 的集成开发者,可从 APIs.guru 导入 OpenAPI 规格并查看端点结构。
  3. 使用 Claude Code、Claude Desktop、Cursor 或 Windsurf 的用户,可把 ApiTap 配置为 MCP 服务器。
  4. 希望减少代理处理 HTML 的上下文开销的用户,可用 apitap read 调用内置站点解码器提取内容。
  5. 已登录网站的用户可用可选 Chrome 扩展被动发现 API,或从现有浏览器会话捕获流量。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @apitap/core
  • npx playwright install chromium
运行环境
Node.js 20+

如何安装或部署这个 Agent?

需要 Node.js 20+。全局安装 CLI 与 npm 包:

npm install -g @apitap/core

将 MCP 服务器添加到 Claude Code:

claude mcp add -s user apitap -- apitap mcp

仅在要使用 capture 或会打开真实浏览器的 browse 时安装 Chromium:

npx playwright install chromium

read、peek、discover 和 import 无需安装浏览器。

如何使用这个 Agent?

导入 Stripe 的 OpenAPI 规格并重放一个端点:

apitap import --from apis-guru --search stripe
apitap replay api.stripe.com get-listcharges limit=5

捕获网站流量并重放时,也可运行:

apitap capture https://polymarket.com
apitap replay gamma-api.polymarket.com get-events

捕获时在打开的浏览器中正常浏览网站,再按 Ctrl+C 结束。技能文件保存在 ~/.apitap/skills/。重放需要相应站点端点可重放;认证凭据在捕获后存于加密存储。

这个 Agent 有哪些优点和局限?

优点
  • 支持捕获真实流量、自动发现和 OpenAPI 导入三种生成技能文件的路径。
  • 端点通过 fetch() 重放,无需在重放路径启动浏览器;MCP 服务器提供 12 个工具。
  • 凭据与技能文件分开保存并加密;技能文件签名,重放按捕获路由形状匹配。
  • 提供 peek、read 文本解码器和 discover 等无需浏览器的操作。
局限
  • 需要 Node.js 20+ 和终端环境;使用 MCP 还需 MCP 兼容客户端。
  • capture 和 browse 需要额外安装 Playwright Chromium;也可选择连接现有 Chrome。
  • 端点按重放难度分级;CSRF 或会话绑定端点可能不稳定,签名或反爬端点需要完整浏览器。
  • 技能文件依赖捕获或规格质量;README 说明导入端点置信度为 0.6–0.85,首次成功重放后可提升。

这个 Agent 与同类方案有什么区别?

与 Playwright/Puppeteer 浏览器自动化相比,ApiTap 先捕获 API,再直接重放请求,减少 DOM、选择器和等待操作;复杂反爬端点仍可能需要完整浏览器。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
ApiTap 当前 75 · 表现良好 命令行工具免费 ★ 132 1 个月前 TypeScript Claude Code
Scrapling 网页抓取框架 65 · 存在缺口 代码库 / SDK免费 ★ 105k 4 天前 Python —
wigolo 71 · 存在缺口 命令行工具免费 + 模型费 ★ 5.6k 11 天前 TypeScript Codex · Claude Code · OpenAI API · Claude API
CamoFox Browser Server 63 · 存在缺口 自托管服务免费 ★ 452 15 天前 JavaScript Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
表现良好
75/ 100 五分制 3.8 / 5
信任安全 22/29
可靠稳定 9/14
适用触发 15/18
规范维护 14/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全22 / 29 · 3.8/5

材料显示出站请求经过 SSRF 校验、连接时 DNS 校验和重定向复查,凭证与 skill 文件分离,并有 PII 清理、签名和细粒度文件权限。capture 会从真实登录会话收集流量,agent 可重放请求,且部分认证刷新可能打开浏览器;扩展提升域名的流程提到通知批准,但常规 capture/replay 没有统一的逐操作确认。依赖安全有固定 SHA 的 CI action 和 npm 锁定安装说明,但没有依赖审计或漏洞缓解证据。清理/修复有隔离、快照和恢复路径。来源列出贡献者名称及仓库地址,但发布者身份未验证,维护归属仍不清晰。

可靠稳定9 / 14 · 3.2/5

代码与文档大体解释了发现、捕获、重放和错误处理;CLI JSON 错误格式有明确约定。不过 README、Hermes skill 与 SECURITY 对版本、支持版本和浏览器行为的描述并非完全一致。CI 配置显示 npm ci 和测试工作流,但静态审查不能确认运行结果;Playwright 是硬依赖,安装量较大,且某些环境需要额外安装 Chromium。失败路径有结构化错误和原因字段,但仍依赖网络目标及站点行为。

适用触发15 / 18 · 4.2/5

覆盖 CLI、MCP、npm 库及 Hermes 等场景,提供 read、peek、discover、import、capture、replay 等明确路径,并说明需要浏览器的边界、重放层级和认证刷新条件。工具选择建议较具体,但个别入口同时宣传低成本与广泛适用,触发范围仍可能偏宽。Node 20+、Linux/macOS 和浏览器安装说明较充分;依赖较重且沙箱中的认证刷新可能失败,环境适配并非全面。

规范维护14 / 18 · 3.9/5

README 与两份技能文档分别说明 MCP 和 CLI 用法,包含安装、配置、示例、FAQ 式比较、限制和安全模型;Apache-2.0 元数据与许可证文件一致。包版本和 Hermes skill 版本存在,但样本没有变更日志,版本对应关系不够清楚。安全报告渠道和响应时限有说明,不过维护责任只归于 ApiTap Contributors,无法识别明确负责人;CLAUDE.md 从内容看是面向 Claude Code 的贡献/使用指导,而非产品 manifest。

有效结果10 / 13 · 3.8/5

JSON 输出、MCP 工具表、响应预算和截断标记能支持 agent 消费;其核心价值是复用网站 API、结构化提取及减少浏览器成本。材料给出 token 节省和端点置信度数据,但这些数字主要是项目自述,且安装包包含 Playwright 硬依赖,增加安装成本;收益对可访问、可重放的站点更明显。

证据核验5 / 8 · 3.1/5

README、代码片段、包元数据、安全政策和样例测试共同支持部分主张,例如加密、SSRF 和签名设计;但多数 README 数字与覆盖面没有在提供的样本中逐项佐证。证据把置信度、重放层级和未验证端点作了区分,也披露加密威胁模型与清理局限;仍有性能与覆盖率主张缺少同等强度的证据。

风险与缓解建议
  • 凭证保护和脱敏有明确设计,但安全政策承认加密不能防止同时取得 ~/.apitap 目录与盐值的攻击者,PII 清理也只是尽力而为。
  • capture、扩展和 replay 会处理真实会话凭证或向站点发送请求;使用前应检查目标站点、权限和可能触发浏览器刷新的认证配置。
  • 性能、token 节省和测试数量来自项目材料;本次静态审查未执行代码,也未独立验证这些数字。
证据充分度:低 评估于 2026年11月11日 审查版本 8a76a873c736
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/apitap.svg?lang=zh)](https://followagents.com/zh/agents/apitap)
<a href="https://followagents.com/zh/agents/apitap"><img src="https://followagents.com/badge/apitap.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v2.3.4
    发布说明摘录
    Hacker News listing pages read through the API, and Angular/Ember app shells are labelled as SPAs (PR #105). Found by the nightly dogfood run after its scorer was fixed to read apitap's own failure labels. Fixed - HN listings. /news, /best, /newest, /ask, /show and /jobs now read the matching Firebase list (top 10) instead of falling through to HTML extraction. Only / and item?id= were decoded before. Paging (?p=2) is ignored. The URL match is anchored, so a URL that only ends in an HN path is not decoded as an HN listing. …
    在 GitHub 查看 ↗
  2. v2.3.3
    发布说明摘录
    read and peek now say when they could not get the page instead of returning an empty success, and OpenAPI import keeps a spec's port (PRs #102, #103; issues #96–#101). Found by the nightly dogfood run over 180 public URLs: 18 previous failures now pass, 0 regressions. Security - Import keeps credentials on their port (#96). Stored auth is keyed by hostname. Re-importing a spec served on another port of the same host used to move the skill file's base URL there, so stored credentials would follow. An existing skill file now keeps its origin …
    在 GitHub 查看 ↗
  3. v2.3.2 v2.3.2 — per-endpoint query keys; no auth on https→http redirects
    发布说明摘录
    Security follow-ups to v2.3.1's query-key support, found reviewing PR #89 (PRs #94, #95; issues #81, #90, #91, #92, #93). Security - Per-endpoint query keys (#92). Stored query keys were one value per parameter name per domain, so a domain that used a read-only key on one endpoint and an admin key on another replayed every endpoint with whichever was captured first. Each key is now tagged with the endpoint it was captured on (method + parameterized path), and replay sends an endpoint the key captured on it. If only one key is stored it is used …
    在 GitHub 查看 ↗

常见问题

ApiTap 是否需要付费 API 或模型密钥?
README 将项目描述为 Apache-2.0 免费开源软件;使用说明未要求模型密钥。调用目标网站时,是否需要该网站的认证取决于端点。
哪些功能不需要浏览器?
read、peek、discover 和 import 无需浏览器。capture 和 browse 需要 Playwright Chromium;attach 可连接已运行的 Chrome。
技能文件包含登录凭据吗?
README 说明凭据不写入技能文件,而是单独加密存储并在重放时注入。
所有捕获的端点都能直接重放吗?
不能保证。绿色和黄色端点可用 fetch(),橙色端点可能受 CSRF 或会话绑定影响,红色端点因请求签名或反爬可能需要完整浏览器。
ApiTap 官网是什么?
ApiTap 的 GitHub 仓库填写的官网是 https://www.apitap.io。这个链接由仓库作者设置;源码在 GitHub(n1byn1kt/apitap)。
ApiTap 开源吗?
开源。源码在 GitHub(n1byn1kt/apitap),许可证是 Apache-2.0。
ApiTap 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 ApiTap 的“信任与安全”打了 22/29 分。评审检查的 8 项安全措施没有完全缺失的。
ApiTap 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-21,在最近半年内,但不在最近 30 天内。最新版本是 v2.3.4(2026-10-21)。
ApiTap 是谁开发的?
ApiTap 由 GitHub 账号 n1byn1kt 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念