southwest

@striderlabs/mcp-southwest

Southwest Airlines 向け MCP サーバー — ブラウザー自動化を通じて、フライトの検索、予約の管理、チェックイン、Rapid Rewards アカウントの管理ができます。

機能

• フライトを検索 — すべての運賃クラスのリアルタイム料金を確認できます
• 運賃を比較：Wanna Get Away、Wanna Get Away+、Anytime、Business Select
• ドルまたは Rapid Rewards ポイントでフライトを予約
• 予約を管理：変更、キャンセル、詳細の取得
• 変更手数料なし — Southwest では変更手数料はかかりません
• オンラインでチェックイン（出発のちょうど24時間前から利用できます）
• グループと位置（A/B/C）付きの搭乗券を取得
• Early Bird Check-In — 出発の36時間前に自動チェックインします
• Rapid Rewards — ポイント残高、会員ステータス、Companion Pass の達成状況を確認できます

前提条件

• Node.js 18+
• Playwright ブラウザー：npx playwright install chromium

インストール

npm install -g @striderlabs/mcp-southwest
# or
npx @striderlabs/mcp-southwest

セットアップ

環境変数

.env ファイルを作成するか、環境変数として設定します。

# Required for account-based tools (check-in, Rapid Rewards, points booking)
SW_USERNAME=your_rapid_rewards_number_or_email
SW_PASSWORD=your_password

# Optional
SW_HEADLESS=true   # Set to "false" to see the browser (useful for debugging)

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "southwest": {
      "command": "npx",
      "args": ["@striderlabs/mcp-southwest"],
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

または、グローバルにインストールした場合：

{
  "mcpServers": {
    "southwest": {
      "command": "mcp-southwest",
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

利用可能なツール

search_flights

利用可能な Southwest のフライトを検索します。

{
  "originAirport": "DAL",
  "destinationAirport": "LAX",
  "departureDate": "2024-06-15",
  "passengers": 2,
  "tripType": "oneway",
  "fareType": "USD"
}

get_flight_details

特定のフライトのステータスと詳細を取得します。

{
  "flightNumber": "WN1234",
  "flightDate": "2024-06-15",
  "originAirport": "DAL",
  "destinationAirport": "LAX"
}

select_flight

検索結果からフライトを選択し、予約に進みます。

{
  "flightIndex": 0,
  "fareType": "wanna-get-away"
}

get_fares

料金と特典を含め、運賃クラスを比較します。

{
  "originAirport": "HOU",
  "destinationAirport": "MCO",
  "departureDate": "2024-07-04",
  "fareType": "USD"
}

add_early_bird

既存の予約に Early Bird Check-In を追加します（1人・1フライトあたり約15～25ドル）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

checkout

搭乗者情報と支払い情報を指定して予約を完了します。

{
  "firstName": "Jane",
  "lastName": "Smith",
  "dateOfBirth": "01/15/1990",
  "gender": "F",
  "email": "[email protected]",
  "phone": "5551234567",
  "cardNumber": "4111111111111111",
  "cardExpiration": "12/26",
  "cardCvv": "123",
  "cardZip": "75201",
  "cardName": "Jane Smith",
  "addEarlyBird": false
}

get_reservation

確認番号を使って予約を検索します。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

change_flight

既存の予約を変更します（変更手数料はかかりません！）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "newDepartureDate": "2024-06-20"
}

cancel_flight

予約をキャンセルします。実際にキャンセルするには confirm: true を指定します。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "confirm": true
}

check_in

オンラインでチェックインします（出発の24時間前から利用できます）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

get_boarding_pass

グループと位置番号が記載された搭乗券を取得します。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "savePath": "~/boarding-pass.pdf"
}

get_rapid_rewards

Rapid Rewards のポイント、会員ステータス、Companion Pass の達成状況を確認します。

{}

（SW_USERNAME/SW_PASSWORD 環境変数を使用します）

book_with_points

フライトを検索し、Rapid Rewards ポイントを使って予約します。

{
  "originAirport": "DAL",
  "destinationAirport": "DEN",
  "departureDate": "2024-08-10",
  "passengers": 1
}

Southwest Airlines の運賃クラス

運賃	払い戻し可能	ポイント倍率	搭乗
Wanna Get Away	旅行資金	基本の6倍	通常
Wanna Get Away+	譲渡可能な資金	基本の8倍	通常
Anytime	全額払い戻し	基本の10倍	優先（A1～A15）
Business Select	全額払い戻し	基本の12倍	A1～A15を保証

Southwest の搭乗システム

Southwest は自由席制で、座席指定はありません。搭乗者は次のグループに分かれて搭乗します。

• グループ A（A1～A60）：Early Bird／Business Select／Anytime の優先搭乗
• グループ B（B1～B60）：通常搭乗
• グループ C（C1～C60）：最後に搭乗

チェックインの順番によって搭乗位置が決まります。最適な位置を確保するには、出発の24時間前ちょうどにチェックインしてください。

セッションの保持

再実行のたびに再認証する必要がないよう、ログインセッションは ~/.config/mcp-southwest/session.json に保存されます。

開発

git clone https://github.com/markswendsen-code/mcp-southwest
cd mcp-southwest
npm install
npx playwright install chromium
npm run build
npm start

ホットリロードを使って開発する場合：

npm run dev

自動化中にブラウザーを表示する場合（デバッグに便利です）：

SW_HEADLESS=false npm run dev

ライセンス

MIT © Strider Labs