# Argus Retrieval

Сервер перенаправляет поисковые запросы ИИ-агента через 14 провайдеров, извлекает текст со страниц и восстанавливает недоступные ссылки. Помогает собирать исследовательские подборки документов.

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

## Что делает

Инструмент объединяет поиск и парсинг веб-страниц для ассистента. Внутри заложено 14 провайдеров с автопереключением при исчерпании бюджета. Сервер начинает работу без платных ключей через DuckDuckGo и Yahoo. Текст со страниц извлекается по цепочке из 12 шагов фильтрации.

Доступно четыре сценария работы. Сервер умеет искать факты и доставать копии удалённых статей через архивные снимки. Собранные данные уходят в системную папку пользователя, поэтому репозиторий остаётся чистым.

Для работы нужен Python 3.11+. Без флага `ARGUS_MCP_STANDALONE=true` автономный локальный брокер не запустится. Платные сервисы вроде Brave или Tavily подключаются через переменные окружения.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `ARGUS_WOLFRAM_API_KEY`, `ARGUS_BRAVE_API_KEY`, `ARGUS_TAVILY_API_KEY`, `ARGUS_EXA_API_KEY`, `ARGUS_SERPER_API_KEY`, `ARGUS_LINKUP_API_KEY`, `ARGUS_SEARXNG_BASE_URL`, `ARGUS_DATA_ROOT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add argus -e ARGUS_WOLFRAM_API_KEY=<ARGUS_WOLFRAM_API_KEY> -e ARGUS_BRAVE_API_KEY=<ARGUS_BRAVE_API_KEY> -e ARGUS_TAVILY_API_KEY=<ARGUS_TAVILY_API_KEY> -e ARGUS_EXA_API_KEY=<ARGUS_EXA_API_KEY> -e ARGUS_SERPER_API_KEY=<ARGUS_SERPER_API_KEY> -e ARGUS_LINKUP_API_KEY=<ARGUS_LINKUP_API_KEY> -- uvx argus-search
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from argus-search <команда>

### Codex

**Командой платформы**
```bash
codex mcp add argus-retrieval --env ARGUS_WOLFRAM_API_KEY=<ARGUS_WOLFRAM_API_KEY> --env ARGUS_BRAVE_API_KEY=<ARGUS_BRAVE_API_KEY> --env ARGUS_TAVILY_API_KEY=<ARGUS_TAVILY_API_KEY> --env ARGUS_EXA_API_KEY=<ARGUS_EXA_API_KEY> --env ARGUS_SERPER_API_KEY=<ARGUS_SERPER_API_KEY> -- uvx argus-search
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from argus-search <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "argus-retrieval": {
            "command": "uvx",
            "args": [
                "argus-search"
            ],
            "env": {
                "ARGUS_WOLFRAM_API_KEY": "<ARGUS_WOLFRAM_API_KEY>",
                "ARGUS_BRAVE_API_KEY": "<ARGUS_BRAVE_API_KEY>",
                "ARGUS_TAVILY_API_KEY": "<ARGUS_TAVILY_API_KEY>",
                "ARGUS_EXA_API_KEY": "<ARGUS_EXA_API_KEY>",
                "ARGUS_SERPER_API_KEY": "<ARGUS_SERPER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from argus-search <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "argus-retrieval": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "argus-search"
            ],
            "env": {
                "ARGUS_WOLFRAM_API_KEY": "<ARGUS_WOLFRAM_API_KEY>",
                "ARGUS_BRAVE_API_KEY": "<ARGUS_BRAVE_API_KEY>",
                "ARGUS_TAVILY_API_KEY": "<ARGUS_TAVILY_API_KEY>",
                "ARGUS_EXA_API_KEY": "<ARGUS_EXA_API_KEY>",
                "ARGUS_SERPER_API_KEY": "<ARGUS_SERPER_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from argus-search <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ARGUS_WOLFRAM_API_KEY=<ARGUS_WOLFRAM_API_KEY> -e ARGUS_BRAVE_API_KEY=<ARGUS_BRAVE_API_KEY> -e ARGUS_TAVILY_API_KEY=<ARGUS_TAVILY_API_KEY> -e ARGUS_EXA_API_KEY=<ARGUS_EXA_API_KEY> -e ARGUS_SERPER_API_KEY=<ARGUS_SERPER_API_KEY> argus-retrieval uvx argus-search
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from argus-search <команда>

## Когда брать
- Извлечь очищенный текст со страницы по URL без лишней разметки
- Восстановить содержимое недоступной или удалённой статьи через веб-архивы
- Собрать тематический пакет документации по библиотеке
- Маршрутизировать поисковые запросы по нескольким внешним провайдерам

## Примеры запросов агенту
- Найди последние изменения в спецификации веб-фреймворка через DuckDuckGo
- Извлеки текст статьи по адресу `https://example.com/article` и подготовь выжимку
- Восстанови удалённый материал по ссылке `https://example.com/dead-post` через архивы

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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