AirROI Airbnb MCP Server

---

AirROI の Airbnb MCP サーバーは、Claude、Codex、Cursor、VS Code、その他すべての Model Context Protocol クライアントに、Airbnb と短期賃貸市場データ用の29 個のツールを提供します。稼働率、ADR、RevPAR、収益パーセンタイル、比較対象、収益予測、Airbnb のリアルタイムカレンダーと検索順位、価格の推奨などに対応しています。190 か国以上、2,000 万件以上のリスティングをカバーし、継続的に保守されるデータセットに基づいて回答するため、アシスタントが airbnb.com をスクレイピングする必要はありません。

このリポジトリにはドキュメントのみが含まれています。サーバーは完全なリモート型で、https://mcp.airroi.com で利用できます。インストールや実行は不要です。AirROI は独立したデータプロバイダーであり、Airbnb とは提携していません。2026 年 9 月現在、Airbnb の公式 MCP サーバーや公開 API はありません。

エンドポイント	https://mcp.airroi.com
トランスポート	Streamable HTTP（リモート）
認証	X-API-KEY ヘッダー。すべてのリクエストで必須
ツール	29 個（市場分析 11 個、リスティング 13 個、検索・推定 3 個、価格設定 2 個）
料金	1 回あたり $0.01 から。従量課金制
レジストリ	公式 MCP Registry の com.airroi/mcp
ドキュメント	https://www.airroi.com/mcp-server

どの Airbnb MCP サーバーが必要ですか？

「Airbnb MCP サーバー」は、3 種類の異なるものを指すことがあります。用途に応じて選んでください。

目的	サーバーの種類	例	AirROI？
宿泊先を探す	リスティング検索スクレイパー	Apify、Bright Data	いいえ
自分のリスティングを運営する（メッセージ、予約、カレンダー）	物件管理サーバー	Hospitable、Guesty	いいえ
市場、物件、または比較対象を分析する	市場データ MCP	AirROI	はい

料金と制限事項を並べて比較：https://www.airroi.com/mcp-server/compare

API キーを取得する

1. https://www.airroi.com/api で無料の API キーを登録します
2. https://www.airroi.com/api/developer/activate の開発者ダッシュボードで有効化し、キーをコピーします。
3. 以下のスニペットで X-API-KEY ヘッダーの値として使用します。置き換えるのは YOUR_API_KEY のみです。

ツールの検出（tools/list）には課金されませんが、すべてのリクエストでキーが必要です。

セットアップ

クライアント別の詳細ガイド：Claude · Codex と ChatGPT · その他すべてのクライアント

Claude Code

claude mcp add --transport http airroi \
  https://mcp.airroi.com \
  --header "X-API-KEY: YOUR_API_KEY" --scope user

claude mcp get airroi で確認し、Claude に市場について質問してください。

Claude Desktop

Claude Desktop は、mcp-remote ブリッジを介してカスタムヘッダー付きのリモートサーバーに接続します（Node.js が必要です）。~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集し、アプリを再起動します。

{
  "mcpServers": {
    "airroi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.airroi.com",
        "--header",
        "X-API-KEY:${AIRROI_API_KEY}"
      ],
      "env": { "AIRROI_API_KEY": "YOUR_API_KEY" }
    }
  }
}

X-API-KEY:${AIRROI_API_KEY} では、コロンの前後にスペースを入れないでください。

Codex（CLI、IDE 拡張機能、ChatGPT デスクトップアプリ）

3 つとも ~/.codex/config.toml を読み込みます。

[mcp_servers.airroi]
url = "https://mcp.airroi.com"
env_http_headers = { "X-API-KEY" = "AIRROI_API_KEY" }

次に、シェルのプロファイルで export AIRROI_API_KEY=YOUR_API_KEY を実行します。codex mcp list でヘッダー認証が Auth: Unsupported と表示されますが、これは想定どおりです。ChatGPT のウェブ版（開発者モード）は API キーを使うサーバーに対応していないため、Codex を使用してください。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）：

{
  "mcpServers": {
    "airroi": {
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

VS Code（Copilot エージェントモード）

.vscode/mcp.json。トップレベルのキーは mcpServers ではなく servers です。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "airroi-key",
      "description": "AirROI API key",
      "password": true
    }
  ],
  "servers": {
    "airroi": {
      "type": "http",
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${input:airroi-key}" }
    }
  }
}

Devin Desktop（旧 Windsurf）

~/.config/devin/mcp_config.json（Windows：%APPDATA%\devin\mcp_config.json）：

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

