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.

[npm version] [downloads] [license] [docs] [tests] [typescript strict]

Install · Quick Start · Why · Agent Skill · Docs

Your browser agent wastes tokens and time every time it asks an LLM what to click. AIR SDK replaces guessing with knowing. This is an early research preview.

Up to 7,000x cost reduction and 280x faster vs frontier models. One function call. Zero code changes.

Benchmarks

Measured across 8 major domains, 40 cold API calls, cache disabled. LLM baseline priced at Frontier Model ($15/$75 per M tokens). AIR SDK at Scale tier ($149/mo, 250K executions).

The more complex the workflow, the more you save. LLM costs compound — every action adds to the conversation context, making each subsequent round trip more expensive. AIR's macro path is always one API call, regardless of how many steps the workflow has.

Prerequisites

• Node.js >= 18
• One of: Playwright, Puppeteer, or Browser Use (optional peer dependencies)

Install

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

Agent Skill (recommended for AI coding agents):

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

Free tier included. No credit card. Make the network smarter, star the repo and share it ⭐

Lightweight Alternatives

Don't need the full SDK? We publish standalone packages for common use cases:

Quick Start

Wrap your existing Playwright page. Nothing else changes.

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 intelligenceawait 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 automationconst capabilities = await smartPage.air.listCapabilities('example.com');

Also works with Puppeteer and Browser Use:

// Puppeteerimport { withAIR } from '@arcede/air-sdk/puppeteer';const page = withAIR(await browser.newPage(), { apiKey: process.env.AIR_API_KEY });
// Browser Useimport { AIRPlugin } from '@arcede/air-sdk/browser-use';const agent = Agent({ plugins: [new AIRPlugin({ apiKey: process.env.AIR_API_KEY })] });

Why

Browser automation is fragile. Selectors break. Sites change. Your agent has no idea what's possible until it's already on the page.

AIR SDK gives your agent three things:

How it works: Wrap your page with withAIR(). The SDK observes actions, resolves selectors, and preloads site capabilities. Your code doesn't change — it just works better.

Privacy-first: Input values, cookies, and PII are never sent. See our privacy docs →

Credential Management

API keys are stored at ~/.config/air/credentials.json with 0600 permissions (owner read/write only).

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

Key resolution order: AIR_API_KEY env var → ~/.config/air/credentials.json → .env in current directory.

Agent Skill

Give your coding agent site intelligence with one command:

npx @arcede/air-sdk install-skill

This auto-detects Claude Desktop, Claude Code, Cursor, Windsurf, and OpenClaw, writes the MCP server config, and injects your API key. It installs @arcede/air-sdk globally for fast agent startup (~2s instead of ~60s with npx) and writes the absolute binary path to each config to avoid npx version caching issues. Restart your agent and it instantly has new tools.

{  "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

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

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

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

Tools available:

OpenAI Skill

AIR SDK is also available as an OpenAI hosted shell skill for gpt-5.4 and gpt-5.4-mini:

# Package and uploadcd air-sdk/openai-skillzip -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'

Then use in the Responses API:

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

Requires api.agentinternetruntime.com in your org network allowlist.

Configuration

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)});

Machine Payments Protocol

AIR SDK supports x402 micropayments, enabling your agent to pay for premium site access without pre-registration:

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

See examples/agents/ for working agent examples:

• Research Agent — Multi-source research with capability-aware navigation
• Price Comparison — Cross-site price monitoring with resilient selectors
• Capability Scout — Discover and map capabilities across domains
• Site Monitor — Track site changes with resilient selectors

Contributing

See CONTRIBUTING.md. PRs welcome.

Links

• Documentation
• Pricing
• agent.json Standard
• Changelog

License

MIT