# OTAの予約が急に止まった原因を「公開クチコミの日付分布」で切り分ける 宿泊施設の OTA（Booking.com 等）で**ある日を境に受注が激減した**とき、原因候補 （重複掲載・競合の新規参入・値上げ・掲載順位）を**最小の手数で潰す**ための手順。 競合や他人の掲載は内部数字が見えないが、**公開クチコミの日付は誰でも取れる**ので、 これを実売の代理指標にして時系列を比べる。 読者は AI エージェント（Claude Code / Codex 等）を想定。そのまま実行できる粒度で書く。 --- ## 0. 前提 - 自社の予約データ（PMS / チャネルマネージャの受注一覧）が手元にあること - Node.js 18+ と Playwright（`npm i playwright && npx playwright install chromium`） - **断絶の日付が特定済み**であること。まだなら先に「受注が作られた日」の日次件数を出す。 到着日ベースで見ると断絶が1〜2ヶ月ずれて見えるので、**必ず予約作成日で見る**。 --- ## 1. 順番を間違えない — 「誰が」より先に「いつ」 疑わしい原因を見つけたら、**深掘りする前に「それはいつ生まれたか」を1回測る。** 断絶の日付と発生時期が合わなければ、そこで仮説は終わる。 > 実例: 同じ住所に掲載が3本ある（重複掲載）と判明し「これが原因」と結論しかけたが、 > 重複2本の最古クチコミは断絶の **9ヶ月前と6ヶ月前**だった。時期が合わないので引き金ではない。 > 「その掲載は誰のものか」を管理画面で調べる工数は丸ごと不要になった。 --- ## 2. 奪い合い仮説は「相手も一緒に落ちていないか」で否定できる A の需要を B が奪ったのなら、**A が落ちる月に B は伸びる**。 両方が同じ月に落ちているなら、効いているのは当事者間の競争ではなく **両者を含む上位のレイヤー**（住所・エリア単位の露出、プラットフォーム側の措置、規制）。 これは**相関の向きを1回見るだけ**で判定できる。競合分析を丸ごと省ける。 --- ## 3. 代理指標を使う前に、自前データで倍率を確かめる クチコミ件数は実売そのものではない。使う前に、**自分の掲載で 「自前の予約データ ↔ クチコミ件数」が対応するか**を必ず検算する。 - **ずれの向きを合わせる**。受注月と宿泊月は 1〜2ヶ月ずれる。 受注 N月 ≒ 宿泊 N+1月 なら、クチコミ（宿泊年月）も1ヶ月ずらして比べる。 - **季節性は前年同月で否定する**。前年の同じ月が同水準なら季節ではない。 - **直近1〜2ヶ月はクチコミが遅れて届く**ので、下振れを結論に使わない。 --- ## 4. 取得スクリプト（Booking.com の実測済み仕様） 物件ページ URL は `https://www.booking.com/hotel/<国コード>/<掲載slug>.<言語>.html`。 | 用途 | セレクタ / 実測値 | |---|---| | クチコミ一覧を開く | `[data-testid="fr-read-all-reviews"]`（無ければ `[data-testid="review-score-read-all"]`） | | クチコミ1件 | `[data-testid="review-card"]`（1ページ10件） | | 投稿日 | `[data-testid="review-date"]` → `投稿日：2026年8月29日` | | 宿泊年月 | `[data-testid="review-stay-date"]` → `2026年8月` | | 泊数 | `[data-testid="review-num-nights"]` → `2泊 ·` | | 部屋タイプ | `[data-testid="review-room-name"]` | | 次ページ | `button[aria-label="次のページ"]`（ページ番号は `aria-label="ページ 3"`） | | 総件数 | body テキストの `クチコミ（<数字>件）`（全角カッコ） | ```js import { chromium } from 'playwright'; const browser = await chromium.launch({ headless: true }); const ctx = await browser.newContext({ locale: '<ロケール>', // 例: ja-JP viewport: { width: 1400, height: 2200 }, userAgent: '<デスクトップChromeのUA文字列>', }); const page = await ctx.newPage(); await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 90000 }); await page.waitForTimeout(8000); // 描画待ち。短いとカードが0件になる const total = (await page.evaluate(() => document.body.innerText)) .match(/クチコミ（(\d+)件）/)?.[1]; await page.click('[data-testid="fr-read-all-reviews"]'); await page.waitForTimeout(6000); const reviews = []; let lastSig = null; const maxPages = Math.min(45, Math.ceil((total ?? 450) / 10)); for (let p = 1; p <= maxPages; p++) { for (const card of await page.$$('[data-testid="review-card"]')) { const get = async (s) => (await card.$(s))?.innerText().then((t) => t.trim()) ?? null; reviews.push({ postDate: (await get('[data-testid="review-date"]'))?.match(/(\d{4})年(\d{1,2})月(\d{1,2})日/), stay: (await get('[data-testid="review-stay-date"]'))?.match(/(\d{4})年(\d{1,2})月/), }); } // 最終ページでも「次のページ」に disabled が付かないことがある。 // 内容が前ページと同一なら重複計上する前に止める。 const sig = reviews.slice(-10).map((r) => `${r.postDate?.[0]}|${r.stay?.[0]}`).join(','); if (sig === lastSig) { reviews.length -= 10; break; } lastSig = sig; const next = await page.$('button[aria-label="次のページ"]'); if (!next || (await next.getAttribute('aria-disabled')) === 'true') break; await next.click(); await page.waitForTimeout(2500); } ``` --- ## 5. ここで必ず踏む落とし穴 1. **最終ページで「次のページ」が disabled にならない。** 素直に押し続けると同じ10件を何周も計上して件数が数倍に膨らむ。 **総件数から出したページ数**と**前ページとの内容一致**の**両方**で止める。 2. **年月の繰り上げを `new Date(y, m, 1)` で書くと2ヶ月飛びになる** （JS の月は0始まりなので `m` は既に翌月）。表の縦計と取得件数を突き合わせれば必ず気付く。 **集計表には必ず「計」の行と「取得件数」の行を並べて出す。** 3. **分母を出さない集計は信用しない。** 「取得できた件数 / 掲載上の総件数 / 取得率」を必ず出力する。 取得率が 100% でないなら、どの掲載で何件落ちたかも書く。 4. **並列で回さない。** 掲載ごとに順番に処理する。同時アクセスはブロックされる。 5. **1件も取れなかった掲載があるなら「差が無い」ではなく「判定不能」。** exit code を分ける。 --- ## 6. 機械判定（exit code） 人が目視で判断すると結論が揺れるので、**判定条件をスクリプトに書いて exit code で返す**。 | exit | 意味 | |---|---| | 1 | 疑わしい掲載の**最古クチコミが断絶の前後1ヶ月以内** ＝ 時期が合う。深掘りする価値あり | | 0 | 疑わしい掲載は**断絶より前から存在** ＝ 引き金ではない。仮説を捨てる | | 2 | どれか1つでもクチコミが0件 ＝ 判定不能。**どの掲載が取れなかったかを必ず出力** | 出力に必ず含めるもの: - 掲載ごとに `取得件数 / 掲載上の総件数 / 取得率 / 最古の投稿日 / 最新の投稿日 / 最古の宿泊年月` - **掲載 × 宿泊年月**の件数テーブル（縦計つき） - 判定に使った値そのもの（「2026-04 以降か: false」のような真偽値） --- ## 7. ここまでで分かること・分からないこと **分かる**: 疑わしい掲載がいつからあるか / 落ちたのが自分だけか全員か / 落ちた月が正確にいつか。 **分からない**: その掲載が誰のものか / プラットフォーム側が何をしたか。 これらは**管理画面（エクストラネット）にしか無い**。 公開情報で詰められるところまで詰めてから管理画面に行くと、見るべき画面が1枚に絞れる。 > 見ていない画面の操作手順を推測で書くと、ラベルや現在値が実物と違って相手に手戻りが出る。 > **開けない画面はスクリーンショットを1枚もらってから手順を書く。** ---