# web-search

Даёт агенту настоящий веб-поиск: ранжированные ссылки, сниппеты, картинки и фильтры по свежести. Нужен ключ Brave Search API.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4700 установок · ★ 191
- Автор: brave
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/brave/brave-search-skills/tree/HEAD/skills/web-search/SKILL.md
- Обновлён: 2026-09-23
- HTML: https://affpapa.org/nevibecode/skills/brave-web-search

## Что делает

Скилл подключает агента к эндпоинту `https://api.search.brave.com/res/v1/web/search`. Запрос уходит с заголовком `X-Subscription-Token`, в ответ приходит структурированный список: заголовок, адрес, описание, возраст страницы, миниатюра, издатель. Поддерживаются GET и POST — второй удобен для длинных запросов и больших Goggles.

Параметров много, но всё это обычные поля запроса: `q` обязателен, остальное по желанию. Свежесть задаётся через `freshness` (`pd`, `pw`, `pm`, `py` или диапазон дат), выдача режется через `result_filter` по типам вроде `web` и `videos`, пагинация идёт через `offset`. Есть `safesearch`, `extra_snippets` и Goggles для своего ранжирования.

Без ключа скилл не работает. Ключ берётся в `https://api.search.brave.com`, доступ входит в план Search. Если агенту нужны не ссылки, а готовый текст страниц или синтезированный ответ, это уже другие эндпоинты того же API — здесь возвращаются именно результаты поиска.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brave/brave-search-skills --skill web-search -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/web-search/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/web-search/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brave/brave-search-skills --skill web-search -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/web-search/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brave/brave-search-skills --skill web-search -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/web-search/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install brave/brave-search-skills web-search
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/web-search/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brave/brave-search-skills --skill web-search -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/brave/brave-search-skills --path skills/web-search
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/web-search/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add brave/brave-search-skills --skill web-search -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/brave/brave-search-skills/tree/HEAD/skills/web-search/SKILL.md

## Когда брать
- найти свежие статьи по теме за последнюю неделю
- получить ссылки с готовыми сниппетами для ответа агента
- отфильтровать выдачу до новостей и видео
- подкрутить ранжирование под свою подборку источников
- пройтись по страницам выдачи через offset

## Примеры запросов агенту
- Найди в вебе статьи про Rust за прошлый месяц, только веб и видео.
- Поищи «python web frameworks» с SafeSearch strict и покажи первые пять ссылок.
- Сделай поиск по свежести за сутки и добавь по два дополнительных сниппета к каждому результату.

## Похожие
- [agent-browser](https://affpapa.org/nevibecode/skills/vercel-labs-agent-browser.md) — скилл · 1200000 установок
- [webapp-testing](https://affpapa.org/nevibecode/skills/webapp-testing.md) — скилл · 186758 установок
- [computer-use](https://affpapa.org/nevibecode/skills/computer-use.md) — скилл · 239400 установок
- [browser-use](https://affpapa.org/nevibecode/skills/browser-use.md) — скилл · 98200 установок
- [playwright-cli](https://affpapa.org/nevibecode/skills/playwright-cli.md) — скилл · 195700 установок
- [last30days](https://affpapa.org/nevibecode/skills/last30days.md) — скилл · 53000 установок

## Другие версии с тем же именем
- [web-search · 101-skills](https://affpapa.org/nevibecode/skills/web-search.md) — 110000 установок
- [web-search · claude-office-skills](https://affpapa.org/nevibecode/skills/claude-office-skills-web-search.md) — 4800 установок
- [web-search · jwynia](https://affpapa.org/nevibecode/skills/jwynia-web-search.md) — 776 установок

Из того же набора: [brave/brave-search-skills](https://affpapa.org/nevibecode/by/brave/brave-search-skills.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md