# Airbnb ホスト画面の閲覧数・成約率を、ログイン済みの常駐ブラウザから自動で読む（クリックなし・JSON 化） > **目的と境界** > 人がログインした Chrome に CDP で接続し、実績ページの本文とリンクを読み取る。認証情報の入力や設定変更は行わない。取得できない値をゼロにせず、欠測と失敗理由を JSON に残す。 ## 1. 接続する前に 対象のホスト実績を取得できる一般公開 API はないため、ログイン済みの画面を読む。人が専用プロファイルの Chrome を CDP 有効で起動し、ログインを済ませて常駐させる。CDP はローカル接続に限定する。 AI に渡すのは、Airbnb 専用と確認済みの CDP 接続先、出力先、対象掲載の対応表だけとする。パスワードや Cookie の値を指示書・ログ・成果物へ書かない。他サービスのポートを探索したり、接続失敗時に Chrome を起動したりしない。 使用ライブラリは Node.js と Playwright。既存の常駐窓管理ツールがある場合は、その接続先と生存確認方法を先に読む。 ## 2. 読むページと本文の構造 閲覧数は `/performance/conversion/p3_impressions`、成約率は `/performance/conversion/conversion_rate` を読む。掲載単位の詳細は `/performance/conversion//listing/`。 観測した画面では `/hosting/performance` は 404、`/hosting/insights` はクオリティ画面へ転送された。実績の取得先には使わない。ただし画面構成は変わり得るので、本文の見出しも確認する。 一覧の本文には、全掲載ではなく下位10件だけが出る場合がある。「N件のリスティングを表示」は展開ボタンだが押さない。本文にない掲載は、事前に用意した掲載対応表を使い詳細ページで補う。総件数だけ分かっても、欠けた掲載の ID は推定できない。 本文は原則として1行1項目。表のヘッダは「リスティング名」「増減」「合計」、成約率では最後が「割合」になる。その後は公開タイトル、内部名、増減、値の4行を1組として読む。表の終端は `^\d+件のリスティングを表示$` で検出する。 増減には符号付き整数、符号なし整数、先頭空白付きの割合、欠測記号「—」がある。各行を trim しても、空行や欠測行を無条件で削除して4行の対応を崩してはいけない。行数や値の形式が合わなければ warning を出す。 上部 KPI は数値の次の行がラベルになる。ラベルを見つけ、その直前行を数値化する。期間は「N件のリスティングで、～の『…』は…」に相当する文から取り、更新日は「最終更新：」から取る。年が省略されている場合は原文を保持し、根拠なく年を補わない。 本文には名前と掲載 ID の対応がない。対象 metric の `/performance/conversion//listing/<数字>` に一致する `a[href]` を DOM 順で集め、表の行と index で対応させる。件数不一致なら、その表の ID は null にして warning を残す。詳細補完には別途確認済みの掲載対応表を使う。 ## 3. JSON と純関数の契約 最上位キーは `date`、`measuredAt`、`window`、`summary`、`listings`、`warnings`、`errors`、`exitCode` に固定する。 - `date` は指定タイムゾーンの計測日、`measuredAt` は ISO 形式の取得時刻。 - `window` は `from`、`to`、`lastUpdated`、`listingCount`。 - `summary` は平均閲覧数や平均成約率など、ラベルから取った KPI。 - `listings` の各要素は `name`、`publicTitle`、`listingId`、`views`、`viewsDelta`、`conversionRate`、`conversionDelta`、`sources`。 - `sources.views` と `sources.conversionRate` は `table`、`drilldown`、null のいずれか。増減も別に出所を持たせる。 欠測はすべて null。割合は % 単位の数として格納する。たとえば合成テスト値の `0.45` は `0.45%` を意味し、小数比率へ変換しない。真のゼロは保存する。 次の純関数を export し、ブラウザ操作から分離する。 - `parseMetricNumber`：空白、桁区切り、符号、% を処理し、欠測や不正値は null。 - `parseTable`：ヘッダと終端を検証し、4行ずつ解析する。 - `parseSummary`：ラベル候補配列で直前行を読む。 - `parseWindow`：期間、更新日、掲載数を抽出する。 - `parseDrilldown`：詳細のラベルと対象掲載を検証して値を読む。 - `pairRowsWithLinks`：件数一致時だけ ID を対応させる。 - `merge`：ID を主キーに統合し、欠測だけ補う。名前の曖昧一致で結合しない。 閲覧数の候補には「平均ページ閲覧数」、詳細には「合計ページ閲覧数」を使う。成約率は「全体の平均成約率」、詳細は「全体の成約率」。ほかに「検索1ページ目のインプレッション率」「検索からリスティング閲覧への平均コンバージョン率」「リスティング閲覧からの平均成約率」を扱い、「平均」の有無は候補配列で吸収する。 一覧と詳細の期間が違う値を混ぜない。期間を確認できない補完値は採用せず warning を残す。部分取得は exit 1、完全取得は exit 0、CDP 不通は exit 2 とする。 ## 4. 実装骨格 以下は接続と取得の骨格。`performance-parser.mjs` に前節の純関数と、本文待機・認証判定・期間照合を行う補助関数を実装する。`collect` は本文とリンクを保存し、`complete` は未取得の掲載・指標を判定する。 ```js import { chromium } from 'playwright'; import { initial, collect, merge, complete, finish, loginWall } from './performance-parser.mjs'; const cdp = process.env.AIRBNB_CDP_URL; const known = JSON.parse(process.env.LISTINGS_JSON || '[]'); const metrics = ['p3_impressions', 'conversion_rate']; const out = initial(); let page; let stage = 'cdp'; async function read(metric, id = null) { const suffix = id ? `/listing/${encodeURIComponent(id)}` : ''; const path = `/performance/conversion/${metric}${suffix}`; await page.goto(`https://www.airbnb.jp${path}`); await page.waitForLoadState('domcontentloaded'); if (await loginWall(page)) throw new Error('LOGIN_REQUIRED'); return collect(page, metric, id); } try { const endpoint = new URL(cdp); if (!['localhost', '127.0.0.1', '[::1]'].includes(endpoint.hostname)) throw new Error('LOCAL_CDP_REQUIRED'); const probe = await fetch(new URL('/json/version', endpoint), { signal: AbortSignal.timeout(5000) }); if (!probe.ok) throw new Error('CDP_UNAVAILABLE'); const browser = await chromium.connectOverCDP(cdp); stage = 'read'; const context = browser.contexts()[0]; if (!context) throw new Error('CONTEXT_MISSING'); page = await context.newPage(); for (const metric of metrics) { merge(out, await read(metric), 'table'); } for (const listing of known) { for (const metric of metrics) { if (!complete(out, listing, metric)) { merge(out, await read(metric, listing.listingId), 'drilldown'); } } } finish(out, known); } catch (error) { out.errors.push({ code: error.message }); out.exitCode = stage === 'cdp' ? 2 : 1; } finally { if (page) { await page.close().catch(() => { out.warnings.push('OWN_TAB_CLOSE_FAILED'); if (!out.exitCode) out.exitCode = 1; }); } process.stdout.write(JSON.stringify(out, null, 2) + '\n'); process.exitCode = out.exitCode; } ``` 接続は `connectOverCDP` だけを使う。閉じるのは自分で作ったタブだけ。`browser.close()`、click、fill、type、press は書かない。ログイン壁では exit 1 にし、人に認証を戻す。`process.exit()` は使わず、finally の後に正常終了できる構造にする。接続が残る場合も共有 Chrome を閉じず、実行側でクライアントプロセスだけを管理する。 ## 5. fixture と検証 fixture は保存した実ページの innerText から機械的に切り出す。人が記憶で書いたラベルを正解データにすると、「平均」の有無だけで本番が null になる。リンク順も同時保存する。 保存原本は非公開で管理し、公開用 fixture はタイトル・内部名・ID・日付・数値を機械的に置換する。行構造と欠測記号は保つ。欠測、真のゼロ、先頭空白、件数不一致、期間不一致を検証する。 - [ ] 実行前後に既存 keepalive の `--status` で常駐窓の生存を確認した。 - [ ] 認証必須ページを読んでログイン状態を確認した。 - [ ] JSON の null、warnings、errors、終了コードを確認した。 - [ ] 同じ期間のスクリーンショットと一覧・詳細の数値を照合した。 - [ ] 未表示掲載の補完と、既存タブが残っていることを確認した。 ## 6. read-only のコーディングエージェントへ渡す 参照ファイル、呼び出し契約、匿名化した実ページ fixture は spec に全文同梱する。「既存ファイルを読めば分かる」で済ませない。 1 run = 2ファイルとし、たとえば解析モジュールとテスト、次の run で取得スクリプトと実行テストを作る。出力は各ファイル全文の FILE ブロックで受け取る。 保存後に `node --check` と `node --test` を実行する。さらに rg または grep で `browser.close`、click、fill、type、press、`process.exit(`、他サービスのポートや接続先の混入を検査する。静的検査だけで完了にせず、実走後のチェックまで行う。 ---