# octen-mcp

Даёт агенту живой веб-поиск и вытягивание URL в чистый markdown. Пригодится, когда агенту нужны свежие данные со страниц, а не только код в репозитории.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Автор: Octen-Team
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Octen-Team/octen-mcp
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/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 он попадает в логи прокси и историю браузера.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `OCTEN_API_KEY`, `OCTEN_API_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
codex mcp add octen-mcp --env OCTEN_API_KEY=<OCTEN_API_KEY> --env OCTEN_API_URL=<OCTEN_API_URL> -- npx -y octen-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "octen-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "octen-mcp"
            ],
            "env": {
                "OCTEN_API_KEY": "<OCTEN_API_KEY>",
                "OCTEN_API_URL": "<OCTEN_API_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
gemini mcp add -e OCTEN_API_KEY=<OCTEN_API_KEY> -e OCTEN_API_URL=<OCTEN_API_URL> octen-mcp npx -y octen-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- вытащить статью по ссылке в чистый markdown для контекста модели
- найти свежие новости по теме с фильтром по дате
- разложить широкий запрос на подзапросы и собрать выдачу по каждому
- отсеять страницы логина и навигацию до загрузки полного текста
- подтянуть в ответ актуальные цены и данные со страниц

## Примеры запросов агенту
- Найди в вебе свежие материалы про этот API и вытащи текст трёх лучших ссылок
- Разбей запрос «сравнение ORM для Node» на подзапросы и поищи каждый отдельно
- Вытащи страницу по ссылке и покажи только фрагменты, где говорится про лицензию

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md