Antigravity CLI（Gemini CLI の後継）

~/.gemini/config/mcp_config.json（グローバル）または .agents/mcp_config.json（プロジェクト）：

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "YOUR_API_KEY" }
    }
  }
}

n8n

1. AI Agent ノードを追加し、MCP Client Tool ノードを接続します。
2. エンドポイントに https://mcp.airroi.com を設定し、トランスポートに HTTP Streamable を選択します。
3. Header Auth を選択し、名前を X-API-KEY、値をご自身のキーにした認証情報を作成します。

OpenAI Agents SDK (Python)

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="airroi",
        params={
            "url": "https://mcp.airroi.com",
            "headers": {"X-API-KEY": os.environ["AIRROI_API_KEY"]},
        },
    ) as airroi:
        agent = Agent(name="STR analyst", mcp_servers=[airroi])
        result = await Runner.run(
            agent, "Occupancy and ADR for 2-bedroom homes in Nashville?"
        )
        print(result.final_output)

asyncio.run(main())

stdio のみのクライアント

npx mcp-remote https://mcp.airroi.com --header X-API-KEY:${AIRROI_API_KEY}

実際のセッション

プロンプトを mcp.airroi.com の稼働中サーバーで実行します。

2ベッドルームの一棟貸し Airbnb について、オースティンとナッシュビルを比較してください。稼働率、ADR、RevPAR、年間収益、競合するリスティングの数を教えてください。

ツール呼び出し：airroi_search_markets → airroi_search_markets → airroi_market_summary → airroi_market_summary → airroi_market_revenue → airroi_market_revenue（費用 $0.42）

過去12か月間、ナッシュビルの2ベッドルームの一棟貸しは、リスティングあたりの収益がより高く、平均年間収益は40,075ドルでした。オースティンは24,965ドルです。稼働率はほぼ同じ（49％対48％）のため、この差は宿泊料金によるものです。ナッシュビルのADRは296ドル、オースティンは236ドルで、RevPARはそれぞれ146ドルと114ドルです。また、ナッシュビルは2ベッドルームの供給が少なく、月あたりのアクティブなリスティング数は約1,270件で、オースティンは約2,029件です。両市場とも、中央値のリスティングにとって最も好調だったのは2025年10月で、ナッシュビルは5,009ドル、オースティンは3,941ドルでした。

ほかのセッション（ライブ検索順位、オーナーレポート、今後のペース、リスボン）：https://www.airroi.com/mcp-server/use-cases

ツール（29）

リスティング、料金、予約、メッセージを変更できるツールはありません。26個のツールは読み取り専用として指定されており、残りの3個はダウンロードファイルまたはスキャンカーソルを作成します。

マーケット分析（11）

ツール	内容	1回あたりの料金
airroi_market_min_nights	マーケット全体の月ごとの平均最低宿泊日数の設定とパーセンタイル別の内訳を追跡します。稼働率や料金の推移とあわせて、地域の宿泊制限を把握するために使用します。	$0.10
airroi_market_summary	稼働率、ADR、RevPAR、リスティングあたりの平均年間収益、予約リードタイム、宿泊日数、最低宿泊日数、アクティブなリスティング数などの主要統計情報を含む、マーケットの概要をすばやく取得します。任意のマーケットについて、過去12か月間のスナップショットを1回の応答で返します。	$0.10
airroi_market_metrics_all	すべてのマーケット指標を1つの応答にまとめて取得します。稼働率、ADR、RevPAR、収益、リードタイム、宿泊日数、最低宿泊日数、アクティブなリスティング数について、パーセンタイル別（平均、p25、p50、p75、p90）の内訳を含む月次時系列データを返す、最も包括的な単一ツールです。	$0.50
airroi_market_occupancy	月次時系列データを使用して、稼働率の過去の推移と季節的な傾向を追跡します。平均値とパーセンタイル別の内訳を返し、需要のピーク時期や予約パターンの特定に役立ちます。	$0.10
airroi_market_adr	月次時系列データとパーセンタイル別の内訳を使用して、平均客室単価（ADR）の傾向を分析します。マーケット全体の料金の圧縮、季節変動、料金の成長を追跡します。	$0.10
airroi_market_revpar	稼働率と料金を単一のパフォーマンス指標にまとめた、販売可能な宿泊施設あたりの収益（RevPAR）を監視します。ベンチマークに使用できる、パーセンタイル分布を含む月次時系列データを返します。	$0.10
airroi_market_revenue	月次時系列データとパーセンタイル別の内訳を使用して、リスティングの収益を追跡します。投資機会の規模を評価するために、収益の成長傾向や季節的なパターンを分析します。	$0.10
airroi_market_lead_time	マーケットでゲストが何日前に予約するかを把握できます。月次時系列データを日数で示し、パーセンタイルも返すため、料金設定やマーケティングのタイミング戦略を最適化できます。	$0.10
airroi_market_los	ゲストの平均宿泊日数のパターンを、泊数で分析します。運営計画や最低宿泊日数の最適化に役立つ、パーセンタイル別の内訳を含む月次時系列データを返します。	$0.10
airroi_market_active_listings	アクティブなリスティング数を時系列で追跡し、マーケットの供給増加を監視します。月次時系列データを使用して、新規参入、マーケットの飽和、競争環境の変化を特定します。	$0.10
airroi_market_future_pacing	今後の日付を対象とした、先行予約ペースのデータを取得します。需要予測や収益予測に役立つ、予約済み件数、予約可能件数、平均料金、予約充足率を含む日次ペースデータを返します。	$0.20

