search
/search
Przeszukuje sieć przez CLI Bright Data: wyniki SERP z Google, Bing i Yandex oraz semantyczne wyszukiwanie, przekazując wybrane adresy URL do scrapowania.
- Autor
- brightdata ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 15.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Przeszukuje sieć przez CLI Bright Data: wyniki SERP z Google, Bing i Yandex oraz semantyczne wyszukiwanie, przekazując wybrane adresy URL do scrapowania.
Oryginalny opis (EN)
Search the web via the Bright Data CLI — `bdata search` for Google/Bing/Yandex SERP, `bdata discover` for intent-ranked semantic results. Use when the user wants SERP results, needs URLs to feed into scraping, or wants semantic web discovery with optional page content. Hands off to `scrape` once target URLs are chosen, and to `data-feeds` when the user wants structured data from a known platform. Requires the Bright Data CLI; proactively guides install + login if missing.
Jak działa
- Setup gate (run first)
- Pick your path
- Action
- Verification gate
- Red flags
- References
Podgląd SKILL.md
---
name: search
description: Search the web via the Bright Data CLI — `bdata search` for Google/Bing/Yandex SERP, `bdata discover` for intent-ranked semantic results. Use when the user wants SERP results, needs URLs to feed into scraping, or wants semantic web discovery with optional page content. Hands off to `scrape` once target URLs are chosen, and to `data-feeds` when the user wants structured data from a known platform. Requires the Bright Data CLI; proactively guides install + login if missing.
---
# Bright Data — Search
Find things on the web. Two commands live in this skill:
- **`bdata search`** — classic keyword SERP (Google/Bing/Yandex). Best when you want "what ranks for keyword X."
- **`bdata discover`** — AI intent-ranked discovery with optional page content. Best when you want "pages about topic Y that match intent Z."
For structured data from a known platform (Amazon, LinkedIn, TikTok, …), **stop and use `data-feeds` instead**.
## Setup gate (run first)
```bash
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
```
Halt and route to `skills/bright-data-best-practices/references/cli-setup.md` if either check fails.
## Pick your path
| Situation | Action |
|---|---|
| Single keyword query, just SERP | `bdata search "<query>" --engine google --json --pretty` |
| Paginated SERP (more results) | loop `--page 0`, `--page 1`, … (0-indexed) |
| Multiple queries | shell loop over a queries file |
| Intent-ranked / semantic (not keyword) | `bdata discover "<query>" --intent "<intent>" --num-results 20` |
| Want page bodies along with results, one pass | `bdata discover ... --include-content` |
| News / images / shopping SERP | `bdata search "<query>" --type news` (or `images`, `shopping`) |
| Want Amazon/LinkedIn/TikTok/… structured data | **stop — hand off to `data-feeds`** |
| Have URLs, want content | **hand off to `scrape`** |
## Action
Core commands:
```bash
# Google SERP, structured JSON
bdata search "site:example.com privacy policy" --engine google --json --pretty
# Localized Bing (German results, German language)
bdata search "datenschutz" --engine bing --country de --language de --json
# Second page of results (0-indexed)
bdata search "machine learning papers" --page 1 --json
# Mobile SERP (rankings differ from desktop)
bdata search "best coffee shops" --device mobile --json
# News vertical
bdata search "openai" --type news --json --pretty
# Intent-ranked discovery
bdata discover "enterprise LLM platforms" \
--intent "vendor pages with pricing" \
--num-results 15 --json
# Discovery with page content in markdown
bdata discover "webhook best practices" \
--include-content --num-results 10 -o results.json
# Date-filtered discovery
bdata discover "react server components" \
--start-date 2025-01-01 --end-date 2025-12-31 --num-results 20
```
Full flag reference: [`references/flags.md`](references/flags.md).
### `search` vs `discover` — pick the right one
| You want | Use |
|---|---|
| "What Google ranks for this exact keyword" | `search` |
| "Pages that match this meaning/intent" | `discover` |
| "News / images / shopping vertical SERP" | `search --type <vertical>` |
| "Results + page bodies in one call" | `discover --include-content` |
| "Dedup / semantic ranking across queries" | `discover` |
## Verification gate
1. **JSON parses cleanly:** `jq . <output>` returns 0.
2. **Result array non-empty** — if empty, the query is legitimately zero-result; relax the query and re-run. Don't claim success on empty results without telling the user.
3. **Required fields present:**
- `search`: results live at `.organic[]`; each has `title` + `link`
- `discover`: results live at `.results[]`; each has `title` + `link`; if `--include-content`, also `content`
4. **For `discover --include-content`:** no block-page signatures in the `content` field (same list as scrape, case-insensitive):
- `Access Denied`
- `Just a moment`
- `Attention Required`
- `Checking your browser`
- `captcha`
- `cf-browser-verification`
- `cloudflare` *(with < 2KB total body)*
5. **Geo sanity:** if the user expected country-specific results, inspect TLDs / languages of top results. If mis-localized, re-run with explicit `--country` and `--language`.
## Red flags
- Using `search` to *fetch content* from Amazon, LinkedIn, TikTok, etc. when `data-feeds` returns clean structured data in one call.
- Scraping every SERP result blindly — filter first (domain allowlist, keyword in title, relevance heuristic).
- Confusing `search` (keyword) with `discover` (semantic). They answer different questions.
- Running multiple queries without deduping URLs across result sets before scraping.
- Assuming SERP order is universal — it's personalized by geo + device. Always set `--country` and `--device` explicitly for reproducibility.
- Using `--page` as a result count — it's a page index, not a limit. Each page returns ~10 results.
- Assuming SERP results are at `.results[]` — for `bdata search` they live at `.organic[]`. (Discover uses `.results[]`.)
- Hardcoding `--num-results 100` on `discover` without realizing the pipeline polls until that many are found; can be slow.
## References
- [`references/flags.md`](references/flags.md) — full flags for `search` and `discover` with when-to-use notes.
- [`references/patterns.md`](references/patterns.md) — multi-query dedup, SERP → filter → scrape pipeline, `search` vs `discover` decision, legacy `curl` fallback, shared verification checklist.
- [`references/examples.md`](references/examples.md) — (1) single Google query, (2) localized Bing, (3) batch queries + dedup into URL list, (4) `discover --include-content` end-to-end.
Pliki w paczce (4)
- SKILL.md 6 KB
- references/examples.md 2 KB
- references/flags.md 4 KB
- references/patterns.md 4 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · brightdata/skills | 100 | MIT |
| taishi-i/awesome-japanese-nlp-resources | 100 | CC0-1.0 |
| cenksimsek1988/cenk-jobs | 100 | MIT |
| cardstack/boxel | 100 | MIT |
| Kolibee-GmbH/m2b | 100 | MIT |
| zimoliao/scholaraio | 100 | MIT |
| taishi-i/awesome-chatgpt-repositories | 100 | CC0-1.0 |
| tombelieber/claude-view | 100 | MIT |
| madappgang/magus | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 851488071230 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95data-feeds
Wyciąga ustrukturyzowane dane z ponad 40 platform, jak Amazon, LinkedIn czy YouTube, przez Bright Data CLI w formacie JSON. - 100scrape
Pobiera treści z sieci jako czysty Markdown, HTML lub JSON przez Bright Data CLI: pojedyncze strony, listy URL-i i paginowane listingi, z przekazaniem do data-feeds lub search. - 100data-feeds
Pobiera ustrukturyzowane dane z gotowych scraperów Bright Data (e-commerce, social, oferty pracy, mapy, nieruchomości) przez Bright Data CLI i zwraca czysty JSON. - 100apify-yandex-search-api
Zwraca ustrukturyzowane wyniki wyszukiwania Yandex jako JSON bez oficjalnego klucza API przez Apify Actor, z wynikami organicznymi, reklamami, grafem wiedzy i regionami. - 90serp-api
Pokazuje na żywo wyniki Google i Bing dla słów kluczowych według lokalizacji i urządzenia, w tym cechy SERP, źródła AI Overviews i Mapy. - 100apify-yandex-image-search-api
Wyszukuje obrazy w Yandex Images i zwraca adresy pełnowymiarowych obrazów jako ustrukturyzowany JSON przez Apify Actor, z filtrami typu, koloru, rozmiaru i świeżości.