Redd-Archiver MCP
Генератор архивов Reddit, Voat и Ruqqus из дампов на PostgreSQL с поиском и MCP-сервером на 29 инструментов для агента
- 349 ★ репозитория
- Последний коммит
- Unlicense
Расширенный доступ
Почему такой уровень
- Инструмент разворачивает PostgreSQL, веб-сервер поиска и контейнеры Docker, а архив можно открыть наружу через Tor или HTTPS
- Через агента проходят тексты и имена авторов из архивов, в которых бывают личные данные
Установка
- Работает в
Ручная установка
{
"mcpServers": {
"reddarchiver": {
"command": "uv",
"args": ["--directory", "/path/to/mcp_server", "run", "python", "server.py"],
"env": { "REDDARCHIVER_API_URL": "http://localhost:5000" }
}
}
}Сначала запустите сервер поиска архива из корня проекта: docker compose up -d search-server. Путь в --directory замените своим.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент разворачивает PostgreSQL, веб-сервер поиска и контейнеры Docker, а архив можно открыть наружу через Tor или HTTPS
- Через агента проходят тексты и имена авторов из архивов, в которых бывают личные данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Redd-Archiver превращает сжатые дампы Reddit, Voat и Ruqqus в просматриваемый архив. Инструмент загружает данные в PostgreSQL и собирает из базы страницы HTML с мобильной версткой, полнотекстовым поиском и одиннадцатью цветовыми темами. Платформу он узнает по расширению файла: для Reddit это `.zst` в формате JSON Lines из Pushshift или Arctic Shift, для Voat дампы SQL, для Ruqqus `.7z`. Архив отдается в трех режимах. Статический выгружается один раз и размещается на любом хостинге, в том числе на GitHub Pages или на флешке. Гибридный, он стоит по умолчанию, добавляет сервер поиска на nginx, Flask и PostgreSQL. Динамический рендерит страницы из базы без шага выгрузки. Свежесть поддерживают ежемесячные дампы Arctic Shift: команда `reddarc.py --update` применяет их к существующему архиву, а `--update-all` проходит по папке с дампами. Для агентов в репозитории лежит MCP-сервер на FastMCP. Он строит 29 инструментов по описанию OpenAPI REST-интерфейса архива, отдает пять ресурсов (статистика, лучшие посты, сообщества, справка по поиску) и ограничивает размер ответа, чтобы не переполнить контекст. Агент ищет посты и комментарии, смотрит пользователей и считает агрегаты по вашему архиву.
Для кого. Для исследователей, архивистов и аналитиков, которые держат у себя копию сообществ Reddit и хотят задавать вопросы к ней через Claude.
Подходит, если
- У вас есть дамп нужного сабреддита и нужен локальный архив с поиском
- Сообщество могут закрыть, и его обсуждения нужно сохранить для чтения без интернета
- Агент должен искать посты, комментарии и авторов по вашему архиву, не обращаясь к Reddit
- Архив надо держать свежим по ежемесячным дампам без пересборки с нуля
- Нужно выложить статический архив на GitHub Pages или раздать его скрытым сервисом Tor
Не подходит, если
- Нужны свежие посты в реальном времени: архив обновляется ежемесячными дампами, а для живого чтения есть MCP-серверы Reddit
- Нет PostgreSQL: он обязателен для импорта и поиска
- Нужны готовые данные: дампы придется скачать отдельно, архив их сам не добывает
- Вы собираетесь публиковать чужие данные с личной информацией авторов, не оценив юридические последствия
Пример запроса к агенту
Найди в архиве сабреддита privacy посты за 2022 год о менеджерах паролей, покажи пять самых обсуждаемых и кратко перескажи комментарииMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
REDDARCHIVER_API_URL- Адрес REST API архива, по умолчанию http://localhost:5000
REDDARCHIVER_MAX_RESPONSE_SIZE- Предельный размер ответа в КБ до усечения, по умолчанию 50
Ограничения
Нужны Python 3.10 или новее и PostgreSQL. Данные инструмент сам не скачивает: дампы Reddit берут из Arctic Shift и Academic Torrents, Voat и Ruqqus из Internet Archive. Дампы большие, требования к памяти и диску смотрите в документации по производительности.
MCP-сервер работает только поверх запущенного сервера поиска архива: без него инструменты не получат данных.
Проект выпущен под лицензией Unlicense. Права на сами материалы сообществ принадлежат их авторам и платформам, поэтому перед публикацией архива оцените правовые условия.
Как отключить. Удалите блок reddarchiver из настроек клиента и перезапустите его. Остановить сервисы можно командой `docker compose stop mcp-server`, а весь стек командой `docker compose down`. База PostgreSQL с архивом хранится отдельно, удалите ее, если архив больше не нужен.
Частые вопросы
Как подключить Redd-Archiver к Claude Desktop?
Запустите сервер поиска архива, затем добавьте в `claude_desktop_config.json` блок reddarchiver с командой `uv` и аргументами `--directory`, путь к папке `mcp_server`, `run`, `python`, `server.py`. В `env` задайте `REDDARCHIVER_API_URL`. Для удаленного архива можно передать `--api-url`.
Какие платформы поддерживаются?
Reddit из дампов `.zst` формата Pushshift или Arctic Shift, Voat из дампов SQL и Ruqqus из `.7z`. Все три платформы можно смешивать в одном архиве.
Чем отличаются статический, гибридный и динамический режимы?
Статический выгружает страницы один раз и работает на любом хостинге, но без поиска. Гибридный, он стоит по умолчанию, добавляет сервер поиска и REST API. Динамический рендерит страницы из PostgreSQL сразу после импорта и добавляет фильтры по флэру и счету.
Как обновлять архив?
Команда `reddarc.py --update RS_2026-01.zst --comments-file RC_2026-01.zst` применяет один месяц, а `--update-all` проходит по папке со скачанными ежемесячными дампами. Импортируются только отслеживаемые сабреддиты, повторные запуски пропускаются по контрольной сумме.
Как не переполнить контекст агента?
В описаниях инструментов есть предупреждения и рекомендации по параметрам `limit`, `fields` и `max_body_length`. Размер ответа ограничивается: по умолчанию 50 КБ, параметр `--max-response-size` меняет предел.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
CLI-движок, который собирает из документов локальную структурированную вики: прозрачная альтернатива обычному RAG с доступом для агента по MCP
MCP-сервер и скиллы от TigerData, с которыми агент пишет схемы и запросы PostgreSQL по актуальной документации и практикам
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
Официальный MCP-сервер Redis: строки, хеши, стримы, JSON и векторный поиск через агента
MCP-сервер подключает Claude Code и Codex к открытой сессии R или Python в RStudio и Positron, где лежат ваши данные
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Redd-Archiver (эта запись) | нет | не нужна | 349 | |
| Reddit MCP Buddy | нет | не нужна | 866 | читает живой Reddit |
| MCP Reddit Server | нет | не нужна | 434 | сервер для чтения горячих тем сабреддита с анализом |
Коротко о README
Описание открывается таблицей платформ с объемами данных и объяснением трех режимов раздачи. Дальше идут обновления по ежемесячным дампам, быстрый старт с развертыванием через Tor или HTTPS, раздел про MCP-сервер и перечень возможностей для читателей и операторов.