Union Search — скилл

Скилл для Claude Code и Codex: один запрос уходит в 52 поисковых канала, результаты сводятся к единому JSON без дублей

  • 772 ★ репозитория
  • Последний коммит
Скилл

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

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

  • Скилл хранит ключи API в `.env`, ходит в десятки внешних сервисов, а канал ai_tools тратит лимиты ваших аккаунтов Claude Code и Codex.
Все причины и проверки

runningz1/union-search-skill

Установка

Работает в

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

npx skillfoxx add skills/union-search

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

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

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

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

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

  • Скилл хранит ключи API в `.env`, ходит в десятки внешних сервисов, а канал ai_tools тратит лимиты ваших аккаунтов Claude Code и Codex.

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

Что делает

Union Search запускается командой `python union_search_cli.py` и ищет сразу по многим источникам. Каналов 52: 26 работают без обязательного ключа, среди них восемь веб-поисковиков, GitHub и Wikipedia, 23 требуют ключ API у таких сервисов, как Tavily, Exa, Serper и Firecrawl, а три используют вход в локальные Claude Code, Codex и Grok Build. Результаты приводятся к единым полям, дубликаты по адресу страницы сливаются, для каждого канала виден статус и число найденных записей. По умолчанию лимит записей не задан, и скилл возвращает все, что канал отдал за запрос. Полный результат сохраняется в архивный файл, а `read --from-file <файл> --ids 1 2` достает отдельные позиции без повторных обращений к API. Отдельные команды покрывают остальные задачи: `platform <имя>` ищет в одном канале, `defuddle <url>` вытаскивает текст страницы в Markdown, `image` ищет и скачивает картинки на 24 платформах, а `download` выкачивает видео и аудио через yt-dlp. Для агента предусмотрены `schema`, `errors` и `doctor`: машинный список возможностей, коды ошибок и проверка окружения. Группы `general`, `api`, `dev`, `social`, `ai_tools` и `all` сужают выбор каналов.

Для кого. Исследователям и разработчикам, которые просят агента собрать материалы из нескольких поисковиков и платформ и получить один сверенный список ссылок.

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

  • Тема исследуется по нескольким поисковикам сразу, а ссылки из разных выдач надо свести без повторов
  • Агент работает без платных ключей, и ему хватит группы `general` из восьми веб-каналов
  • Нужно прочитать текст страницы в Markdown, не таща лишний шум, для этого есть `defuddle`
  • Под статью собираются картинки с указанием источника, автора и лицензии
  • По найденному видео надо выбрать кандидата и скачать звук или ролик в локальную папку

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

  • Текст уже у агента: скилл не нужен, если обрабатываются только ваши файлы или присланный текст
  • Нужен один известный API поиска: проще подключить его напрямую, чем держать 52 канала
  • Нужны гарантии стабильности каналов: часть веб-каналов зависит от верстки страниц, и пустой ответ может значить капчу или смену разметки
  • Скачивание медиа запрещено условиями источника: команда `download` зависит от yt-dlp и прав на материал

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

Найди через Union Search материалы про упаковку Python-пакетов в DuckDuckGo, Brave и GitHub, сведи ссылки без дублей и сохрани результат в Markdown.

Ограничения

Поле `stable` в реестре каналов отражает лишь метаданные кода и не показывает живую работоспособность. Пустой ответ веб-канала иногда означает капчу, лимит запросов или сменившуюся верстку. Канал без ключа не означает отсутствие обращения к удаленному сервису.

Нужны Python 3.10 и выше, зависимости из `requirements.txt` и, для извлечения текста, Node.js. Ключи API задаются в файле `.env`, шаблон лежит в `.env.example`. Для скачивания медиа нужен yt-dlp, а для склейки и извлечения звука ffmpeg.

Каналы из группы `ai_tools` используют вход и квоты ваших локальных Claude Code, Codex и Grok Build, поэтому каждый запрос списывает лимит аккаунта. Интеграция TikHub с соцсетями автор убрал, а канал Volcengine помечен как нестабильный.

Как отключить. Удалите папку скилла из каталога скиллов агента и файл `.env` с ключами. Загруженные медиа и архивы результатов лежат в рабочих папках, удалите их вручную.

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

Нужны ли платные ключи?

Нет. Группа `general` из восьми веб-каналов работает без обязательного ключа и выбрана по умолчанию. Ключи нужны только для группы `api` с сервисами вроде Tavily и Exa.

Как ограничить число результатов?

Добавьте `--limit N`. Без него скилл возвращает все записи канала за запрос, а `--limit 0` тоже означает «без ограничения».

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

Клонируйте репозиторий в каталог скиллов, выполните `python -m pip install -r requirements.txt` и проверьте окружение командой `python union_search_cli.py doctor --pretty`.

Как достать только текст страницы?

Командой `python union_search_cli.py defuddle <адрес>`. Ей нужен Node.js, результат можно сохранить в Markdown ключом `--format markdown -o <файл>`.

Что делает группа ai_tools?

Отправляет запрос через вход в локальные Claude Code, Codex или Grok Build и расходует квоту вашего аккаунта. В группу по умолчанию она не входит.

Обсуждение

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

Российский стек

Пять cache-first скиллов на shell для Direct, Метрики, Вебмастера, Wordstat и Search API: Claude сам решает, какой запустить

СкиллШирокий доступ17Звезды репозитория
Российский стек

Скилл для агента: полная выдача Яндекса в JSON без официального API-ключа через актор Apify Yandex Search Scraper

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

Скилл для агента: полноразмерные ссылки на изображения из Яндекс Картинок через актор Apify с фильтрами по цвету, размеру и сайту

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

Самостоятельно размещаемый поисковый шлюз на Go с MCP-инструментом поиска: 39 провайдеров, включая официальный Yandex Search API v2

MCP-серверРасширенный доступ2Звезды репозитория

Коротко о README

README на китайском и английском сводит каналы в таблицу групп, дает быстрый старт, примеры поиска, извлечения текста, картинок и медиа и список известных ограничений. Отдельный раздел описывает настройку ключей с помощью агента. Лицензия MIT.

Бейдж для README

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