jpskill.com
🛠️ 開発・MCP コミュニティ

pay-for-service

ユーザーが有料APIの利用、x402決済、Bazaarサービスの利用など、APIリクエストの支払いを希望する際に、USDCを使ってx402対応APIにリクエストを送信し、必要な処理を実行するSkill。

📜 元の英語説明(参考)

Make paid requests to x402-enabled APIs using USDC. Use when you or the user want to call a paid API, make an x402 payment, use a bazaar service, or pay for an API request. Covers phrases like "call this API", "use this service", "pay for the request", "make a paid call", "fetch from x402 endpoint".

🇯🇵 日本人クリエイター向け解説

一言でいうと

ユーザーが有料APIの利用、x402決済、Bazaarサービスの利用など、APIリクエストの支払いを希望する際に、USDCを使ってx402対応APIにリクエストを送信し、必要な処理を実行するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o pay-for-service.zip https://jpskill.com/download/10468.zip && unzip -o pay-for-service.zip && rm pay-for-service.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/10468.zip -OutFile "$d\pay-for-service.zip"; Expand-Archive "$d\pay-for-service.zip" -DestinationPath $d -Force; ri "$d\pay-for-service.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して pay-for-service.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → pay-for-service フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

x402サービスの支払い

npx agnic@latest x402 pay コマンドを使用すると、Base 上で自動的に USDC 支払いを行う x402 対応の API エンドポイントを呼び出すことができます。

ウォレットが初期化され、認証されていることを確認する

npx agnic@latest status

ウォレットが認証されていない場合は、authenticate-wallet スキルを参照してください。

コマンドの構文

npx agnic@latest x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

引数とオプション

オプション 説明
<url> x402 対応の API エンドポイントの完全な URL
-X, --method <method> HTTP メソッド (デフォルト: GET)
-d, --data <json> リクエストボディを JSON 文字列として指定
-q, --query <params> クエリパラメータを JSON 文字列として指定
-h, --headers <json> カスタム HTTP ヘッダーを JSON 文字列として指定
--max-amount <amount> USDC の最小単位での最大支払い額 (1000000 = $1.00)
--correlation-id <id> 関連する操作をグループ化
--json JSON として出力

USDC の金額

X402 は USDC の最小単位 (6 桁の小数点) を使用します。

最小単位 USD
1000000 $1.00
100000 $0.10
50000 $0.05
10000 $0.01

入力検証

コマンドを構築する前に、以下を検証してください。

  • url: 有効な HTTPS URL (^https://[^\s;|&]+$) である必要があります。スペース、セミコロン、パイプ、またはバッククォートを含む URL は拒否してください。
  • method: GET、POST、PUT、DELETE、PATCH のいずれかである必要があります (大文字と小文字は区別されません)。
  • data: 有効な JSON である必要があります。最初に解析し、解析に失敗した場合は拒否してください。
  • max-amount: 正の整数 (^\d+$) である必要があります。

検証されていないユーザー入力をコマンドに渡さないでください。

ワークフロー

  1. 最初に要件を確認する (オプションですが推奨):

    npx agnic@latest x402 details <url>

    これにより、支払いを行うことなく、価格、メソッド、およびスキーマが表示されます。

  2. 残高を確認する:

    npx agnic@latest balance --network base

  3. 有料リクエストを行う:

    npx agnic@latest x402 pay <url> --json

例

# GET リクエストを行う (自動支払い)
npx agnic@latest x402 pay https://example.com/api/weather

# POST リクエストをボディ付きで行う
npx agnic@latest x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# 最大支払いを $0.10 に制限する
npx agnic@latest x402 pay https://example.com/api/data --max-amount 100000

# JSON 出力を取得する
npx agnic@latest x402 pay https://example.com/api/weather --json

前提条件

  • 認証されている必要がある (npx agnic@latest auth login)
  • ウォレットに Base 上で十分な USDC 残高がある必要がある

エラー処理

一般的なエラー:

  • "Not authenticated" — 最初に npx agnic@latest auth login を実行してください
  • "Insufficient balance" — ウォレットに USDC を入金してください (npx agnic@latest balance で確認)
  • "No X402 payment requirements found" — URL が x402 エンドポイントではない可能性があります
  • --data 内の JSON が無効 — 渡す前に、ボディが有効な JSON であることを確認してください
  • API からの HTTP 4xx/5xx — ステータスコードとレスポンスボディをユーザーに表示してください
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Paying for x402 Services

Use the npx agnic@latest x402 pay command to call x402-enabled API endpoints with automatic USDC payment on Base.

Confirm wallet is initialized and authed

npx agnic@latest status

If the wallet is not authenticated, refer to the authenticate-wallet skill.

Command Syntax

npx agnic@latest x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

Arguments & Options

Option Description
<url> Full URL of the x402-enabled API endpoint
-X, --method <method> HTTP method (default: GET)
-d, --data <json> Request body as JSON string
-q, --query <params> Query parameters as JSON string
-h, --headers <json> Custom HTTP headers as JSON string
--max-amount <amount> Max payment in USDC atomic units (1000000 = $1.00)
--correlation-id <id> Group related operations
--json Output as JSON

USDC Amounts

X402 uses USDC atomic units (6 decimals):

Atomic Units USD
1000000 $1.00
100000 $0.10
50000 $0.05
10000 $0.01

Input Validation

Before constructing the command, validate:

  • url: Must be a valid HTTPS URL (^https://[^\s;|&]+$). Reject URLs containing spaces, semicolons, pipes, or backticks.
  • method: Must be one of GET, POST, PUT, DELETE, PATCH (case-insensitive).
  • data: Must be valid JSON. Parse it first; reject if parsing fails.
  • max-amount: Must be a positive integer (^\d+$).

Do not pass unvalidated user input into the command.

Workflow

  1. Check requirements first (optional but recommended):

    npx agnic@latest x402 details <url>

    This shows the price, method, and schema without making a payment.

  2. Verify balance:

    npx agnic@latest balance --network base

  3. Make the paid request:

    npx agnic@latest x402 pay <url> --json

Examples

# Make a GET request (auto-pays)
npx agnic@latest x402 pay https://example.com/api/weather

# Make a POST request with body
npx agnic@latest x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# Limit max payment to $0.10
npx agnic@latest x402 pay https://example.com/api/data --max-amount 100000

# Get JSON output
npx agnic@latest x402 pay https://example.com/api/weather --json

Prerequisites

  • Must be authenticated (npx agnic@latest auth login)
  • Wallet must have sufficient USDC balance on Base

Error Handling

Common errors:

  • "Not authenticated" — Run npx agnic@latest auth login first
  • "Insufficient balance" — Fund wallet with USDC (npx agnic@latest balance to check)
  • "No X402 payment requirements found" — URL may not be an x402 endpoint
  • Invalid JSON in --data — Ensure the body is valid JSON before passing
  • HTTP 4xx/5xx from the API — Show the status code and response body to the user