Bright Data — Search

ウェブ上で何かを探す。このスキルには 2 つのコマンドが用意されています：

• bdata search — 従来のキーワード SERP (Google/Bing/Yandex)。「キーワード X で何がランクしているか」を知りたい場合に最適です。
• bdata discover — AI インテント順位付け付きディスカバリーとオプショナルなページコンテンツ。「トピック Y に関する、インテント Z に一致するページ」を見つけたい場合に最適です。

既知のプラットフォーム (Amazon、LinkedIn、TikTok など) から構造化データを取得する場合は、代わりに data-feeds を使用してください。

セットアップゲート（最初に実行）

if ! command -v bdata >/dev/null 2>&1; then
    echo "bdata CLI not installed — see bright-data-best-practices/references/cli-setup.md"
elif ! bdata zones >/dev/null 2>&1; then
    echo "bdata not authenticated — run: bdata login  (or: bdata login --device for SSH)"
fi

どちらかのチェックが失敗した場合は、skills/bright-data-best-practices/references/cli-setup.md にルーティングして停止してください。

パスを選択

状況	アクション
単一キーワードクエリ、SERP のみ	bdata search "<query>" --engine google --json --pretty
ページ分割された SERP（結果をさらに取得）	--page 0、--page 1 など（0 からの インデックス）でループ
複数クエリ	クエリファイル上でシェルループ
インテント順位付け／セマンティック（キーワード ではない）	bdata discover "<query>" --intent "<intent>" --num-results 20
結果とともにページボディも必要、1 回のパス	bdata discover ... --include-content
ニュース / 画像 / ショッピング SERP	bdata search "<query>" --type news（または images、shopping）
Amazon/LinkedIn/TikTok/… の構造化データを必要とする	停止 — data-feeds に引き継ぐ
URL を保有、コンテンツを必要とする	scrape に引き継ぐ

アクション

コアコマンド：

# Google SERP、構造化 JSON
bdata search "site:example.com privacy policy" --engine google --json --pretty

# ローカライズされた Bing（ドイツ語の結果、ドイツ語）
bdata search "datenschutz" --engine bing --country de --language de --json

# 結果の 2 ページ目（0 からのインデックス）
bdata search "machine learning papers" --page 1 --json

# モバイル SERP（デスクトップとは異なるランキング）
bdata search "best coffee shops" --device mobile --json

# ニュース縦型
bdata search "openai" --type news --json --pretty

# インテント順位付けディスカバリー
bdata discover "enterprise LLM platforms" \
    --intent "vendor pages with pricing" \
    --num-results 15 --json

# ページコンテンツを Markdown で含めたディスカバリー
bdata discover "webhook best practices" \
    --include-content --num-results 10 -o results.json

# 日付フィルタリング済みディスカバリー
bdata discover "react server components" \
    --start-date 2025-01-01 --end-date 2025-12-31 --num-results 20

完全なフラグリファレンス：references/flags.md

search vs discover — 正しいものを選択

必要なもの	使用
「このキーワードで Google がランク付けしているもの」	search
「この意味／インテントに一致するページ」	discover
「ニュース／画像／ショッピング縦型 SERP」	search --type <vertical>
「結果 + 1 回の呼び出しでページボディ」	discover --include-content
「クエリ間での重複排除／セマンティックランキング」	discover

検証ゲート

1. JSON がクリーンにパースされる： jq . <output> が 0 を返す。
2. 結果配列が空でない — 空の場合、クエリは正当にゼロ結果です。クエリを緩和して再実行してください。ユーザーに知らせずに空の結果で成功を主張しないでください。
3. 必須フィールドが存在：
   • search: 結果は .organic[] にあります。各結果に title + link がある
   • discover: 結果は .results[] にあります。各結果に title + link があります。--include-content の場合は、content も存在
4. discover --include-content の場合： content フィールドにブロックページシグネチャがない（scrape と同じリスト、大文字小文字を区別しない）：
   • Access Denied
   • Just a moment
   • Attention Required
   • Checking your browser
   • captcha
   • cf-browser-verification
   • cloudflare（合計ボディが < 2KB）
5. 地理的なサニティチェック： ユーザーが国別の結果を期待していた場合、トップ結果の TLD／言語を調査してください。ミスロケーション化されている場合は、明示的な --country と --language で再実行してください。

赤い旗

• Amazon、LinkedIn、TikTok などからコンテンツを取得するために search を使用して、data-feeds が 1 回の呼び出しでクリーンな構造化データを返す場合。
• SERP 結果をむやみに削除するために scraping する — 最初にフィルタリングする（ドメイン許可リスト、タイトルのキーワード、関連性ヒューリスティック）。
• search（キーワード）と discover（セマンティック）を混同する。異なる質問に答えます。
• scraping の前に結果セット全体で URL を重複排除することなく、複数クエリを実行する。
• SERP の順序が普遍的だと想定する — これは地理およびデバイスで個人化されます。再現性のために常に --country と --device を明示的に設定してください。
• --page を結果カウントとして使用する — これはページインデックスであり、制限ではありません。各ページは約 10 個の結果を返します。
• SERP 結果が .results[] にあると想定する — bdata search の場合、.organic[] にあります。（Discover は .results[] を使用します。）
• discover で --num-results 100 をハードコーディングして、パイプラインがそれだけ見つかるまでポーリングすることを実現しない。遅い可能性があります。

リファレンス

• references/flags.md — search と discover の完全なフラグと使用タイミングのノート。
• references/patterns.md — マルチクエリ重複排除、SERP → フィルタリング → scrape パイプライン、search vs discover の決定、従来の curl フォールバック、共有検証チェックリスト。
• references/examples.md — (1) 単一 Google クエリ、(2) ローカライズされた Bing、(3) バッチクエリ + URL リストへの重複排除、(4) discover --include-content エンドツーエンド。