マーケット検索と収益予測（3）

ツール	内容	1回あたりの料金
airroi_search_markets	前方一致で名称から短期賃貸マーケットを検索します。すべてのマーケットツールで必要となる、マーケットの正確な識別情報（国、地域、地域内の場所、地区）とアクティブなリスティング数を返します。	$0.01
airroi_lookup_market	GPS座標から、すべてのマーケットツールで必要となる正確なマーケット識別情報（国、地域、地域内の場所、地区）を特定します。search_markets の逆の機能です。地名ではなく緯度・経度がある場合に使用します。	$0.01
airroi_estimate_revenue	寝室数、バスルーム数、宿泊可能人数に基づいて、任意の場所の収益予測を生成します。予測年間収益、ADR、稼働率のパーセンタイル別内訳（p25～p90）、月別分布、類似するリスティングを返します。	$0.20

リスティングデータ（4）

ツール	説明	1回あたりの料金
airroi_get_listing	IDを指定して1件のAirbnbリスティングの全データを取得します。物件の詳細、説明文、写真のURL、チェックインとチェックアウトの時刻、ゲストに人気のステータス、料金、評価、過去12か月および直近90日間の稼働率、ADR、収益などのパフォーマンス指標を確認できます。	$0.10
airroi_batch_listings	1回の課金リクエストで、最大25件の物件の詳細情報を取得します。件数と、物件の全詳細情報およびIDごとのエラーを含むダウンロード可能なJSONリソースを返します。リソースをダウンロードしても、API呼び出しは繰り返されません。	$1.00
airroi_find_comparables	ロケーション、ベッドルーム数、バスルーム数、ゲスト定員に基づき、関連度順に最大25件の類似物件を検索します。座標または住所で場所を指定し、競合分析用に1～10マイルの範囲と部屋タイプを任意で指定できます。	$0.10
airroi_listing_metrics	リスティングごとに最大60か月分の過去のパフォーマンスデータを取得します。月ごとの稼働率、ADR、RevPAR、収益、平均最低宿泊数の設定を確認できます。トレンド分析、季節性の検出、投資引受に最適です。	$0.10

リスティングの検索とエクスポート（4）

ツール	説明	1回あたりの料金
airroi_search_by_market	OpenStreetMapのマーケット定義を使用して都市、地域、近隣エリア内の掲載中リスティングを検索します。マーケットを指定しない場合は、世界中を検索します。物件の属性、ホストの詳細、料金、評価、パフォーマンス指標で絞り込み、1回あたり最大10件の簡潔な概要を返します。	$0.50
airroi_search_by_radius	任意のGPS座標から1～100マイルの範囲内にある物件を検索します。ロケーションに基づく競合分析向けに、マーケット検索と同じ絞り込みと並べ替えに対応し、1回あたり最大10件の簡潔な概要を返します。	$0.50
airroi_search_by_polygon	3点以上の座標で定義したカスタム地理境界内のリスティングを検索します。任意の形状を描いて検索エリアを定義できるため、マーケットの詳細な区分や近隣エリアの分析が可能です。1回あたり最大10件の簡潔な概要を返します。	$0.50
airroi_export	マーケット、半径、カスタムポリゴンのいずれかのセレクターに一致するすべてのリスティングを、7日間有効な署名付きダウンロードURLで提供される単一のダウンロード可能なファイルにエクスポートします。全データセットが会話にストリーミングされることはありません。メタデータ、短いプレビュー、ローカル保存用のダウンロードリンクが提供されます。JSONL（1行につきネストされたリスティングオブジェクト全体を1つ）またはCSV（フラット化した概要列）を選択できます。ページネーションは最大100,000件まで内部で処理されます。非常に大規模なエクスポートでは、制限時間に達した場合、件数情報とともに部分ファイルが返されます。一括分析、データパイプライン、オフラインスクリプトに最適です。	$0.50（10件につき1回の呼び出し）

