mcpField
H
http-request

http-request

github.com/winsorllc開発069 回インストール36 週間前に更新
リポジトリ

http-request について

HTTP リクエストを送るコマンドラインスキルで、API 呼び出し、テスト、データ取得に利用できます。複数のリクエストメソッド、JSON 処理、認証、フォーム送信、レスポンス保存に対応します。

主な機能

  1. 01GET、POST、PUT、PATCH、DELETE の送信
  2. 02JSON リクエストボディとレスポンス整形
  3. 03Bearer、Basic、カスタムヘッダー認証
  4. 04フォームデータとファイルのアップロード
  5. 05リダイレクト、タイムアウト、レスポンス保存

活用シーン

  1. 01認証が必要な API エンドポイントの呼び出し
  2. 02JSON データの送信とレスポンス確認
  3. 03ファイルのアップロードやレスポンスの保存

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/winsorllc/upgraded-carnival --skill http-request

インストール後、Claude Code で/http-requestを入力して読み込まれたか確認します。

同梱ファイルindex.jsrequest.sh

詳細

HTTP リクエストスキル

出力を拡張し、JSON を処理する HTTP リクエストを実行します。

使用する場合

✅ 次の場合にこのスキルを使用します：

  • 「GET リクエストを…に送信して」
  • 「この JSON を POST して」
  • 「この API エンドポイントを呼び出して」
  • 「URL からデータをダウンロードして」
  • 「API をテストして」

使用しない場合

❌ 次の場合はこのスキルを使用しないでください：

  • 単純なファイルのダウンロード → web-fetch/download.sh を使用
  • ブラウザーの自動化 → browser-tools を使用
  • ウェブスクレイピング → web-fetch を使用

コマンド

GET リクエスト
{baseDir}/request.sh GET "https://api.example.com/data"
{baseDir}/request.sh GET "https://api.example.com/data" --json
{baseDir}/request.sh GET "https://api.example.com/data" --header "Authorization: Bearer token"
POST リクエスト
{baseDir}/request.sh POST "https://api.example.com/create" --data '{"name": "test"}'
{baseDir}/request.sh POST "https://api.example.com/create" --file data.json
{baseDir}/request.sh POST "https://api.example.com/upload" --form "[email protected]"
PUT/PATCH/DELETE
{baseDir}/request.sh PUT "https://api.example.com/update/1" --data '{"name": "updated"}'
{baseDir}/request.sh PATCH "https://api.example.com/patch/1" --data '{"status": "active"}'
{baseDir}/request.sh DELETE "https://api.example.com/delete/1"
認証あり
{baseDir}/request.sh GET "https://api.example.com/private" --auth bearer:TOKEN
{baseDir}/request.sh GET "https://api.example.com/private" --auth basic:user:pass
{baseDir}/request.sh GET "https://api.example.com/private" --header "X-API-Key: secret"
カスタムオプション
{baseDir}/request.sh GET "https://api.example.com" --timeout 60
{baseDir}/request.sh GET "https://api.example.com" --follow --max-redirects 5
{baseDir}/request.sh GET "https://api.example.com" --verbose

オプション

  • --data <json>：リクエスト本文（JSON 文字列）
  • --file <path>：ファイルからリクエスト本文を読み込みます
  • --form <data>：フォームデータまたはファイルのアップロード（@filename）
  • --header <header>：カスタムヘッダー（複数指定可能）
  • --auth <type:credentials>：認証（bearer:TOKEN または basic:user:pass）
  • --timeout <sec>：リクエストのタイムアウト（デフォルト：30）
  • --json：JSON レスポンスを整形します
  • --verbose：リクエストの詳細を表示します
  • --follow：リダイレクトを追跡します
  • --max-redirects <n>：リダイレクトの最大数（デフォルト：5）
  • --out <file>：レスポンスをファイルに保存します

例

JSON を取得して整形する：

{baseDir}/request.sh GET "https://jsonplaceholder.typicode.com/users" --json

データを POST する：

{baseDir}/request.sh POST "https://api.example.com/users" \
  --data '{"name": "John", "email": "[email protected]"}' \
  --json

Bearer トークンを使用する：

{baseDir}/request.sh GET "https://api.example.com/protected" \
  --auth bearer:your_token_here

ファイルをアップロードする：

{baseDir}/request.sh POST "https://api.example.com/upload" \
  --form "[email protected]"

注意事項

  • JSON データの場合、Content-Type: application/json を自動的に追加します
  • レスポンス本文の解析に対応しています
  • --verbose を指定するとレスポンスヘッダーを表示します
  • マルチパートフォームデータのアップロードに対応しています

コメント

Markdown 対応