SkillFoxx
Telegram

Brave Search API Skills

Официальные скиллы Brave: учат агента вызывать Search API для веба, новостей, картинок, видео, мест и выжимок страниц для LLM

  • 196 ★ репозитория
  • Последний коммит
  • MIT
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Скиллы направляют агента отправлять запросы с ключом в Brave Search API, а текст запросов уходит стороннему сервису
  • Ключ в переменной окружения доступен агенту и командам, которые он запускает
Все причины и проверки

brave/brave-search-skillsАвтор:Brave

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/brave-search-api-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скиллы направляют агента отправлять запросы с ключом в Brave Search API, а текст запросов уходит стороннему сервису
  • Ключ в переменной окружения доступен агенту и командам, которые он запускает

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий Brave содержит 12 скиллов по одному на конечную точку Brave Search API, и агент по их инструкциям сам строит запросы с ключом из `BRAVE_SEARCH_API_KEY`. `web-search` возвращает ранжированную выдачу с фрагментами, `news-search` дает новости с фильтром свежести, `images-search` и `videos-search` ищут картинки и видео, `suggest` и `spellcheck` подсказывают и исправляют запрос. Три скилла работают с местами: `local-place-search`, `local-pois` и `local-descriptions`. Для задач RAG и заземления ответов предназначены `llm-context`, который отдает заранее извлеченное содержимое страниц, и `answers`, совместимый с OpenAI SDK. Скилл `bx` оборачивает все точки в один CLI с выводом, ограниченным по токенам. Руководство описывает и Goggles, собственные правила ранжирования выдачи. Скиллы лежат в `skills/` и читаются любым агентом со стандартом Agent Skills. Для Claude Code есть маркетплейс-плагин с автообновлением, для остальных каталоги раскладываются командой `curl` или копированием.

Для кого. Разработчикам и агентам, которым нужен веб-поиск через Brave Search API с актуальными новостями, изображениями и данными о местах.

Подходит, если

  • Агенту нужны свежие результаты и фрагменты страниц для ответа, а встроенный поиск агента не подходит
  • RAG-пайплайну надо подать модели уже извлеченное содержимое страниц через `llm-context`
  • Приложению требуется подсказка и исправление запроса: быстрые `suggest` и `spellcheck`
  • Результат должен быть собран по собственным правилам ранжирования, например с понижением или отбрасыванием доменов через Goggles

Не подходит, если

  • Агент работает только с локальными файлами проекта: поиск по вебу ему не нужен
  • Ключ Brave получить нельзя: все скиллы вызывают платный API, а `web-search` входит в тариф Search
  • Нужен готовый MCP-сервер: для этого у Brave есть отдельный репозиторий, он описан в каталоге

Пример запроса к агенту

Найди через Brave свежие новости за неделю про выход Claude и верни пять ссылок с краткими выдержками

Ограничения

  • Нужен ключ Brave Search API (https://api.search.brave.com) в переменной `BRAVE_SEARCH_API_KEY`; доступ к конечным точкам зависит от тарифа.
  • Сами скиллы поиска не выполняют: они дают агенту инструкции и `curl`-примеры, поэтому нужны сетевой доступ и право запускать команды.
  • Агент читает переменные окружения, и автор советует хранить ключ в настройках самого агента, без записи в профиль оболочки.
  • Перезапуск Cursor из терминала обязателен после экспорта ключа: перезагрузки окна недостаточно.

Как отключить. В Claude Code выполните `/plugin uninstall brave-search-skills`. Для других агентов удалите папки скиллов из каталога скиллов и ключ `BRAVE_SEARCH_API_KEY` из настроек.

Частые вопросы

Как поставить скиллы Brave в Claude Code?

Выполните `/plugin marketplace add brave/brave-search-skills`, затем `/plugin install brave-search-skills@brave-search`. Без маркетплейса можно скачать каталог `skills/` командой `curl` в `~/.claude/skills` или скопировать его после `git clone`.

Где хранить ключ Brave Search API?

Лучше в конфигурации агента: для Claude Code это `env` в `~/.claude/settings.json`, для Codex `shell_environment_policy` в `~/.codex/config.toml`. Для Cursor подойдет `direnv` с файлом `.envrc`.

Какой скилл выбрать для обычного поиска?

Для задач ИИ автор рекомендует `llm-context`, он отдает уже извлеченное содержимое, а для привычной выдачи со ссылками подойдет `web-search`. Для работы из оболочки с ограничением по токенам есть `bx`.

Что такое Goggles в Brave Search?

Это пользовательские правила ранжирования: с их помощью выдача поднимает или понижает домены и шаблоны. Параметр `goggles` передается в запрос поиска.

Подходят ли скиллы Brave для Codex?

Да. Скилл можно поставить встроенным установщиком Codex из `https://github.com/brave/brave-search-skills` или скопировать в `~/.agents/skills`. Ключ задают в `config.toml` или в профиле оболочки.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Три скилла для поиска: четыре источника с оценкой по намерению, глубокий разбор веток обсуждений и страницы в Markdown.

СкиллРасширенный доступ438

Два небольших скилла: веб-поиск через ваш браузер без платных API и проверка плана перед крупной правкой.

СкиллРасширенный доступ81
Официальный

Скилл веб-поиска без MCP-сервера: четыре клиента командной строки ищут по сети и 16 тематическим областям, пакетно и с извлечением страниц

СкиллРасширенный доступ6,9 тыс.

Переносимый скилл для CLI и Python-библиотеки Crawl4AI: страницы на JavaScript, извлечение данных по CSS-схемам и пакетный обход.

СкиллШирокий доступ50

Скилл веб-исследования: SearXNG ищет, Camofox читает страницы, CloakBrowser открывает сайты, которые проверяют посетителей

СкиллШирокий доступ546

Набор из трех скиллов и четырех утилит: агент ищет в сети, читает страницы, берет субтитры видео и обрабатывает медиа

СкиллРасширенный доступ228

Коротко о README

README начинается с получения ключа и безопасных способов задать его в Claude Code, Cursor, Codex и OpenClaw. Затем идут установка для каждого агента, таблица всех скиллов с конечными точками, быстрый старт на `curl`, описание Goggles и ссылки на документацию.

Бейдж для README

Исходный SKILL.md

---
name: web-search
description: USE FOR web search. Returns ranked results with snippets, URLs, thumbnails. Supports freshness filters, SafeSearch, Goggles for custom ranking, pagination. Primary search endpoint.
---

# Web Search

> **Requires API Key**: Get one at https://api.search.brave.com
>
> **Plan**: Included in the **Search** plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

## Quick Start (cURL)

### Basic Search
```bash
curl -s "https://api.search.brave.com/res/v1/web/search?q=python+web+frameworks" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
```

### With Parameters
```bash
curl -s "https://api.search.brave.com/res/v1/web/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=rust programming tutorials" \
  --data-urlencode "country=US" \
  --data-urlencode "search_lang=en" \
  --data-urlencode "count=10" \
  --data-urlencode "safesearch=moderate" \
  --data-urlencode "freshness=pm"
```

## Endpoint

```http
GET https://api.search.brave.com/res/v1/web/search
POST https://api.search.brave.com/res/v1/web/search
```

**Note**: Both GET and POST methods are supported. POST is useful for long queries or complex Goggles.

**Authentication**: `X-Subscription-Token: <API_KEY>` header

Сообщить о проблеме