cryptorefills-catalog

Cryptorefills カタログ — 閲覧と検索

読み取り専用の商品検索です。Cryptorefills で利用できる商品を見つけたり、検索、比較、確認したりしたいユーザーには、このスキルを使用します。

購入する場合は、次の手順に従ってください。

• cryptorefills-buy — あらゆる暗号資産決済方法に対応した、ガイド付きの MCP 購入ワークフロー
• cryptorefills-x402 — Base 上の USDC を使った自律型エージェントコマース（アカウント不要）

ユーザーの意図が閲覧から購入に移ったら、このスキルのツールの使用を停止し、上記の該当する購入スキルの手順に切り替えてください。

有効化するタイミング

• Bitcoin、Ethereum、Solana、USDC、その他の暗号資産で購入できるギフトカード、携帯電話のチャージ、eSIM の検索、閲覧、比較をユーザーが求めている
• ユーザーが Cryptorefills に言及している、または特定の国で利用できる商品を知りたがっている
• ユーザーが価格、利用可否、対応国、決済通貨について質問している
• ユーザーが特定の言語でカタログ情報を求めている
• キーワード：「ギフトカードを探す」、「どんなブランドがあるか」、「旅行用 eSIM」、「携帯電話にチャージ」、「[国]で利用可能」、「bitcoin で購入」、「ethereum で購入」、「solana で購入」、「暗号資産ギフトカード」

MCP 接続

フィールド	値
サーバー URL	https://api.cryptorefills.com/mcp/http
トランスポート	HTTP
必須ヘッダー	User-Agent: Cryptorefills-MCP/1.0

Claude Code MCP の設定で構成するには：

{
  "mcpServers": {
    "cryptorefills": {
      "url": "https://api.cryptorefills.com/mcp/http",
      "headers": { "User-Agent": "Cryptorefills-MCP/1.0" }
    }
  }
}

利用可能なツール

ツール	目的
searchProducts	ブランド名、国、言語、カテゴリーでフリーテキスト検索
listBrands	国で利用可能なすべてのブランドを閲覧
listProductsForCountry	国別の商品カタログ全体。ブランド、ファミリー、コインで絞り込み可能
getCurrencies	対応する決済用暗号資産をステータスとともに一覧表示
getPaymentViasWithCurrencies	決済方法と対応通貨・ネットワークの対応関係を表示

クイック判断フロー

User intent
├─ "Find me a specific brand" → searchProducts(country_code=XX, q=brand)
├─ "What's available in [country]?" → listBrands(country_code=XX)
├─ "Show me all [category] options" → listProductsForCountry(country_code=XX, family=...)
├─ "What crypto can I pay with?" → getCurrencies() or getPaymentViasWithCurrencies()
└─ "I want to buy"
   ├─ Agent has USDC wallet on Base + can sign EIP-712 → cryptorefills-x402
   └─ Otherwise (human-guided, multi-currency) → cryptorefills-buy

タスクの流れ

ブランドで検索

1. ユーザーにブランド名と国を尋ねます
2. country_code（大文字：US、IT、BR）と q（検索テキスト）を指定して searchProducts を呼び出します
3. 該当する商品を額面と価格とともに提示します
4. ユーザーが購入を希望した場合 → cryptorefills-buy の手順に切り替えます

国で閲覧

1. ユーザーに国を尋ねます（または文脈から判断します）
2. country_code を指定して listBrands を呼び出します
3. category（例：e-commerce、games、streaming）ごとにブランドをまとめて提示します
4. ユーザーがブランドを選んだら、詳細を確認するため listProductsForCountry を呼び出します

カテゴリーを確認

1. ユーザーの国を指定して listBrands を呼び出します
2. 結果を category フィールドごとにまとめます。カテゴリーは固定値ではなく、レスポンスから動的に検出されます
3. カテゴリーとブランド数を提示します
4. 結果を絞り込んでカテゴリーの詳細を確認します

決済オプションを確認

1. 対応コインを提示するため getCurrencies を呼び出します
2. ネットワークの詳細を確認するため getPaymentViasWithCurrencies を呼び出します
3. チェーン／アセット情報とともに決済方法を提示します

多言語対応

ツールに lang パラメーターを渡します。対応言語：en、es、fr、de、it、pt、zh、tr、vi、tl。利用できない場合は英語にフォールバックします。

ブランド名の照合

API のレスポンスに含まれるブランド名には、接尾辞が付く場合があります（例：「Claro」ではなく「Claro Credits」、「Vivo」ではなく「Vivo Credits」、「Apple」ではなく「Everything Apple」）。必ず listBrands の brand の値をそのまま使用してください。一部一致では照合に失敗します。

ヒント

• 国コード — ISO 3166-1 Alpha-2 の大文字を使用します（例：US、IT、BR）。注：x402 スキルでは小文字を使用します。エンドポイントごとに形式が異なります
• 国は商品の地域と一致させる必要があります — 米国向けギフトカードは米国でのみ使用できます
• 電話番号 — 携帯電話のチャージには E.164 形式（+1234567890）が必要です
• 金額指定商品 — 金額を提案する前に、is_dynamic フラグと min／max の値を確認します
• プロモーション — listBrands はプロモーションコードと顧客 ID のパラメーターに対応しています

制限事項

このスキルは読み取り専用です。注文の作成や支払いの処理はできません。

• 商品を購入する場合 → cryptorefills-buy に切り替えてください（すべての支払い方法に対応し、ガイド付きのフローを利用できます）
• 自律型エージェントによる購入の場合 → cryptorefills-x402 に切り替えてください（Base 上の USDC を使用し、アカウントは不要です）

参考資料

このスキルファイルより詳しい情報が必要な場合にのみ、参考資料を読み込んでください。

ファイル	読み込むタイミング…	内容
references/product-types.md	商品タイプの違い、固定価格と価格帯の違い、または配達の詳細について質問された場合	ギフトカード、携帯電話のチャージ、eSIM の詳細ガイド
references/search-guide.md	MCP ツールの呼び出しに必要な正確なパラメーター名や型を確認する場合	MCP ツールのパラメーター、例、検索戦略
references/categories.md	利用可能なカテゴリについて質問された場合、または確認済みのブランド名が必要な場合	カテゴリ体系、国別の確認済みブランド