bitrefill

Bitrefill

デジタル商品（ギフトカード、モバイルチャージ、eSIM）— 180か国以上、1,500以上のブランドに対応。支払い方法：暗号資産、Lightning、USDC x402、事前チャージ残高。

実行環境 × ウォレット × 接点でルーティングします。それぞれのレイヤーを検出してガイドを読み、ケースに合った、HITLが最も少ないスタックを選びます。

ユーザー向けの表現

コンシェルジュのような語り口にします。暗号資産での購入は、ウォレットを送金するのではなく、ギフトカードを買うように感じられるべきです。ユーザーの目に触れるすべての場所に適用します。アシスタントのメッセージ、思考の要約、ツール呼び出しのタイトルも含まれます。一貫してユーザーの言語に合わせてください。すべての文言をローカライズし、イタリア語（またはその他の言語）のセッションに英語のテンプレートをそのまま貼り付けないでください。

使用する表現：「そのギフトカードを検索します」·「Baseウォレットで一度サインインしてください」·「Base Accountで支払いを承認してください」·「コードの準備ができました。」

使用しない表現： Path 1/2、Step 1/2/3、harness、touchpoint、x402、MCP、SIWX、JWT、connector、endpoint、script、invoice、flusso ottimale、micro-fee、guest checkout、account not connected — また、内部ツールやルートの名前も使用しないでください。

内部表現	代わりに使う表現
connect / SIWX / JWT	「Baseウォレットで一度サインインしてください」（無料 — 閲覧するだけです）
search / detail	「[商品]を検索しています…」
invoice/create	「[商品] — [金額]：合計[合計額] USDCです。確認しますか？」
invoice/pay / x402 pay	「Base Accountで支払いを承認してください」
poll / delivery	「コードの準備ができました。」

フロー： ユーザーに見えるメッセージは4件以内にします — （1）必要に応じて、目的と最初の承認、（2）価格の明細と確認、（3）支払いの承認、（4）受け渡し。ユーザーの操作が必要なステップの間は、ツール呼び出しだけにします。ブロックまたはエラーが発生していない限り、状況を逐一伝えないでください。ルーティングは表に出さずに決定し、プロセスではなく目的から話し始めます。それぞれの事実は一度だけ伝え、ポーリングは黙って行います（ユーザーに確認を促さないでください）。

明細（1件のメッセージ）： 商品 · 額面 · USDCの正確な合計額（ネットワーク） · 残高 · 有効期限 · 必要に応じて1つの節で為替レート。受け渡し： コードと、返金不可であることを一度だけ中立的に伝えます。

リファレンスガイドのバナー（各ガイドの先頭にそのままコピー）：内部の仕組み — 決して口に出さないでください。ツールの操作、思考、タイトルは、日常的な買い物の表現にしてください：「ウォレットでサインイン」「支払いを承認」「コードの準備ができました」。x402 / SIWX / JWT / path / endpoint は決して使わないでください。

BitrefillへのサインインがまだでもBaseウォレットが使える場合は、ウォレットで一度サインインしてから閲覧し、支払いを一度承認します。検索のたびに別途手数料を請求することはありません。ホスト固有の表現については、claude-chat.md § ユーザー向けの表現を参照してください。

ルーティング方法

安全対策 → safeguards.md。その後、3つのフェーズに進みます — 各レイヤーのガイドを読んでから操作してください。

1. 実行環境を検出 → 実行環境の手順を読む

使用しているホストを調べます（exec/shell、egress、MCPコネクター、ブラウザー、生成UI）。プロファイルに照らし合わせて、該当する実行環境のドキュメントを開いてください。その内容は一般的な既定値より優先されます。

検出したもの	読むドキュメント
Claude Chat（show_widgetまたはread_me、claude.ai上のMCP）	claude-chat.md
OpenClaw（~/.openclaw/、PATH上のopenclaw）	openclaw.md
Grok BotまたはCursor（Botのクラウドコンピューター、Cursor IDE、CLI、またはクラウドエージェント）	grok-bot.md
既知のホストで、既定値が必要な場合	capability-matrix.md
検出シグナルと導出ルール	decision-engine.md § フェーズ1

実行環境のドキュメントには、禁止事項（Claude ChatではCLIを使用しない、サンドボックスからcurlしないなど）と、ホスト固有の優先順位付きスタックが記載されています。

