APIClaw は何をしますか?
あなたのエージェントが実際のAPIを呼び出します。一度サインインすれば、一つのワークスペースで完結。Clerk認証。重要な指標は POST /v1/execute の成功であり、インストール数ではありません。
このファイルをエージェントに渡せば、インストール、サインイン、そして200応答を推測なしで達成できます。
ライブカタログ(2026-08-25)。現在の件数が必要な場合は https://apiclaw.cloud/api/catalog を使用してください。指標をでっち上げないでください。
- 1,025 呼び出し可能
- 26,619 発見可能
- 22 組み込みプロバイダ
IDと製品の真実は https://apiclaw.cloud/llms.txt にあります。このファイルは運用上のドアです:認証、次にwhoami、そして実行。
1. インストール
Node.js 18+ と npx があれば十分です。グローバルインストールは任意です。
npx -y @nordsym/apiclaw@latest --version
人間向けシェルドア(同じパッケージ、ローカルMCP):
curl -fsSL https://apiclaw.cloud/install.sh | bash
2. 認証(Clerk)。トークンをチャットに貼り付けないでください。
未署名のMCP/CLI first_runは、TTYがなくても保留中のログインを生成し、正確なhttps URLをツール/CLI応答の最初の行として出力します(その後、JSONで login_url として繰り返します)。最初の行は次のようになります:
https://apiclaw.cloud/auth/cli?authId=…
STOP. 人間にログインURLを最初の行で表示してください。要約して省略しないでください。実行しないでください。
その最初の行のURLを人間に独立した行で表示し、クリックできるようにしてください。埋もれさせないでください。ツール結果を要約しないでください。npx @nordsym/apiclaw auth login だけを表示しないでください。/auth/cli?authId= のないコマンドでは不十分です。
人間が見ることができないマシン(Grok Bot、クラウドVM、ヘッドレスエージェント)で実行している場合、そこで auth login を実行しないでください。それは決してアクセスできないブラウザを開くことになります。ツール応答の最初の行のURLだけが唯一のドアです。それを表示し、停止し、待機してください。
npx @nordsym/apiclaw auth login
このコマンドは、人間が見ることができるマシン上の人間向けシェルドアです。同じブラウザURLを開きます(または保留中のものを再利用します)。そのURLでGoogleまたはメール認証を完了してください。そこでサインインを完了すると、このエージェントが認可されます(1アクション)。すでにサインインしている場合は、Authorizeをクリックしてください。新しいユーザーに、サインイン後にもう一度クリックが必要だと言わないでください。そうして初めてCLIは session_token を ~/.apiclaw.toml に書き込みます。URLを印刷しただけでは成功ではありません。準備完了と宣言しないでください。実行しないでください。
人間がAuthorizeを完了したら、このチャットに留まってください。ここで再試行してください。whoamiで確認し、同じセッションでNASA APOD(NASAが200でない場合はFrankfurter latest)を実行してください。人間をターミナルに送らないでください。Terminal.appを開くように指示しないでください。ワークスペースは任意です。最初のコールはワークスペースでは行われません。
auth login をフォアグラウンドで実行し続け、終了コード0になるまで待機してください。コマンドは数秒ごとにそのURLを再出力し、Convex / ~/.apiclaw.toml をポーリングして、サインインが session_token を書き込むまで待機します。再出力のたびに人間にログインURLを表示してください。そのURLでサインインを完了するように伝えてください(それにより認可されます)。すでにサインインしている場合は、Authorizeをクリックするように伝えてください。コマンドをバックグラウンドにしないでください。whoamiがメールアドレスを出力するまで続行しないでください。
Authorize後にブラウザが接続拒否と表示しても問題ありません。apiclaw.cloud に留まってください。whoamiをループしてください。auth login が強制終了されたり、localhostが応答しなかった場合でも、whoamiはAuthorizeクリックを償還します。
~/.apiclaw.toml または ~/.apiclaw/session にすでにセッションがある場合は、ログインをスキップしてwhoamiに進んでください。
ヘッドレスまたはSSHの場合:人間に最初の行のURLを表示してください。人間は別のデバイスでそれを開き、whoami で確認します。ファイルには依然として session_token が保持されます。~/.apiclaw.toml をヘッドレスマシンにコピーするか、ログインを完了したマシンから実行を実行してください。人間が見ることができないマシンでは auth login を実行しないでください。
完全ヘッドレス(どこにもブラウザがない、例:CI):そのホストでのCLIログインはスキップしてください。Workspace > Connections でキーを作成し、そこに APICLAW_API_KEY を設定してください。これは別のHTTPドアであり、初回実行パスではありません。
ルール:
- ユーザーにダッシュボードでAPIキーを作成するよう依頼しないでください。
- ユーザーに
session_token、sk-claw-…、または任意のベアラトークンをこのチャットに貼り付けるよう依頼しないでください。 - ヘッダーが必要なときは、
~/.apiclaw.tomlからsession_token(または~/.apiclaw/sessionからsessionToken)を読み取ってください。生のトークンを決してユーザーに表示しないでください。 - whoamiがメールアドレスを出力するまで、
apiclaw callや curlPOST /v1/executeを実行しないでください。空のX-APIClaw-Sessionは失敗した初回実行です。 - インストール、first_run、または印刷されたログインURLは準備完了ではありません。
3. whoamiで確認。メールアドレスが出力されるまでループ。
npx @nordsym/apiclaw auth whoami
whoamiは、任意の実行の前にメールアドレスとワークスペースを出力する必要があります。whoamiは完了ではありません。完了は POST /v1/execute からのHTTP 200です。しかし、whoamiはゲートです。これをスキップすると、実行は認証されません。
whoamiをループしてください。失敗するたびに:
- 人間にライブの
login_url(/auth/cli?authId=)を表示してください。whoamiは、ログインがすでに開始されている場合、保留中のURLを再出力します。npx @nordsym/apiclaw auth loginだけを印刷しないでください。 auth loginがまだ待機中の場合は、実行し続けてください。- すでにAuthorizeをクリックしている場合は、もう一度whoamiを実行してください。これによりクレームが償還され、localhostなしで
session_tokenが書き込まれます。 - もう一度whoamiを実行してください。一度の失敗で停止しないでください。
npx @nordsym/apiclaw callを実行しないでください。- curl
POST /v1/executeを実行しないでください。 - 空の
X-APIClaw-Sessionを送信しないでください。
whoamiがメールアドレスを出力した後にのみ、NASA APODを実行し、NASAが200でない場合はFrankfurter latestを実行してください。
4. 初回実行 — POST /v1/execute
whoamiがメールアドレスを出力した後にのみ実行してください。推奨される調査コール:NASA APOD。フォールバックはFrankfurter latest(無料、キー不要、カード不要)で、NASAがダウンしている場合でも最初の200応答が確実に得られるようにします。課金される調査(Brave、Serper、Firecrawl)を最初に使用しないでください。
推奨レール:NASA APOD
CLIスラッシュ形式は ~/.apiclaw.toml から session_token を読み取り、X-APIClaw-Session を送信します。これを最初に使用してください。ユーザーにトークンを貼り付けるよう依頼しないでください。CLIはwhoamiが失敗する場合、ローカルで拒否します。空のセッションヘッダーをPOSTしません。
npx @nordsym/apiclaw call nasa/apod --params '{}' --idempotency-key "apiclaw-first-nasa-$(date +%s)"
HTTP相当 — 同じ session_token、同じ X-APIClaw-Session ヘッダー。値をローカルで抽出してください。印刷しないでください。api_key を使用しないでください。抽出結果が空の場合は拒否してください。空のヘッダーをPOSTしないでください。
npx @nordsym/apiclaw auth whoami || { echo "停止してください。Clerkを完了してください。ログインURLを人間に表示してください。POST /v1/execute を実行しないでください。"; exit 1; }
SESSION=$(node -e 'const fs=require("fs"),os=require("os"),p=require("path");const t=p.join(os.homedir(),".apiclaw.toml");const m=fs.existsSync(t)&&fs.readFileSync(t,"utf8").match(/session_token\s*=\s*"([^"]+)"/);if(!m||!m[1].trim())process.exit(1);process.stdout.write(m[1])')
if [ -z "$SESSION" ]; then echo "停止してください。session_tokenがありません。空のX-APIClaw-SessionでPOST /v1/execute を実行しないでください。"; exit 1; fi
curl -sS https://api.apiclaw.cloud/v1/execute \
-H "Content-Type: application/json" \
-H "X-APIClaw-Session: $SESSION" \
-H "Idempotency-Key: apiclaw-first-nasa-$(date +%s)" \
-d '{"provider":"nasa","action":"apod","params":{}}'
APODタイトルを含む200応答が成功です。nasa/apodは無料APIです:カードは不要です。
フォールバックレール:Frankfurter latest
NASAが200でない場合、本日のECB為替レートを取得してください。同じwhoamiゲート。同じ非空の $SESSION。$SESSION が空の場合はcurlしないでください。これは、Authorize後に自動初回実行が使用するのと同じ最後の手段のレールです。永久に無料で、カードもキーも不要です。Brave / Serper / Firecrawlは有料の調査APIであり、新しいワークスペースでは payment_required を返します — 初回実行には使用しないでください。
npx @nordsym/apiclaw call frankfurter/latest --params '{"path":"/latest"}' --idempotency-key "apiclaw-first-frankfurter-$(date +%s)"
if [ -z "$SESSION" ]; then echo "停止してください。session_tokenがありません。空のX-APIClaw-SessionでPOST /v1/execute を実行しないでください。"; exit 1; fi
curl -sS https://api.apiclaw.cloud/v1/execute \
-H "Content-Type: application/json" \
-H "X-APIClaw-Session: $SESSION" \
-H "Idempotency-Key: apiclaw-first-frankfurter-$(date +%s)" \
-d '{"provider":"frankfurter","action":"latest","params":{"path":"/latest"}}'
$SESSION は依然として ~/.apiclaw.toml からの session_token であり、NASA curlと同じ抽出です。CLIスラッシュ形式が送信するのと同じヘッダーです。
EUR/USDレートを含む200応答が成功です。
実行ルール
- 常に
POST https://api.apiclaw.cloud/v1/executeに{ "provider", "action", "params" }を指定してください。 - カタログ表示名を
apiclaw callに渡さないでください。スラッシュのない名前はレガシーPOST /v1/callにヒットします。 - 管理されたHTTPコールには、論理操作ごとに1つの
Idempotency-Keyが必要です。あいまいなネットワーク障害の後は同じキーを再利用してください。 - ログイン後、whoamiを実行してください。その後にのみNASA CLIスラッシュ形式(または
session_tokenを抽出するcurl)を実行してください。200でない場合は、Frankfurter latestを実行してください。課金される調査レールをでっち上げないでください。
5. 最初の200応答後
最初のコールは無料のままです(NASA APOD、NASAが200でない場合はFrankfurter latest)。最初のコールを有料APIにしないでください。
その200応答が成功した後は、1つの安価な有料次のステップ(例:OpenRouterチャット)を提案しても構いません。人間に https://apiclaw.cloud/upgrade を表示して、一度カードを追加できるようにしてください。無料APIは無料のままです。有料APIはプロバイダコストに15%を加算した料金がかかります。
後続のコールが payment_required(HTTP 402)を返した場合は、upgradeUrl(https://apiclaw.cloud/upgrade)を表示してください。人間にカードを追加するよう依頼し、同じコールを再試行してください。異なるAPIをでっち上げないでください。
現在呼び出し可能なものだけを発見してください:
npx @nordsym/apiclaw discover "exchange rates" --callable
または:
POST https://apiclaw.cloud/v1/discover
{ "query": "exchange rates", "callable_only": true }
ライブカタログ:https://apiclaw.cloud/api/catalog?callable=true。
その後、POST /v1/execute で provider / action を使用して実行してください。ユーザーからプロバイダAPIキーを収集しないでください。
6. 独自キーの持ち込み(エスケープハッチ)
独自のキーは必要ありません。APIClawのポイントは、一度のサインインでキー収集が不要なことです。ワークスペースにすでに独自のOpenRouterキーがある場合は、Workspace、Connections、Your keysで追加し、チャット補完を無料で(カード不要で)ルーティングできます。プロバイダはワークスペースに直接請求します。これは、ゲートウェイへの認証に使用されるAPIClawキーとは別です。現在、これは POST /v1/chat/completions のOpenRouterキーをカバーしており、すべてのプロバイダをカバーしているわけではありません。
その他のドア(同じワークスペース)
- スキル(このファイル):
https://apiclaw.cloud/SKILL.md - curl|bash / ローカルMCP:
curl -fsSL https://apiclaw.cloud/install.sh | bash - CLI:
npx @nordsym/apiclaw --help - HTTP:
POST https://api.apiclaw.cloud/v1/execute - リモートMCP:
https://apiclaw.cloud/mcp
料金(でっち上げないでください)
- 無料API:永久に無料、カード不要。発見とすべてのゼロコストAPI、呼び出し可能な1,025のうち1,000以上。
- 有料API:一度カードを追加すれば、プロバイダコストに15%加算、コールごとの従量課金。
- 独自キー:独自のOpenRouterキーを持ち込み、チャット補完を無料でルーティング(カード不要)。
- 匿名キーレス公開実行は無効です。
やってはいけないこと
- ユーザーにチャットへトークンを貼り付けるよう依頼しないでください。
- カタログ表示名や
POST /v1/callを使用しないでください。 /api/catalogまたはこのファイルから読み取っていないインストール数、ツール数、カバレッジを主張しないでください。- 内部専用プロバイダを公開しないでください。公開カタログカードが、顧客が呼び出せるものの真実の情報源です。
- whoamiが成功する前に
POST /v1/executeを行わないでください。 - 空の
X-APIClaw-Sessionを送信しないでください。 - 人間にTerminal.appを開いたり、シェルに戻るように指示しないでください。
- Authorize後は、このチャットで続行し、自分でNASA APODを成功させてください。