Airbnb のライブデータ（5）

ツール	内容	1 回あたりの料金
airroi_live_calendar	Airbnb からリスティングのカレンダーをリアルタイムで取得します。今後 12 か月分の 1 泊あたりの料金（清掃料金を除く）、空室状況、最低宿泊日数に加え、ホストの清掃料金と短期滞在向けの清掃料金も取得します。予約済みの夜とホストがブロックした夜は、どちらも空室なしとして表示されます。	$0.20
airroi_live_rates	今後 12 か月分のリスティングの 1 泊あたりの料金のみを、現地通貨または米ドルでリアルタイムに取得します。空室状況が不要な場合の競合料金の追跡に使用します。	$0.10
airroi_live_availability	今後 12 か月分のリスティングの空室状況と宿泊ルールをリアルタイムで取得します。空室または予約不可の日、最低・最大宿泊日数、各日付のチェックインまたはチェックアウトの可否を確認できます。	$0.10
airroi_live_search_ranking	マップ上の矩形範囲について、Airbnb の検索結果に表示されるリスティングを順位順（最大 270 件）に確認できます。競合と比較して、検索結果にリスティングがどの順位で表示されるかを調べる際に使用します。	$0.20
airroi_live_scan	カスタムポリゴン内にあるすべての Airbnb リスティング ID をリアルタイムで検索します。1 ページあたり最大 100 件の ID を取得できます。返された短い scan_id を使って続行します。サーバーがスキャンの進捗を保持するため、各ページは小さく保たれます。詳細情報を取得するには、get_listing または batch_listings と組み合わせてください。	$0.50

料金の推奨（2）

ツール	内容	1 回あたりの料金
airroi_recommend_base_price	物件の座標と既知の物件情報から、年間を通じた 1 泊あたりの基本料金を推定します。任意で設備、レビュー、その他の詳細を加えると、推定の精度を高められます。情報が保存または公開されることはありません。	$0.10
airroi_recommend_calendar_prices	座標、通貨、基本料金から 1 泊あたりの料金を算出します。モデル化された季節性、曜日、イベント、需要を、任意の料金ルール、季節ごとの上書き設定、料金の上限・下限、宿泊制限と組み合わせます。	$0.10

パラメーターを含む完全なリファレンス：https://www.airroi.com/mcp-server/tools

質問にかかる料金

一般的な市場分析には 6 回の呼び出しが必要です。

呼び出し	料金
airroi_search_markets	$0.01
airroi_market_summary	$0.10
airroi_market_occupancy	$0.10
airroi_market_adr	$0.10
airroi_market_revenue	$0.10
airroi_market_future_pacing	$0.20
合計	$0.61

料金一覧：https://www.airroi.com/api/pricing

データの対象範囲

• 190 以上の国と 30,000 以上の市場にある 2,000 万件以上のリスティング
• 月次の稼働率、ADR、RevPAR、売上高を p25／p50／p75／p90 のパーセンタイルとともに提供。1 回のリクエストあたり最大 60 か月分
• Airbnb のカレンダー、料金、空室状況、検索順位をリアルタイムで提供。最大 12 か月先まで
• 現地通貨、またはリクエストに応じて米ドル

リンク

• Airbnb MCP サーバーの概要：https://www.airroi.com/mcp-server
• Claude を Airbnb データに接続する：https://www.airroi.com/mcp-server/claude
• Codex と ChatGPT を Airbnb データに接続する：https://www.airroi.com/mcp-server/codex
• おすすめの Airbnb MCP サーバーの比較：https://www.airroi.com/mcp-server/compare
• 各クライアントのセットアップ：https://www.airroi.com/mcp-server/setup
• ツールのリファレンス：https://www.airroi.com/mcp-server/tools
• ユースケース：https://www.airroi.com/mcp-server/use-cases
• REST API（同じデータ、同じキー）：https://www.airroi.com/api

ライセンス

MIT。LICENSE を参照してください。