2. ウォレットを検出する → ウォレットの手順を読む

カタログのチャネルとは独立して、このセッションで利用可能な決済機能を確認します。

シグナル	ウォレットのドキュメント
Bitrefill にサインイン済みで、チャージ済みの残高がある	payment.md — balance + auto_pay
Base MCP（get_wallets、sign、x402、send）	base-mcp.md。ゲストのサインイン → siwx.md
AgentCash / CDP awal	agentcash.md、cdp-awal.md
Phantom / MetaMask（署名のみ）	phantom.md、metamask.md
ウォレット間のランキング	matrix.md

プローブの完全な一覧 → decision-engine.md § Phase 2。

3. このケースに適したタッチポイント × ウォレットを選ぶ

ハーネスの制限、ウォレットの利用可否、意図（閲覧か購入か、Bitrefill アカウントかゲストの USDC か）を照らし合わせます。機能するスタックの中から、人間の介入が最も少なくて済むものを選び、タッチポイントのドキュメントを読んで実行します。

タッチポイント（カタログ／チェックアウトのチャネル — 最初に利用可能なものを選択）：

条件	読むもの
search-products / buy-products が表示されている（OAuth または API キー）	mcp.md
Base MCP の web_request + ゲストの USDC、Bitrefill アカウントなし	x402.md — ウォレットでサインイン（Path 1）。ペイ・パー・コールではありません
シェル + npm、Bitrefill MCP なし	cli.md
直接 HTTP のみ	api.md
閲覧のみ + 住宅用ブラウザー	browse.md
いずれも利用不可	ユーザーに bitrefill.com のリンクを送信

決済時のウォレット — 選択したタッチポイントで利用できる最適なものを選択 → payment.md、matrix.md。一般的な組み合わせ：

タッチポイント	優先するウォレット
Bitrefill MCP	balance + auto_pay → Base MCP で決済 → 決済リンク
ゲストのチェックアウト（x402 REST）	AgentCash / awal → Base MCP でサインインして決済 → サインインが機能する場合、閲覧にペイ・パー・コールを使わない
CLI	buy-products の実行時に、上記と同じウォレット順位を適用

競合の解決方法 + 全体の順位 → decision-engine.md § Phase 3。

支出に関する主な安全対策

実際のお金を使う取引です。 コードは即時発行されます。デジタル商品は履行後に返金できません。

• ユーザーがこのセッションでの自律購入を許可していない限り、購入前に確認してください。
• コードは現金同様です — 公開チャネルには決して貼り付けず、メモリー内で扱うことを推奨します。
• 自律購入には残高の少ない専用アカウントを使用してください — エージェントにウォレットのシードを決して渡さないでください。スキルはウォレットではありません。
• 購入をすべて記録してください — invoice_id、商品、金額、決済方法。

安全対策の全容 + ホストごとの強化策 → safeguards.md。

リファレンス

ハーネス

ファイル	使用する場面
decision-engine.md	機能のプローブ + 導出
capability-matrix.md	ホストごとの実行／エグレス／順位付けされたスタック
openclaw.md	OpenClaw Gateway — exec 経由のゲスト CLI
claude-chat.md	claude.ai — MCP を優先 + show_widget

タッチポイント

ファイル	使用する場面
mcp.md	Bitrefill MCP が OAuth 認証済み
x402.md	Base MCP または直接のエグレス経由の x402 REST
cli.md	シェル + @bitrefill/cli ≥ 0.3.0
cli-headless-auth.md	AgentMail / マジックリンクでのサインイン
api.md	v2 REST — Personal / Business / Affiliate
browse.md	閲覧のみの住宅用ブラウザー

ウォレット

ファイル	使用する場面
matrix.md	ウォレット × 接点 × HITL のランキング
payment.md	決済時の判断ツリー
base-mcp.md	Base MCP の web_request、x402、send
siwx.md	接続 → JWT、引き換え時の SIWX
agentcash.md	fetch による自律的な x402
cdp-awal.md	Coinbase Agentic Wallet / awal
metamask.md	MetaMask Agent Wallet（mm CLI）
phantom.md	Phantom MCP による署名のみ

横断的な項目

ファイル	使用する場面
safeguards.md	支出ポリシーとホストの強化
troubleshooting.md	すべての経路におけるエラー

信頼できる情報源

スキルは要約と案内を行います。網羅的な列挙型 → https://docs.bitrefill.com.