extract-data

データ抽出

セマンティック優先

1. tabs_context → tabId を取得
2. sm_capabilities(tabId) — 登録済みフェッチ定義を確認
3. 該当があれば → sm_fetch(tabId, fetch_id) を使用（より高速で信頼性が高い）

アドホック抽出

セマンティック定義がない場合:

1. read_page(tabId, filter: "all") → ページ構造を把握（大規模ページでは mainOnly: true で <main> に限定）
2. page_data_extract(tabId, schema) → スキーマベースで抽出

スキーマ例

単一値: { "title": { "selector": "h1", "type": "text" } }

アイテムリスト:

{
  "items": {
    "selector": ".product-card",
    "type": "list",
    "fields": {
      "name": ".product-name",
      "price": ".product-price",
      "url": { "selector": "a", "type": "attribute", "attribute": "href" }
    }
  }
}

代替手段: get_page_text(tabId) でプレーンテキスト取得（query でセマンティックフィルタ、maxChars で出力文字数制限（デフォルト 50000））、javascript_exec(tabId, code) でカスタムロジック実行。

AJAX バッチ収集

ログインセッションが必要な AJAX エンドポイントから大量データを収集:

1. read_network_requests(tabId, clear: true) → バッファクリア + Network 有効化
2. UI 操作（ドロップダウン変更等）→ AJAX リクエスト発生
3. read_network_requests(tabId, include_body: true) → エンドポイントと postData を特定
4. batch_fetch(tabId, url, requests, extractor, file_path) → 全組み合わせを一括収集

javascript_exec + file_path で大量データをローカルファイルに直接保存可能。

Google Sheets からの抽出

Google Sheets ページでは専用ツールが高速:

• sheets_info(tabId) — シート構成を確認
• sheets_read(tabId) — 全データ取得
• sheets_read(tabId, query: "SELECT A,B WHERE C > 100") — tq クエリでフィルタ・集計
• sheets_read(tabId, range: "A1:D10", formulas: true) — 数式を取得

繰り返し抽出するなら？ /setup-page → /create-scenario → /run-job で自動収集を構築。