Air SDK

AIR SDK

Collective intelligence for agents. Stop your agents from guessing how to use the web. Let them know what to do. Think; hive mind. Let's make the open agent internet.

Install · Quick Start · Why · Agent Skill · Docs

______________________________________________________________________

每次浏览器代理询问LLM点击什么时，都会浪费令牌和时间。AIR SDK用知道代替猜测。这是一个早期的研究预览。

与前沿型号相比，成本降低了7000倍，速度提高了280倍。一个函数调用。零代码更改。

基准测试

在8个主要域中测量，40个冷API调用，禁用缓存。LLM基准定价为Frontier Model（每M代币15美元/75美元）。规模层的AIR SDK（149美元/月，25万次执行）。

工作流程越复杂，节省的就越多。LLM的成本是复合的——每一个动作都会增加对话的背景，使后续的每一次往返都更加昂贵。AIR的宏路径始终是一个API调用，无论工作流有多少步骤。

Methodology & raw data

LLM基线： 代理检查页面DOM，分析要与哪些元素交互的原因，生成工具调用。前沿模型定价（15美元/M投入，75美元/M产出）。

• *1个动作：* 约4000个输入+800个输出令牌x 2次往返=约9600个令牌，约0.24美元，约4秒推理时间。
• *10项行动：* 上下文随着每个动作而增长（对话历史累积）。平均约6000个输入+1000个输出令牌x每个操作2.5次往返=25次LLM调用，约175000个令牌，约4.13美元，约50秒推理时间。
• *十四行诗4比较：* 每个代币便宜5倍——1个动作：~0.05美元，10个动作：~8.83美元。仍然比AIR at Scale贵80-1400倍。

AIR SDK宏路径： 通过API返回经过预验证的CSS选择器。代理直接执行——没有DOM检查，没有LLM推理。成本=计划价格/包含的执行次数。

原始API延迟（40次测量，禁用缓存）：

• 浏览能力：中值180ms，最小148ms，p95 421ms
• 执行能力：中位数178ms，最小146ms，p95为333ms
• 组合：中位354ms，最小304ms，p95 1010ms

按层级划分的每次行动成本：

发现的功能： 每个域平均16（范围：3–39）

最后一次运行：2026-03-20| 自己运行基准测试: npx tsx benchmark/run.ts

先决条件

• Node.js>=18

安装

npm install @arcede/air-sdk
npx @arcede/air-sdk init   # saves key to ~/.config/air/credentials.json

Agent技能（推荐给AI编码Agent）：

npx @arcede/air-sdk install-skill   # auto-configures Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw

包括免费套餐。没有信用卡。让网络更智能，启动回购并分享⭐

轻量级替代品

不需要完整的SDK？我们为常见用例发布独立包：

快速开始

包装您现有的剧作家页面。其他一切都没有改变。

import { chromium } from 'playwright';
import { withAIR } from '@arcede/air-sdk/playwright';

const browser = await chromium.launch();
const page = await browser.newPage();
const smartPage = withAIR(page, { apiKey: process.env.AIR_API_KEY });

// Your existing code — now with site intelligence
await smartPage.goto('https://example.com');
await smartPage.fill('#search', 'flights to tokyo');
await smartPage.click('.search-btn');

// Know what's possible on any site before writing automation
const capabilities = await smartPage.air.listCapabilities('example.com');

也与 操纵者 和 浏览器使用:

// Puppeteer
import { withAIR } from '@arcede/air-sdk/puppeteer';
const page = withAIR(await browser.newPage(), { apiKey: process.env.AIR_API_KEY });

// Browser Use
import { AIRPlugin } from '@arcede/air-sdk/browser-use';
const agent = Agent({ plugins: [new AIRPlugin({ apiKey: process.env.AIR_API_KEY })] });

为什么

浏览器自动化很脆弱。选择器坏了。网站更改。你的经纪人不知道什么是可能的，直到它已经出现在页面上。

AIR SDK为您的代理提供了三件事：

它是如何工作的： 用以下内容包裹你的页面 withAIR()SDK观察操作、解析选择器并预加载站点功能。你的代码不会改变——它只是工作得更好。

隐私第一： 输入值、Cookie和PII永远不会被发送。 查看我们的隐私文档→

凭据管理

API密钥存储在 ~/.config/air/credentials.json 具有0600权限（仅限所有者读/写）。

