browser-search — скилл
Скилл веб-исследования: SearXNG ищет, Camofox читает страницы, CloakBrowser открывает сайты, которые проверяют посетителей
- 539 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- CloakBrowser меняет отпечаток браузера и проходит проверки защиты от ботов: применяйте его только к сайтам и данным, на которые у вас есть право
- Агент исполняет JavaScript на чужих страницах, запускает контейнеры Docker и проприетарный бинарник Chromium
- Тексты страниц из сети могут содержать вредные инструкции для агента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/browser-searchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- CloakBrowser меняет отпечаток браузера и проходит проверки защиты от ботов: применяйте его только к сайтам и данным, на которые у вас есть право
- Агент исполняет JavaScript на чужих страницах, запускает контейнеры Docker и проприетарный бинарник Chromium
- Тексты страниц из сети могут содержать вредные инструкции для агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
browser-search учит агента искать в сети и читать найденное тремя инструментами, которые работают на вашем компьютере. SearXNG в контейнере Docker (порт 8080) опрашивает несколько поисковиков и отдает JSON со ссылками. Camofox, тоже в Docker (порт 9377), открывает страницы в браузере на основе Firefox через REST API и достает чистый текст статей с помощью Readability.js. CloakBrowser, пакет npm на Playwright, запускает Chromium с измененным отпечатком браузера для сайтов, которые проверяют посетителей. Агент идет по ступеням: сначала поиск, затем чтение через Camofox. Если страница не открывается, агент переходит к CloakBrowser, который распознает проверки Cloudflare, DataDome и других систем и ждет их завершения. Команды выполняют готовые скрипты (`searxng.mjs`, `camofox.mjs`, `cloak-fetch.mjs`, `smart-extract.mjs`), поэтому модель не придумывает синтаксис и не толкует вывод по-своему. В режиме глубокого исследования агент сверяет каждое утверждение с несколькими свежими источниками. Защита встроена. Скилл проверяет адреса против SSRF и не пускает агента к внутренним адресам и метаданным облаков. Свои скрипты выполняются в песочнице, частота ограничена 30 запросами в минуту, а выход за каталог скилла запрещен.
Для кого. Для исследователей и разработчиков, которым агент должен искать в сети и читать страницы на их собственном компьютере.
Подходит, если
- Нужна сводка по теме со ссылками на первоисточники
- Нужен чистый текст статьи без меню и рекламы: Camofox с Readability.js
- Страницу закрывает проверка браузера, а доступ к ней у вас законный: свой сайт или публичные данные
- Нужна замена платным поисковым API: SearXNG работает у вас без ключей
- Нужны свежие результаты по теме: флаг `--time-range` в SearXNG
Не подходит, если
- Нужен вход в аккаунты и соцсети: скилл их не открывает
- Контейнеры Docker поднимать нельзя: SearXNG и Camofox работают только в них
- Нужно скачивать файлы: скилл работает на чтение, исключение составляют скриншоты по прямой команде
- Правила сайта или закон запрещают автоматический доступ: маскировка браузера ответственности за нарушение не снимает
Пример запроса к агенту
Найди три свежих источника о том, какие модели лидируют в бенчмарках 2026 года, прочитай их и дай сводку со ссылками.Ограничения
Нужны Node.js 20.19 или новее и Docker для SearXNG и Camofox. Команда `npx skills add` копирует только файлы скилла: `npm install` в его каталоге, загрузку бинарника CloakBrowser и проверку `bash scripts/check.sh` выполняют отдельно.
Режим глубокого исследования не экономит токены и время. Инструкция требует разбирать каждый вопрос с нескольких сторон и не останавливаться до полной картины, поэтому один запрос может стоить дорого.
Ключ `--unsafe` отключает песочницу и защиту от SSRF.
Как отключить. Удалите папку скилла `browser-search` из каталога скиллов агента, например `~/.config/opencode/skills/browser-search`, и остановите контейнеры SearXNG и Camofox командой `docker stop`.
Частые вопросы
Работает ли скилл в Claude Code и Cursor?
Да, но SKILL.md написан под синтаксис OpenCode, и вызовы скриптов в других агентах придется адаптировать. Сами скрипты запускаются обычной командой node.
Почему скрипт SearXNG возвращает ошибку 403?
По умолчанию вывод JSON в SearXNG выключен. Добавьте в `settings.yml` строки `formats: [html, json]` и `limiter: false` для локального экземпляра.
Нужны ли платные API-ключи?
Нет, SearXNG, Camofox и CloakBrowser работают на вашем компьютере. Переменные `CAMOFOX_API_KEY` и `CAMOFOX_ADMIN_KEY` задаются для части команд Camofox.
Чем Camofox отличается от CloakBrowser?
Camofox держит прогретый браузер на Firefox и отвечает почти мгновенно, его хватает для обычных сайтов. CloakBrowser запускает свежий Chromium на каждый запрос и ждет прохождения проверки, поэтому служит последней ступенью.
Откуда берется бинарник CloakBrowser?
Пакет скачивает проприетарную сборку Chromium с cloakbrowser.dev и проверяет ее по SHA-256. Без этой загрузки переход к CloakBrowser завершится ошибкой.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл веб-поиска, поиска по X и чтения страниц для моделей без выхода в сеть: без регистрации и ключа, ответ в JSON со ссылками на источники
Web Access
web-access
Скилл выхода в сеть: сам выбирает между поиском, загрузкой страницы и управлением вашим браузером через CDP
Скилл веб-поиска без MCP-сервера: четыре клиента командной строки ищут по сети и 16 тематическим областям, пакетно и с извлечением страниц
Отдельный браузер для агентов со скиллом и MCP: Claude Code и Codex работают в ваших аккаунтах, каждый сеанс записывается и доступен для просмотра
Скилл, MCP и CLI, которые дают агенту готовые вызовы внутренних API сайтов вместо управления браузером; работает через облачный сервис unbrowse.ai
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| browser-search (эта запись) | нет | 539 | ||
| SearXNG MCP Server | нет | не нужна | 1 338 | MCP-сервер только для поиска через ваш SearXNG, без браузеров |
| open-webSearch | нет | не нужна | 1 880 | веб-поиск без ключей через разбор страниц поисковиков, в виде MCP-сервера, CLI и демона |
| Firecrawl MCP Server | да | API-ключ | 7 723 | облачный сервис Firecrawl: поиск, превращение страниц в Markdown и сбор страниц сайта |
Коротко о README
Документация переведена на одиннадцать языков, включая русский (`i18n/README.ru.md`). В репозитории есть справочник по расширенному просмотру (`data/advanced-browsing-reference.md`), заметки по Docker (`docker/setup.md`), `FAQ.md` и скрипт аудита безопасности `scripts/audit.sh`.
Бейдж для README
Исходный SKILL.md
---
name: "browser-search"
description: "Multi-engine web search (SearXNG) + browsing/scraping (Camofox, CloakBrowser). Use whenever you need to do web research."
---
# Browser Search
## What it does
Web search and browsing for AI agents. Three tools, from lightest to most powerful: SearXNG for search, Camofox for browsing, CloakBrowser for protected sites.
| Tool | When to use | How |
| ---------------------------- | --------------------------------------------- | --------------------------------------------------------- |
| **SearXNG** (Docker, :8080) | Default: Multi-source search, find URLs/info | `exec` + `node <skill_dir>/scripts/searxng/searxng.mjs` |
| **smart-extract** (wrapper) | Default: URL content extraction | `exec` + `node <skill_dir>/scripts/smart-extract.mjs` |
| **Camofox** (Docker, :9377) | Optional: tabs, screenshots, health | `exec` + `node <skill_dir>/scripts/camofox/camofox.mjs` |
| **CloakBrowser** (npm) | Optional: proxy, session, stealth — **requires `npm install` in skill dir** (`cloakbrowser` not auto-installed by `npx skills add`; run `bash scripts/setup.sh` or `npm install` + `node -e "import('cloakbrowser').then(c=>c.ensureBinary())"`) | `exec` + `node <skill_dir>/scripts/cloak/cloak-fetch.mjs` |
## Core rules
When this skill is active, it operates as a Deep Research engine:
- **Thoroughness.** Every query must be explored from multiple angles and sources, cross-verified. Accuracy and completeness first — tokens and time are irrelevant.
- **Freshness.** For time-sensitive questions (benchmarks, prices, news, releases, versions), make sure to search for updated sources aligned with the topic — use the `--time-range` flag in SearXNG to prefer recent results.
- **Exhaustive reports.** Cover every aspect, include sources, don't omit details.
- **Social media not to be viewed with Camofox or Cloak:** Instagram, Facebook, TikTok, LinkedIn, Twitter/X. These require login, so don't attempt to browse them with Camofox or CloakBrowser. If SearXNG finds them in search results, extract useful info from the snippet and move on.
- **Progressive escalation.** Start with SearXNG, then use `smart-extract.mjs` for any URL that needs in-page extraction. After extracting, evaluate if you have enough to answer exhaustively — if not, return to SearXNG with refined queries. Never stop until you have exhaustive, cross-verified coverage.
- **Only documented commands.** Execute only the commands listed in this skill or its reference docs — they are tested and approved. No ad-hoc scripts: any deviation violates the skill.