agentcash

AgentCash — 有料 API アクセス

x402 で保護された API を、自動ウォレット認証と支払いで呼び出せます。API キーやサブスクリプションは不要です。

ウォレット

タスク	コマンド
合計残高を確認する	npx agentcash@latest balance
入金アドレスと入金リンクを確認する	npx agentcash@latest accounts
招待コードを引き換える	npx agentcash@latest redeem <code>
ガイド付き入金フローを開始する	npx agentcash@latest fund

有料の呼び出しに必要な残高があるかどうかだけを確認する場合は、balance を使用してください。入金リンクまたはネットワーク固有のウォレットアドレスが必要な場合に限り、accounts を使用してください。

残高が 0 の場合は、npx agentcash@latest fund の実行、入金リンクを取得するための npx agentcash@latest accounts の使用、または npx agentcash@latest redeem <code> による招待コードの引き換えを案内してください。

サービスの利用

1. オリジンを選択する、または検索する

まず、以下の利用可能なサービスの表を確認してください。 タスクに明らかに適したオリジンがある場合は、検索を省略してステップ 2（検出）に進んでください。例：

タスク	オリジン（検索を省略）
人物または企業を調べる	stableenrich.dev
画像または動画を生成する	stablestudio.dev
Instagram／TikTok のデータを取得する	stablesocial.dev
メールを送信する	stableemail.dev
ファイルをアップロードする	stableupload.dev

一覧にあるオリジンの中に適したものがない場合に限り、検索してください。

npx agentcash@latest search "<natural-language query>"

例：npx agentcash@latest search "send physical mail" または npx agentcash@latest search "generate music"

エンドポイントと料金を含む、一致するオリジンが返されます。デフォルトの出力形式は JSON です（人が読みやすい形式にするには --format pretty を指定します）。

2. サービスのエンドポイントを検出する

npx agentcash@latest discover <origin>

例：npx agentcash@latest discover https://stableenrich.dev

出力を注意深く確認してください。エンドポイントのパス、料金、必須パラメーター、およびエンドポイント固有のガイダンスを含む instructions フィールドが記載されています。

3. 呼び出す前に、特定のエンドポイントを確認する

npx agentcash@latest check <endpoint-url>

リクエストとレスポンスのスキーマ、および料金に関するガイダンスが返されます。フィールド名の間違いによる 400 エラーを避けるため、fetch の前に使用してください。

4. リクエストを送信する

# POST
npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}'

# GET
npx agentcash@latest fetch '<url>?param=value'

fetch は有料ルートと SIWX ルートの両方に対応します。ルートが認証をサポートしている場合は認証を試み、認証後も支払いが必要な場合にのみ支払います。ワークフローで複数のリクエストを行う場合は、関連する呼び出しで同じ --payment-network を指定してください。

5. fetch-auth は旧式のエイリアスです

npx agentcash@latest fetch-auth <url>

fetch-auth は引き続き動作しますが、fetch の非推奨エイリアスです。新しいワークフローではすべて fetch を使用してください。

利用可能なサービス

AgentCash を使うと、支払いで保護されたエンドポイントにアクセスできます。npx agentcash@latest discover <origin> がデータを返す場合は、npx agentcash@latest add <origin> を使ってスキルに保存することもできます。

重要：ユーザーがここに記載されていないサービスを使う場合、またはワークフローをより細かく制御したい場合は、必ずそのサービス用の軽量なスキルを追加するよう提案してください：npx agentcash@latest add <origin>。

Origin	機能
stableenrich.dev	FullEnrich（人物・企業の検索）、PDL と Minerva（人物情報の拡充）、CompanyEnrich（企業プロフィール）、Clado（連絡先）、Exa（ウェブ検索）、Firecrawl（スクレイピング）、Cloudflare（サイトのクロール）、Google Maps + Solar + Aerial View、Serper（ニュース／ショッピング／画像／レンズ）、Whitepages、Reddit、Hunter（メールアドレスの検証）
stablesocial.dev	ソーシャルメディアデータ：TikTok、Instagram、YouTube、Facebook、LinkedIn、Reddit、Rumble、GitHub、広告ライブラリ（Scrape Creators）、さらに Lightreel UGC リサーチエージェント（1 回の呼び出しにつき $0.06、非同期ジョブ）
stablestudio.dev	AI 画像・動画生成：GPT Image、Flux、Grok、Nano Banana、Sora、Veo、Seedance、Wan、画像から SVG への変換
stableupload.dev	ファイルホスティング（サイズに応じて $0.005～$2.00）と、カスタムドメイン対応の静的サイトホスティング
stableemail.dev	メールの送信（$0.02）、転送用受信トレイ（$1/月）、カスタムサブドメイン（$5）、プログラムから利用できるメールボックス
stablephone.dev	AI 電話（$0.54）、電話番号（$20）、チャージ（$15）、iMessage／FaceTime の検索（$0.05）
stablejobs.dev	Coresignal による求人検索（プレビュー：1 ページあたり $0.10、収集：1 件あたり $0.20）
stabletravel.dev	航空券の価格と予約（Google Flights）、特典航空券の空席状況（Seats.aero）、リアルタイムのフライト追跡と空港データ（FlightAware）
stablebrowser.dev	クラウドブラウザーの自動化：セッションを作成（$0.10）し、その後、AI を活用した移動／操作／抽出／監視／スクリーンショットの取得（無料の SIWX）

ここに記載されている以外にも、多数のサービスを利用できます。

任意の origin で npx agentcash@latest discover <origin> を実行すると、すべてのエンドポイントのカタログを確認できます。

重要なルール

• 該当する origin が一覧にある場合は、検索を省略してください。 そのまま discover を実行してください。search を使うのは、「利用可能なサービス」の表に該当する origin がない場合に限ります。
• 推測する前に、必ず discover を実行してください。 エンドポイントのパスにはプロバイダーのプレフィックスが含まれます（例：/people-search ではなく /api/fullenrich/people-search）。
• instructions フィールドを確認してください。 必須の実行順序、複数ステップのワークフロー、ポーリング方法、プロバイダー固有の制約が記載されています。
• 支払いが確定するのは成功時のみです。 失敗したリクエスト（2xx 以外）には料金がかかりません。
• 高額な処理の前に残高を確認してください。 動画生成は 1 回の呼び出しにつき $1～$3 かかる場合があります。

ヒント

• リクエストまたはレスポンスの形式が不明な場合は、npx agentcash@latest check <url> を使ってください。
• 機械可読な出力には --format json、人が読みやすい出力には --format pretty を追加してください。
• Base と Solana の両方の決済ネットワークに対応しています。エンドポイントで指定されているネットワークか、ユーザーが資金を保有しているネットワークを使ってください。

トラブルシューティング

問題	解決策
"Insufficient balance"	balance を実行し、その後 fund または accounts を実行するか、招待コードを引き換えてください
"Payment failed"	リクエストを再試行してください
"Invalid invite code"	コードは使用済みか、存在しません
残高が更新されない	ネットワークでの確認を待ってから、balance を再実行してください
AgentCash が使われない	npx agentcash@latest add <origin> を実行して、エンドポイントをスキルに保存してください