api-setup について
標準設定テンプレートを使って新しいAPI連携を構築するスキルです。連携ディレクトリの作成、認証情報の設定、接続テスト、一般的な問題の調査を支援します。
主な機能
- 01連携ディレクトリの作成
- 02JSON設定テンプレート
- 03API認証情報とエンドポイントの設定
- 04接続確認
- 05タイムアウトと認証エラーの調査
活用シーン
- 01新しいAPI連携の開始
- 02APIキーとエンドポイントの設定
- 03接続タイムアウトや401/403エラーの調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ block/ agent-skills --skill api-setupインストール後、Claude Code で/api-setupを入力して読み込まれたか確認します。
同梱ファイルsetup.shtemplates/config.template.json
詳細
API のセットアップ
このスキルは、標準設定で新しい API 統合をセットアップするのに役立ちます。
手順
setup.sh <api-name>を実行して、統合ディレクトリを作成しますtemplates/config.template.jsonを統合ディレクトリにコピーします- API 認証情報で設定を更新します
- 接続をテストします
設定
設定テンプレートには、次の項目が含まれています。
api_key:API キー(プロバイダーのダッシュボードから取得します)endpoint:API エンドポイントの URLtimeout:リクエストのタイムアウト時間(秒、デフォルト:30)
検証
セットアップ後、次の項目を確認します。
- 設定ファイルが有効な JSON である
- API キーが設定されており、プレースホルダーではない
- 接続テストが成功する
トラブルシューティング
接続のタイムアウト
接続がタイムアウトする場合:
- ネットワーク接続を確認します
- エンドポイントの URL が正しいことを確認します
- 設定内のタイムアウト値を増やします
認証エラー
401/403 エラーが発生する場合:
- API キーが正しいことを確認します
- キーに必要な権限があるか確認します
- キーの有効期限が切れていないことを確認します
コメント
Markdown 対応