clawcard

clawcard CLI を使用して ClawCard にアクセスできます。すべてのコマンドは、機械可読な出力を得るための --json に対応しています。これらのコマンドを呼び出すときは、必ず --json を指定してください。

クイックスタート

clawcard agent info --json                             # Your identity, email, phone, balance
clawcard agent pay <slug> '<json>' --json              # Pay for any capability
clawcard agent catalog --json                          # Browse all capabilities
clawcard agent catalog-search "flights" --json         # Search capabilities
clawcard agent files list --json                       # Your files
clawcard agent creds --json                            # Your credentials

新しいリソースを作成する前に、必ず既存のリソースを確認してください。 購入の前には毎回カードを一覧表示してください。同じ加盟店用の、利用可能な merchant_locked カードを再利用してください。

主な機能

機能	コマンドのリファレンス
メール（送信、受信、読み取り）	reference/email.md
SMS（送信、受信）	reference/sms.md
バーチャルカード（作成、支払い、管理）	reference/cards.md
ファイルストレージ（アップロード、一覧表示、ダウンロード）	reference/files.md
認証情報（シークレットの保存、取得）	reference/credentials.md
ブラウザーでのチェックアウト（移動、フォーム入力、支払い）	reference/checkout.md

カタログ — 約300種類の有料 API 機能

エージェントは、カタログを通じて約300種類の有料機能を利用できます。すべての呼び出しでアカウント残高が差し引かれます。

任意の機能を利用する方法：

clawcard agent pay <slug> '<json body>' --json

カタログ全体を表示： clawcard agent catalog --json キーワードで検索： clawcard agent catalog-search "web scraping" --json

カテゴリ	例	価格帯	リファレンス
検索	web-search, news-search, image-search	$0.01-0.09	reference/catalog-search.md
スクレイピングと抽出	scrape-url, crawl-site, extract-data	$0.01-0.05	reference/catalog-scrape.md
人物と企業	enrich-person, enrich-company, find-contacts, find-email	$0.01-0.06	reference/catalog-enrich.md
ソーシャルメディア	tiktok-profile, instagram-posts, reddit-search	$0.06	reference/catalog-social.md
メディア生成	image-gen, music-gen, transcribe, text-to-speech	$0.03-0.11	reference/catalog-media.md
金融と市場	stock-quote, sec-filings, exchange rates	$0.01-0.06	reference/catalog-finance.md
旅行	flight-search, hotel-search	$0.01-0.06	reference/catalog-travel.md
地図と天気	geocode, directions, weather	$0.01	reference/catalog-maps.md
コンピューティング	run-code, screenshot	$0.01-0.06	reference/catalog-compute.md
リファレンス	wolfram, translate	$0.01-0.06	reference/catalog-reference.md
マーケティングと SEO	seo-keywords	$0.01-0.03	reference/catalog-marketing.md
ニッチなデータ	sneaker-prices, property-value	$0.01-0.04	reference/catalog-data.md

重要：非同期機能

一部の機能（動画生成、音楽生成、詳細調査、ウェブサイトのクロール）は完了までに時間がかかります。すぐに結果を返す代わりに、ジョブ／タスク ID を返します。結果を取得するには、対応するステータススラッグを必ずポーリングしてください。

ポーリングのたびに料金が発生します。 残高を無駄に消費しないよう、ポーリングの間隔を10～15秒空けてください。

音楽生成の実行例：

# 1. Start generation ($0.11)
clawcard agent pay music-gen '{"prompt":"upbeat lo-fi beat","customMode":false,"instrumental":true,"model":"V4"}' --json
# → returns { data: { data: { taskId: "abc123" } } }

# 2. Wait 15 seconds, then poll ($0.01 per poll)
clawcard agent pay music-status '{"taskId":"abc123"}' --json
# → returns status: "PENDING" or "TEXT_SUCCESS" or "FIRST_SUCCESS" with audioUrl

非同期機能のステータススラッグ：

• music-gen → music-status でポーリング
• lyrics-gen → lyrics-status でポーリング
• image-gen-gpt, image-gen-nano, video-gen-*（StableStudio）→ stablestudio-status でポーリング
• stability-3d, stability-audio → stability-status でポーリング
• replicate-run → replicate-status でポーリング
• clado-deep-research → clado-research-status でポーリング
• allium-sql → allium-sql-status でポーリングし、その後 allium-sql-results を実行
• dune-sql → dune-results でポーリング
• tako-deep-search → tako-deep-status でポーリング
• crawl-site → crawl-status でポーリング
• deep-research → parallel-task-status でポーリング

ブラウザーでのチェックアウト（MCP）

ウェブサイトで商品を購入する場合（ドメイン、サブスクリプション、SaaS の登録など）は、clawcard-browser MCP サーバーを使用します。ClawCard Pay 拡張機能を備えたブラウザーを起動します。

セットアップ： ブラウザーの MCP ツールが利用できない場合は、ユーザーが設定できるようサポートしてください。

• Claude Code： clawcard mcp または claude mcp add clawcard-browser -e CLAWCARD_API_KEY=<key> -- npx @clawcard/browser
• mcporter（OpenClaw など）： ~/.mcporter/mcporter.json に追加します。

  "clawcard-browser": {
    "command": "npx",
    "args": ["@clawcard/browser"],
    "env": { "CLAWCARD_API_KEY": "<key>" }
  }
  

• Cursor / VS Code： .cursor/mcp.json または MCP 設定に、上記と同じ形式で追加します。

フロー：

1. カードを作成します：clawcard agent cards create --amount <cents> --type merchant_locked --memo "description" --json
2. ブラウザーを起動します：チェックアウト URL を指定して launch_browser ツールを使用します。
3. snapshot、click、fill を使用して、支払い情報以外の項目に入力し、ページを操作します。
4. 支払い情報を入力します：カード ID と請求先情報を指定して fill_checkout ツールを使用します。
5. 拡張機能がカード番号、有効期限、CVC を直接入力します。カード番号が表示されることはありません。
6. ページを確認して送信します。

MCP ツール：

ツール	機能
launch_browser	ClawCard Pay 拡張機能を備えたブラウザーを開きます
navigate	URL に移動します
snapshot	@e1 参照を含むページのアクセシビリティツリーを取得します
click	参照を指定して要素をクリックします
fill	参照を指定してフィールドに入力します
detect_checkout	ページがチェックアウト画面かどうかを確認します（確信度と金額を返します）
fill_checkout	カード情報と請求先情報を安全に入力します（カード情報が LLM に渡ることはありません）
screenshot	ページをキャプチャします
close_browser	セッションを閉じます

セキュリティ： カード情報（PAN、CVV）はサーバーからブラウザー拡張機能に直接送信されます。LLM がカード番号を見たり、扱ったりすることはありません。返されるのは下 4 桁のみです。

ヒント

• API の機能を利用する場合は、clawcard agent pay を使用してください。残高から自動的に支払いを行います。
• ウェブサイトで商品を購入する場合は、仮想カードと clawcard-browser MCP ツールを使用してください。
• 既定では merchant_locked カードを使用してください。single_use は一度限りの購入にのみ使用してください。
• サブスクリプションの支払いを絶対に黙って行わないでください。必ず事前にユーザーに警告してください。
• 必要な機能がある場合は、カタログを検索してください：clawcard agent catalog-search "<what you need>" --json
• 残高を追加するには、clawcard billing topup を使用してください。