# Airbnb Adr Simulator

> Fetch Airbnb income estimate (ADR, occupancy, monthly revenue) for any area using the official Airbnb GraphQL API — the same data the Airbnb host simulator shows. Input: station/area name. Output: per-night rate, avg nights, monthly estimate for entire_home and private_room.

- Skill: `t4ku/airbnb-adr-simulator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add t4ku/airbnb-adr-simulator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/t4ku/airbnb-adr-simulator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Finance & Business
- Author: t4ku (https://skillmd.com/u/t4ku)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/t4ku/airbnb-adr-simulator

---


# Airbnb ADR Simulator

Airbnb 公式ホストシミュレーターと同じデータを GraphQL API で取得する。
エリア名（駅名など）を入力すると、一棟貸し・一室貸しの ADR・稼働日数・月収試算を返す。

## Setup

```bash
export AIRBNB_API_KEY="<your_key>"
```

### API キーの取得方法

Airbnb は公式には API キーを配布していないが、ホストシミュレーターページから抽出できる。

**方法1: DevTools で取得（推奨）**
1. ブラウザで https://www.airbnb.jp/host/homes を開く
2. DevTools → Network タブ → フィルタに `GetHostEstimateData` と入力
3. リクエストをクリック → Request Headers の `X-Airbnb-API-Key` の値をコピー

**方法2: JS バンドルから取得**
```bash
curl -s "https://www.airbnb.jp/host/homes" \
  | grep -o '"X-Airbnb-API-Key":"[^"]*"' | head -1
```

同様に persisted query hash も DevTools で取得:
- Request Payload → `extensions.persistedQuery.sha256Hash` の値をコピー
- `export AIRBNB_GQL_HASH="<your_hash>"` で環境変数に設定する

> ⚠️ キーとハッシュはローテーションされることがあるので、動かなくなったら再取得する。

## Usage

```bash
python3 scripts/airbnb_adr.py "すすきの駅"
python3 scripts/airbnb_adr.py "渋谷駅"
python3 scripts/airbnb_adr.py "すすきの, 札幌市"
```

出力例:
```
📍 すすきの駅 → すすきの, 札幌市中央区...
🏨 一棟貸し (ENTIRE_HOME / 1BD / 4名)
   単価:   ¥25,261/泊
   稼働:   24泊/月 (80%)
   月収:   ¥606,262
   距離:   ✅ 0.1km

🛏 一室貸し (PRIVATE_ROOM / 1BD / 2名)
   単価:   ¥10,363/泊
   稼働:   15泊/月 (50%)
   月収:   ¥155,452
   距離:   ✅ 0.2km
```

## API Details

- **Endpoint**: `POST https://www.airbnb.jp/api/v3/GetHostEstimateData`
- **API Key header**: `X-Airbnb-API-Key: <key>` (DevTools から取得)
- **Operation**: `GetHostEstimateData` (persisted query)
- **Hash**: DevTools の Request Payload → `extensions.persistedQuery.sha256Hash`
- **location 型**: `{"searchQuery": "エリア名"}` ← `{"query": ...}` ではない
- **durationGranularity**: `["MONTHLY"]` 必須

room_type は `ENTIRE_HOME`（一棟）と `PRIVATE_ROOM`（一室）を別クエリで取得する。

## Distance Verification

Nominatim で駅座標を取得し、API が返すリスト物件の重心との距離を計算。
エリアのサジェストがズレていないか確認するためのバリデーション。

- ✅ 1km以内 — 精度高
- 🟡 1〜3km — 要注意
- ⚠️ 3km超 — エリア名を変えて再試行

## Pitfalls

- **location 入力が超敏感**: `"すすきの, 札幌市"` と `"札幌市 すすきの"` は別エリアに解釈される。駅名単体（`"すすきの駅"`）が最も精度が高い
- **Nominatim レートリミット**: 連続呼び出しは 1 秒以上間隔を空ける
- **稼働日数は `sections[2].value`**: API レスポンスの `header.sections[2]` がエリア実績の平均稼働泊数（自前で仮定しない）
- **月収は `earningsEstimateListNative[max(0, avg_nights - 1)]`**: スライダーのインデックスと対応（`avg_nights == 0` は先頭要素に丸める）

## Script

`scripts/airbnb_adr.py` — スタンドアロンで動く CLI スクリプト。`AIRBNB_GQL_HASH` は取得後に環境変数で設定が必要。