AIR SDK

AIR SDK

エージェントの集合知。ウェブの使い方をエージェントに推測させるのはやめましょう。やるべきことをエージェントに知らせます。考えましょう。ハイブマインド。オープンなエージェントインターネットを実現しましょう。

インストール · クイックスタート · 理由 · エージェントスキル · ドキュメント

ブラウザーエージェントは、クリックする場所をLLMに尋ねるたびに、トークンと時間を浪費します。AIR SDKは推測を知識に置き換えます。これは初期段階の研究プレビューです。

最先端モデルと比較して、コストを最大7,000倍削減し、速度を280倍向上。関数呼び出しは1回。コード変更は不要です。

ベンチマーク

主要な8つのドメインで測定。キャッシュを無効にして、コールド状態でAPIを40回呼び出しました。LLMのベースラインには、Frontier Modelの料金（トークン100万個あたり15ドル／75ドル）を適用しています。AIR SDKには、Scaleプラン（月額149ドル、25万回の実行）を適用しています。

ワークフローが複雑になるほど、節約効果は高まります。LLMのコストは累積します。操作のたびに会話のコンテキストが増え、以降の往復はそのたびに高コストになります。AIRのマクロパスでは、ワークフローのステップ数にかかわらず、API呼び出しは常に1回です。

前提条件

• Node.js >= 18
• 次のいずれか：Playwright、Puppeteer、またはBrowser Use（任意のピア依存関係）

インストール

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

エージェントスキル（AIコーディングエージェントに推奨）：

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

無料プランが含まれています。クレジットカードは不要です。ネットワークをよりスマートにして、リポジトリにスターを付けて共有しましょう ⭐

軽量な代替パッケージ

SDK全体は必要ありませんか？一般的なユースケース向けに、単体で使えるパッケージを公開しています。

クイックスタート

既存のPlaywrightページをラップします。それ以外は変更ありません。

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およびBrowser Useでも動作します。

// 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 は、エージェントに次の3つを提供します。

仕組み： withAIR() でページをラップします。SDK は操作を監視し、セレクターを解決して、サイトの機能を事前に読み込みます。コードを変更する必要はありません。より快適に動作します。

プライバシー優先： 入力値、Cookie、PII が送信されることはありません。プライバシーに関するドキュメントをご覧ください →

認証情報の管理

API キーは、0600 の権限（所有者のみ読み書き可能）で ~/.config/air/credentials.json に保存されます。

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 環境変数 → ~/.config/air/credentials.json → カレントディレクトリの .env。

エージェントスキル

1つのコマンドで、コーディングエージェントにサイトインテリジェンスを提供できます。

npx @arcede/air-sdk install-skill

このコマンドは Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw を自動検出し、MCP サーバーの設定を書き込み、API キーを挿入します。また、エージェントの起動を高速化するため、@arcede/air-sdk をグローバルにインストールします（npx を使用した場合の約60秒に対し、約2秒）。さらに、npx のバージョンキャッシュに関する問題を避けるため、各設定に絶対バイナリパスを書き込みます。エージェントを再起動すると、すぐに新しいツールを利用できます。

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

利用可能なツール：

OpenAI スキル

AIR SDK は、gpt-5.4 および gpt-5.4-mini 向けのOpenAI ホスト型シェルスキルとしても利用できます。

# 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'

次に、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>" }
        ]
      }
    }
  }]
}

組織のネットワーク許可リストに api.agentinternetruntime.com が必要です。

設定

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 は 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/ をご覧ください。

• リサーチエージェント — 機能を考慮したナビゲーションによるマルチソース調査
• 価格比較 — 堅牢なセレクターによる複数サイトの価格モニタリング
• 機能スカウト — ドメイン全体の機能を発見してマッピング
• サイトモニター — 堅牢なセレクターによるサイトの変更追跡

コントリビューション

CONTRIBUTING.md をご覧ください。プルリクエストを歓迎します。

リンク

• ドキュメント
• 料金
• agent.json 標準
• 変更履歴

ライセンス

MIT