octen-mcp — MCP-сервер для Claude Code: поиск в вебе и извлечение страниц
Даёт агенту живой веб-поиск и вытягивание URL в чистый markdown. Пригодится, когда агенту нужны свежие данные со страниц, а не только код в репозитории.
claude mcp add --env OCTEN_API_KEY=<OCTEN_API_KEY> --env OCTEN_API_URL=<OCTEN_API_URL> --transport stdio octen-mcp -- npx -y octen-mcpЧто делает octen-mcp
Сервер отдаёт шесть инструментов. search и news_search ищут по живому вебу с фильтрами по домену, языку и времени, broad_search разбивает запрос на подзапросы и ищет их параллельно, extract превращает одну или несколько ссылок в чистый текст, готовый для модели. image_search и video_search пока в бете — нужен доступ от авторов.
Полезное в extract — не только тело страницы. К каждому результату прилагаются category (о чём страница), page_structure (какой это тип страницы) и highlights — ранжированные фрагменты, если передать query. Так агент отсеивает страницы логина, навигационные и не по теме до того, как потратит токены на полный текст.
Подключение идёт двумя путями: хостед-эндпоинт https://mcp.octen.ai/mcp или локальный запуск через npx -y octen-mcp. Для локального нужен Node >= 18.17, а версии 0.4.1 и ниже падают на Node 26 и новее с ошибкой UND_ERR_INVALID_ARG — тогда пакет надо обновить. Ключ OCTEN_API_KEY берётся на octen.ai, но клиенты с OAuth могут обойтись без него. Ключ лучше передавать заголовком x-api-key: в URL он попадает в логи прокси и историю браузера.
Какие задачи решает
- вытащить статью по ссылке в чистый markdown для контекста модели
- найти свежие новости по теме с фильтром по дате
- разложить широкий запрос на подзапросы и собрать выдачу по каждому
- отсеять страницы логина и навигацию до загрузки полного текста
- подтянуть в ответ актуальные цены и данные со страниц
Примеры запросов агенту
- Найди в вебе свежие материалы про этот API и вытащи текст трёх лучших ссылок
- Разбей запрос «сравнение ORM для Node» на подзапросы и поищи каждый отдельно
- Вытащи страницу по ссылке и покажи только фрагменты, где говорится про лицензию
Как установить octen-mcp
Командой платформы
claude mcp add --env OCTEN_API_KEY=<OCTEN_API_KEY> --env OCTEN_API_URL=<OCTEN_API_URL> --transport stdio octen-mcp -- npx -y octen-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add octen-mcp --env OCTEN_API_KEY=<OCTEN_API_KEY> --env OCTEN_API_URL=<OCTEN_API_URL> -- npx -y octen-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"octen-mcp": {
"command": "npx",
"args": [
"-y",
"octen-mcp"
],
"env": {
"OCTEN_API_KEY": "<OCTEN_API_KEY>",
"OCTEN_API_URL": "<OCTEN_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"octen-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"octen-mcp"
],
"env": {
"OCTEN_API_KEY": "<OCTEN_API_KEY>",
"OCTEN_API_URL": "<OCTEN_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OCTEN_API_KEY=<OCTEN_API_KEY> -e OCTEN_API_URL=<OCTEN_API_URL> octen-mcp npx -y octen-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о octen-mcp
Как установить octen-mcp в Claude Code?
Через маркетплейс плагинов: сначала claude plugin marketplace add Octen-Team/octen-mcp, затем claude plugin install octen@octen. Плагин приносит хостед-сервер и два скилла, octen-web-search и octen-research.
Что делает octen-mcp?
Даёт агенту поиск по живому вебу и извлечение страниц в чистый текст. Вместе с текстом приходят метка категории, тип страницы и ранжированные фрагменты по запросу.
Нужен ли ключ API?
Ключ OCTEN_API_KEY берётся на octen.ai, но клиенты с OAuth могут подключиться без него — плагин для Claude проходит вход при первом вызове. Если ключ всё же используется, передавайте его заголовком x-api-key, а не в URL.
