Communitygithub.com

APIClaw

APIClawをセットアップし、実際のAPIを実行します。ユーザーが「https://apiclaw.cloud/SKILL.md をセットアップして」と言った場合や、プロバイダキーを収集せずに調査用APIコールが必要な場合に従ってください。認証はClerkで `npx @nordsym/apiclaw auth login` を使用します。

APIClaw とは?

APIClawは、AIエージェントがリアルなAPI(NASA APOD、Frankfurter為替レートなど)を、ユーザーがプロバイダキーを収集することなく呼び出せるようにするスキルです。Clerk認証によりシングルサインオンを提供し、セッショントークンを安全に管理します。セットアップは `npx @nordsym/apiclaw auth login` でログインし、`npx @nordsym/apiclaw auth whoami` で認証を確認した後、`POST /v1/execute` エンドポイント経由でAPIを実行します。このスキルは、Claude Code、Cursor、Codexなどのエージェント向けに設計されており、ユーザーにトークンをチャットに貼り付けさせたり、カタログ表示名を `apiclaw call` に渡したりすることは禁止されています。初回実行は常に無料のNASA APODまたはFrankfurter latestを優先し、有料APIはその後のステップでのみ提案されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nordsym/apiclaw/tree/HEAD/landing/public

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 や curl POST /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を成功させてください。

関連スキル