# Search

> Busca no Google via API SERP do Bright Data. Retorna resultados JSON estruturados com título, link e descrição. Requer as variáveis de ambiente BRIGHTDATA_API_KEY e BRIGHTDATA_UNLOCKER_ZONE.

- Skill: `artubss/search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add artubss/search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/artubss/search/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: artubss (https://skillmd.com/u/artubss)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/artubss/search

---


# Bright Data - Google Search

Busque no Google e obtenha resultados JSON estruturados usando a API SERP do Bright Data.

## Configuração

**1. Obtenha sua API Key:**
Obtenha uma chave no [Painel do Bright Data](https://brightdata.com/cp).

**2. Crie uma zona Web Unlocker:**
Crie uma zona em brightdata.com/cp clicando em "Add" (canto superior direito) e selecionando "Unlocker zone".

**3. Configure as variáveis de ambiente:**
```bash
export BRIGHTDATA_API_KEY="sua-api-key"
export BRIGHTDATA_UNLOCKER_ZONE="seu-nome-de-zona"
```

## Uso

```bash
bash scripts/search.sh "query" [cursor]
```

**Parâmetros:**
- `query` (obrigatório): Termo de busca
- `cursor` (opcional): Número da página para paginação (iniciado em 0, padrão: 0)

**Exemplos:**
```bash
# Busca básica
bash scripts/search.sh "mudanças climáticas"

# Obter página 2 de resultados
bash scripts/search.sh "mudanças climáticas" 1
```

## Formato de Saída

Retorna JSON com array `organic` estruturado:
```json
{
  "organic": [
    {
      "link": "https://example.com/article",
      "title": "Título do Artigo",
      "description": "Breve descrição da página..."
    }
  ]
}
```

## Dependências

- `curl` - Para requisições de API
- `jq` - Para processamento JSON