Bright Data — 搜索

在网页上查找信息。此技能包含两个命令：

• **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 未安装 — 参见 bright-data-best-practices/references/cli-setup.md"
elif ! bdata zones >/dev/null 2>&1; then
    echo "bdata 未认证 — 运行：bdata login （或：bdata login --device 用于 SSH）"
fi

任一检查失败时，停止并跳转至 skills/bright-data-best-practices/references/cli-setup.md。

选择你的路径

执行操作

核心命令示例：

# 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

# 第二页结果（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](references/flags.md)。

search 与 discover — 选择正确的工具

验证检查

1. JSON 可正常解析：运行 jq . <output> 返回状态码 0。
2. 结果数组非空：若为空，说明查询无结果，应放宽查询条件后重试。不要在无结果情况下声称成功，除非明确告知用户。
3. 必填字段存在：

- search：结果位于 .organic[]；每个条目包含 title 和 link

- discover：结果位于 .results[]；每个条目包含 title 和 link；若使用 --include-content，还包含 content

1. **对于 discover --include-content**：content 字段中不应出现以下屏蔽页标识符（不区分大小写）：

- Access Denied

- Just a moment

- Attention Required

- Checking your browser

- captcha

- cf-browser-verification

- cloudflare（且总内容小于 2KB）

1. 地理合理性检查：若期望特定国家的结果，检查前几条结果的 TLD 或语言。若定位错误，应显式添加 --country 和 --language 重新运行。

风险提示

• 使用 search 从 Amazon、LinkedIn、TikTok 等平台抓取内容，而 data-feeds 可以单次调用返回干净结构化数据。
• 盲目抓取所有 SERP 结果 —— 应先过滤（域名白名单、标题含关键词、相关性启发式规则）。
• 混淆 search（关键词匹配）与 discover（语义匹配）。两者回答的是不同问题。
• 多个查询未对结果集中的 URL 做去重，直接进行抓取。
• 认为 SERP 排名是全局统一的 —— 实际受地理位置和设备影响。始终显式设置 --country 和 --device 以保证可复现性。
• 将 --page 当作结果数量上限 —— 它是页码索引，每页约 10 条结果。
• 假设 SERP 结果都在 .results[] —— 对于 bdata search，实际位于 .organic[]。（discover 使用 .results[]。）
• 硬编码 --num-results 100 到 discover，而未意识到该流程会持续轮询直到满足数量，可能导致执行缓慢。

参考资料

• [references/flags.md](references/flags.md) — search 与 discover 的完整参数说明，含使用场景建议。
• [references/patterns.md](references/patterns.md) — 多查询去重、SERP → 过滤 → 抓取流程、search 与 discover 的选择逻辑、旧版 curl 回退方案、共享验证清单。
• [references/examples.md](references/examples.md) — （1）单个 Google 查询，（2）本地化 Bing，（3）批量查询 + 去重生成 URL 列表，（4）discover --include-content 端到端示例。