npx @arcede/air-sdk init       # Save your key (opens dashboard)
npx @arcede/air-sdk whoami     # Show current key, source, and agent status
npx @arcede/air-sdk logout     # Remove key from all locations

关键分辨率顺序： AIR_API_KEY env 是 → ~/.config/air/credentials.json → .env 在当前目录中。

代理技能

只需一个命令，即可为您的编码代理提供站点情报：

npx @arcede/air-sdk install-skill

这个自动检测Claude Desktop、Claude Code、Cursor、Windsurf和OpenClaw，编写MCP服务器配置，并注入您的API密钥。它安装 @arcede/air-sdk 全局快速启动代理（使用npx时为~2s而不是~60s），并将绝对二进制路径写入每个配置，以避免npx版本缓存问题。重新启动您的代理，它立即具有新工具。

Manual setup (Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw)

需要全局安装： npm install -g @arcede/air-sdk。如果不是全局安装，请更换 "command": "air-sdk" 随着 "command": "npx" 和 "args": ["--mcp"] 随着 "args": ["-y", "@arcede/air-sdk", "--mcp"].

克劳德桌面版 --添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "air-sdk": {
      "command": "air-sdk",
      "args": ["--mcp"],
      "env": { "AIR_API_KEY": "air_xxx" }
    }
  }
}

克劳德代码：

claude mcp add air-sdk -e AIR_API_KEY=your_key_here -- air-sdk --mcp

光标 --添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "air-sdk": {
      "command": "air-sdk",
      "args": ["--mcp"],
      "env": { "AIR_API_KEY": "air_xxx" }
    }
  }
}

帆板运动 --添加到 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "air-sdk": {
      "command": "air-sdk",
      "args": ["--mcp"],
      "env": { "AIR_API_KEY": "air_xxx" }
    }
  }
}

开爪 --添加到 ~/.openclaw/openclaw.json:

{
  "mcpServers": {
    "air-sdk": {
      "command": "air-sdk",
      "args": ["--mcp"],
      "env": { "AIR_API_KEY": "air_xxx" }
    }
  }
}

可用工具：

OpenAI技能

AIR SDK也可作为 OpenAI托管shell技能 为了 gpt-5.4 和 gpt-5.4-mini:

# Package and upload
cd air-sdk/openai-skill
zip -r /tmp/air-sdk-skill.zip .
curl -X POST 'https://api.openai.com/v1/skills' \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F 'files=@/tmp/air-sdk-skill.zip'

然后在响应API中使用：

{
  "model": "gpt-5.4-mini",
  "tools": [{
    "type": "shell",
    "environment": {
      "type": "container_auto",
      "skills": [{ "type": "skill_reference", "skill_id": "" }],
      "network_policy": {
        "type": "allowlist",
        "allowed_domains": ["agentinternetruntime.com", "api.agentinternetruntime.com"],
        "domain_secrets": [
          { "domain": "api.agentinternetruntime.com", "name": "AIR_API_KEY", "value": "" },
          { "domain": "api.agentinternetruntime.com", "name": "Authorization", "value": "Bearer " }
        ]
      }
    }
  }]
}

需要 api.agentinternetruntime.com 在你的 org网络列表.

配置

withAIR(page, {
  apiKey: process.env.AIR_API_KEY,  // Required
  cacheEnabled: true,                // Local capability cache (default: true)
  cacheTTLMs: 1_800_000,            // Cache TTL in ms (default: 30 min)
  debug: false,                      // Log debug info (default: false)
});

机器支付协议

AIR SDK支持 x402小额支付，使您的代理无需预先注册即可支付高级网站访问费用：

const smartPage = withAIR(page, {
  apiKey: process.env.AIR_API_KEY,
  mpp: {
    enabled: true,
    paymentMethod: 'stripe_spt',
    credential: 'spt_...',
    maxPerRequest: 0.50,
    maxPerSession: 5.00,
    autoApprove: true,
  },
});

例子

看 examples/agents/ 对于工作代理示例：

• 研究代理 --具有能力感知导航的多源研究
• 价格比较 --使用弹性选择器进行跨站点价格监控
• 能力侦察员 --跨域发现和映射功能
• 现场监视器 --使用弹性选择器跟踪站点更改

贡献

看 贡献.md.PR欢迎。

链接

• 文档
• 定价
• agent.json标准
• 更新日志

许可证

麻省理工学院