free-search-mcp
Локальный MCP-сервер без ключей API: поиск по нескольким системам, загрузка страниц и чтение документов для LLM.
- 179 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер загружает любые адреса, которые запросит агент, и сохраняет страницы в локальный кэш.
- HTTP-режим не имеет аутентификации: открытый порт даст загрузку адресов всем, кто до него дотянется.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/free-search-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер загружает любые адреса, которые запросит агент, и сохраняет страницы в локальный кэш.
- HTTP-режим не имеет аутентификации: открытый порт даст загрузку адресов всем, кто до него дотянется.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
free-search-mcp запускается у вас на машине и дает любой модели поиск в вебе, загрузку страниц и чтение документов без регистрации в поисковых API. Запрос идет параллельно в несколько систем (DuckDuckGo, Mojeek, Startpage и другие), результаты сливаются и очищаются от повторов. Страницы приводятся к Markdown с оценкой числа токенов, ошибки подсказывают следующий шаг. Для страниц с тяжелым JavaScript есть запасной путь через Playwright и Chromium. Инструментов 11: `search` и `research` (поиск и загрузка главных источников в одном вызове), `compare` для двух-пяти ссылок, `fetch` и `fetch_batch` (до 20 адресов), `read_doc` для PDF, DOCX, XLSX, PPTX, EPUB, CSV и кода с постраничным чтением, `extract_structured` для JSON-LD и OpenGraph, `cache_search` по полнотекстовому кэшу FTS5, `paper_graph` для цитирований статьи, `engines` и `download`. Фильтры по свежести, доменам и категориям (новости, статьи, ПО, безопасность). Плагин добавляет навык verified-research и субагента quick-search для Claude Code.
Для кого. Тем, кто хочет дать Claude Code, Codex или локальной модели поиск и чтение страниц без платных поисковых API и регистраций.
Подходит, если
- Агенту нужна справка по свежей библиотеке: `research` собирает короткий отчет с источниками.
- Сравнить условия двух сервисов по пяти ссылкам и получить выдержки под вопрос.
- Прочитать длинный PDF постранично и найти нужный раздел.
- Найти статью и пройти по ее ссылкам и цитированиям через `paper_graph`.
Не подходит, если
- Нужны стабильные результаты поисковой системы с договором и SLA: здесь бесплатные движки без гарантий.
- Сервер нужно открыть в сеть: HTTP-режим не имеет аутентификации и загружает любой адрес для всех, кто до него дотянется.
- Страницы за входом или защитой от ботов: сервер определяет капчу и сообщает об ошибке, но не решает ее.
Пример запроса к агенту
Изучи через free-search новые правила пагинации в документации библиотеки, собери короткий отчет с источниками и покажи, какие страницы читались.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
SEARCH_MCP_CACHE_DIR- Каталог кэша и загрузок
SEARCH_MCP_DOWNLOAD_ENABLED- false отключает инструмент download
Ограничения
Нужны Python 3.11 или новее и uv. Часть движков (`brave`, `zhihu`) и страницы с тяжелым JavaScript требуют Chromium: один раз ставится командой `uvx --from free-search-mcp playwright install chromium`. HTTP-режим (`--transport streamable-http`) не имеет аутентификации, его держат на loopback или за прокси с проверкой. Инструмент `download` сохраняет файлы в `SEARCH_MCP_CACHE_DIR/downloads` и удаляет их через сутки, отключается переменной `SEARCH_MCP_DOWNLOAD_ENABLED=false`. Двенадцатый инструмент `ask` появляется только при настроенном ответном бэкенде.
Как отключить. Для Claude Code выполните `claude mcp remove search` или `/plugin uninstall free-search`; для Codex `codex mcp remove search`. Кэш лежит в `SEARCH_MCP_CACHE_DIR`, его можно удалить вручную.
Частые вопросы
Как поставить free-search в Claude Code?
Командами `/plugin marketplace add sweetcornna/free-search-mcp` и `/plugin install free-search@free-search-mcp`. Без плагина работает `claude mcp add search -s user -- uvx free-search-mcp`.
Нужен ли ключ API?
Нет, ключи поисковых API не нужны. Ключ понадобится лишь для необязательного бэкенда инструмента `ask`.
Какие форматы документов читает read_doc?
PDF, DOCX, XLSX, PPTX, EPUB, CSV, архивы zip и tar, HTML, TXT, Markdown и исходный код, с постраничным чтением.
Что делает сервер с капчей?
Движок, который отдал капчу или пустую страницу, пропускается с пометкой в ошибке, решения капчи нет.
Какие поисковые системы опрашиваются?
В примерах DuckDuckGo, Mojeek, Startpage, Bing и другие, список показывает инструмент `engines`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный веб-поиск для агента без ключей API: результаты ранжируются на вашей машине, в ответ идут только нужные абзацы
Веб-поиск через DuckDuckGo и чтение страниц для агента без API-ключей, с ограничением частоты запросов
MCP-сервер исследований: ищет в вебе, SEC, судах и патентах, читает страницы целиком и проверяет, что цитаты существуют.
Официальный MCP Search1API: поиск в вебе, новости, загрузка страниц, карты сайтов и тренды с OAuth или ключом API.
Метапоиск для агентов: один MCP-сервер и HTTP API собирают результаты многих поисковиков в единый JSON с дедупликацией.
Локальный веб-поиск для агентов: ищет, читает страницы и отдает сжатые фрагменты с источниками, экономя токены контекста
Коротко о README
README объясняет назначение сервера, быстрый старт через плагины Claude Code и Codex, сравнение с другими поисковыми MCP, таблицу из 11 инструментов с фильтрами, остальные способы установки (Claude Desktop, uvx, Docker, сценарий установки) и работу с движками.