Bankr Agent - Error Handling について
Bankr APIの認証やジョブ失敗を調べるトラブルシューティングスキルです。エラー別の確認・解決手順を示し、認証情報の修正を優先して再試行しないケースも説明します。
主な機能
- 01401認証エラーの調査
- 02一般的なジョブ失敗の解決策
- 03HTTPステータスコードの対応指針
- 04接続と残高の確認
- 05ユーザーへのエラー説明手順
活用シーン
- 01無効なAPIキーの修正
- 02取引ジョブ失敗の診断
- 03レート制限やサーバーエラーへの対応
- 04ユーザーへの解決手順の案内
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/bankr-agent---error-handlingを入力して読み込まれたか確認します。
詳細
Bankr のエラー処理
Bankr API のエラーと認証の問題を解決します。
認証エラー（401）
症状
- HTTP 401 ステータスコード
- 「Invalid API key」または「Unauthorized」というメッセージ
解決方法
次の設定手順をユーザーに提示してください。
手順 1：API キーを作成する
Visit https://bankr.bot/api to create a new API key
手順 2：環境変数を設定する
# Add to shell profile (~/.zshrc or ~/.bashrc)
export BANKR_API_KEY=bk_your_api_key_here
手順 3：Claude Code を再起動する
Close and reopen the terminal/Claude Code session
重要：認証に失敗した場合は、再試行しないでください。まずユーザーが API キーを修正する必要があります。
よくあるジョブの失敗
| エラー | 原因 | 解決方法 |
|---|---|---|
| 残高不足 | トークンが不足しています | 残高を確認し、数量を減らしてください |
| トークンが見つかりません | シンボルまたはアドレスが無効です | トークンがチェーン上に存在することを確認してください |
| スリッページ超過 | 価格が大きく変動しました | 再試行するか、数量を減らしてください |
| トランザクションがリバートしました | オンチェーンで失敗しました | トランザクションの詳細を確認してください |
| レート制限を超過しました | リクエストが多すぎます | 待ってから再試行してください |
HTTP ステータスコード
| コード | 意味 | 対応 |
|---|---|---|
| 400 | 不正なリクエスト | プロンプトの形式を確認してください |
| 401 | 認証されていません | API キーを修正してください（上記を参照） |
| 402 | 支払いが必要です | ウォレットに Base 上の BNKR があることを確認してください |
| 429 | レート制限中です | 待ってから再試行してください |
| 500 | サーバーエラー | 少し待ってから再試行してください |
トラブルシューティングチェックリスト
- API キー：設定済みで、
bk_から始まり、設定後に Claude Code を再起動している - ネットワーク：インターネットが動作しており、api.bankr.bot にアクセスできる
- 取引の場合：ウォレットに十分な残高があり、トークンがチェーン上に存在する
エラーをユーザーに報告する
- 何が起きたのかを簡潔に伝えます
- 具体的な解決手順を提示します
- 専門用語は避けます
- 代替案を提案します
例：
Your Bankr API key is not configured. To set it up:
1. Visit https://bankr.bot/api to create an API key
2. Set BANKR_API_KEY in your environment
3. Restart Claude Code
コメント
Markdown 対応