one-search-mcp — MCP-сервер для Claude Code: как настроить
Находит данные в сети через поисковики или локальный браузер, скачивает страницы и собирает ссылки. Работает без платных API.
claude mcp add --env SEARCH_PROVIDER=<SEARCH_PROVIDER> --env SEARCH_API_URL=<SEARCH_API_URL> --env SEARCH_API_KEY=<SEARCH_API_KEY> --env YDC_API_KEY=<YDC_API_KEY> --env ALLOW_PRIVATE_NETWORK=<ALLOW_PRIVATE_NETWORK> --transport stdio one-search-mcp -- npx -y one-search-mcpЧто делает one-search-mcp
Сервер предоставляет четыре инструмента: one_search для текстовой выдачи, one_scrape для захвата страниц в markdown или скриншотов, one_map для сбора внутренних ссылок и one_extract для подготовки текста. По умолчанию поиск работает локально через agent-browser. Внешние сервисы и платные ключи не нужны. При необходимости можно подключить SearXNG, Tavily, Google, Bing или You.com через переменные окружения.
Для любых действий со страницами сервер требует установленный браузер на базе Chromium: подойдёт Google Chrome, Microsoft Edge или чистый Chromium. Без установленного браузера локальный режим не запустится. Утилита one_scrape умеет кликать, прокручивать страницу и ждать элементы перед выгрузкой. Сетевой доступ к приватным адресам заблокирован настройкой по умолчанию ради безопасности.
Какие задачи решает
- искать информацию в веб-поисковиках без платных API-ключей
- снимать скриншоты и выгружать веб-страницы в markdown
- собирать ссылки со страницы через локальный браузер
- готовить текстовые блоки с нескольких адресов для обработки моделью
Примеры запросов агенту
- Найди через one_search свежие материалы по релизу Python 3.13 в локальном поиске.
- Выгрузи страницу сервиса по адресу http://127.0.0.1:8080 в формате markdown через one_scrape.
- Собери список внутренних ссылок через one_map с ограничением в 20 страниц.
Как установить one-search-mcp
Командой платформы
claude mcp add --env SEARCH_PROVIDER=<SEARCH_PROVIDER> --env SEARCH_API_URL=<SEARCH_API_URL> --env SEARCH_API_KEY=<SEARCH_API_KEY> --env YDC_API_KEY=<YDC_API_KEY> --env ALLOW_PRIVATE_NETWORK=<ALLOW_PRIVATE_NETWORK> --transport stdio one-search-mcp -- npx -y one-search-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add one-search-mcp --env SEARCH_PROVIDER=<SEARCH_PROVIDER> --env SEARCH_API_URL=<SEARCH_API_URL> --env SEARCH_API_KEY=<SEARCH_API_KEY> --env YDC_API_KEY=<YDC_API_KEY> --env ALLOW_PRIVATE_NETWORK=<ALLOW_PRIVATE_NETWORK> -- npx -y one-search-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": [
"-y",
"one-search-mcp"
],
"env": {
"SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
"SEARCH_API_URL": "<SEARCH_API_URL>",
"SEARCH_API_KEY": "<SEARCH_API_KEY>",
"YDC_API_KEY": "<YDC_API_KEY>",
"ALLOW_PRIVATE_NETWORK": "<ALLOW_PRIVATE_NETWORK>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"one-search-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"one-search-mcp"
],
"env": {
"SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
"SEARCH_API_URL": "<SEARCH_API_URL>",
"SEARCH_API_KEY": "<SEARCH_API_KEY>",
"YDC_API_KEY": "<YDC_API_KEY>",
"ALLOW_PRIVATE_NETWORK": "<ALLOW_PRIVATE_NETWORK>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SEARCH_PROVIDER=<SEARCH_PROVIDER> -e SEARCH_API_URL=<SEARCH_API_URL> -e SEARCH_API_KEY=<SEARCH_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -e ALLOW_PRIVATE_NETWORK=<ALLOW_PRIVATE_NETWORK> one-search-mcp npx -y one-search-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о one-search-mcp
Как установить one-search-mcp в Claude Code?
Выполните команду claude mcp add one-search-mcp -e SEARCH_API_KEY=<SEARCH_API_KEY> -e YDC_API_KEY=<YDC_API_KEY> -- npx -y one-search-mcp. Сервер подключится через npx с указанными ключами.
Что нужно для локальной работы без API-ключей?
В системе должен стоять браузер Chrome, Edge или Chromium. Пакет agent-browser обнаружит его автоматически и выполнит поисковые действия на машине.
Чем one_scrape отличается от one_map?
Инструмент one_scrape получает контент страницы в markdown, html или в виде скриншота, поддерживая клики и прокрутку. Инструмент one_map предназначен только для извлечения ссылок из DOM-дерева загруженной страницы.
