RedditLens
0xMassi/redditlensCLI + Claude Code скилл для маркетингового исследования Reddit. Ищет реальные боли пользователей через Serper API, обогащает данные через публичный .json Reddit, кластеризует проблемы и генерирует ценностные ответы. Для фаундеров и маркетологов.
Установка
npx redditlens search "notion alternatives" --period month --commentsREADME
Небольшой CLI + скилл для Claude Code, превращающий Reddit в движок маркетинговых исследований. Ответь на пять вопросов — получи отчёт о болях аудитории с готовыми ответами для публикации.
Создан для фаундеров, инди-хакеров и маркетологов, которые хотят находить реальных клиентов, а не кричать в пустоту.
Что делает
- Ты отвечаешь на пять вопросов о продукте, аудитории и тоне общения.
redditlensищет на Reddit через Google (Serper API) «язык боли» — не названия брендов.- Каждый результат обогащается через публичный
.json-эндпоинт Reddit: оценки и топовые комментарии. - Агент кластеризует боли и составляет ответы, начинающиеся с эмпатии и ценности.
Никаких трюков со скрапингом. Никаких ключей Reddit API. Никакой базы данных. Одна зависимость (undici). Лицензия MIT.
Установка
npm install -g redditlens
Или запуск без установки:
npx redditlens search "notion alternatives" --period month --comments
Требования
- Node.js 18+
- Ключ Serper API (бесплатно, см. ниже)
Получить бесплатный ключ Serper API
Serper — тонкая обёртка над поиском Google. Бесплатный план даёт 2500 запросов без привязки карты. Этого более чем достаточно для работы с redditlens на несколько недель.
- Перейди на serper.dev
- Зарегистрируйся через Google или email
- Скопируй ключ API из дашборда
- Экспортируй его:
export SERPER_API_KEY=your_key_here
Добавь в профиль шелла (~/.zshrc, ~/.bashrc) для постоянного хранения.
Использование
CLI
# Поиск болей в нише
redditlens search "prompt engineering" --period month --limit 15 --comments
# Ограничить поиск конкретными сабреддитами
redditlens search "notion alternatives" --subreddits productivity,ObsidianMD,PKMS --comments
# Глубокая загрузка одного поста
redditlens post https://reddit.com/r/SaaS/comments/abc123/title/ --comments
# Найти релевантные сабреддиты для ниши
redditlens subreddits "indie hacking"Весь вывод — JSON в stdout. Передавай в jq, в файл или в другой инструмент.
Как скилл Claude Code
Скопируй SKILL.md из этого репозитория в ~/.claude/skills/redditlens/ и перезапусти Claude Code. Затем вызови:
/redditlens
Claude задаст пять вопросов, выполнит поиск, кластеризует боли и составит ответы. Никакого prompt engineering с твоей стороны не требуется.
Без прокси (вежливый режим)
По умолчанию redditlens соблюдает ограничения публичного .json-эндпоинта Reddit. Скорость ограничена 1 запросом в секунду с экспоненциальной задержкой при ответах 429 (2с, 4с, 8с, затем ошибка).
Для целевого сценария — одноразового маркетингового исследования — этого достаточно. Типичный поиск болей затрагивает 15–30 постов, поэтому ожидай 30–60 секунд на запуск.
Делай: запускай redditlens, когда действительно нужно провести исследование. Не делай: не запускай десятки параллельных поисков и не помещай в цикл.
С прокси (высокий объём)
Если нужна скорость или большой объём, укажи список прокси — redditlens будет ротировать их на каждый запрос (без троттлинга).
Создай файл proxies.txt с одним прокси на строку:
1.2.3.4:8080:username:password
5.6.7.8:8080:username:password
9.10.11.12:8080
Поддерживаются форматы с аутентификацией (ip:port:user:pass) и без (ip:port).
Затем:
export PROXIES_FILE=./proxies.txt
redditlens search "pain language" --limit 50 --commentsПодходит любой HTTP/HTTPS-провайдер прокси (для Reddit рекомендуются резидентские — датацентровые IP блокируются быстро).
Сценарии использования
1. Валидация идеи продукта
Ты думаешь, что фаундеры ненавидят свой текущий инструмент для выставления счетов. Прежде чем что-то строить:
redditlens search "hate invoicing" --subreddits SaaS,Entrepreneur,indiehackers --period month --comments
redditlens search "invoicing alternatives" --period month --commentsПочитай кластеры. Если три разные боли всплывают снова и снова — это сигнал. Если это один громкий жалобщик — нет.
2. Поиск клиентов (уважительный способ)
Ты уже построил инструмент. Хочешь найти треды, где можешь реально помочь:
/redditlens
> What are you researching? My product, a lightweight invoicing tool for freelancers
> Who is your target user? Solo freelancers and contractors
> Subreddits? discover
> Time window? week
> Reply tone? casual, helpful
Claude выдаст 3–5 тредов с черновиками ответов. Просмотри их, опубликуй подходящие, пропусти неподходящие.
3. Исследовательский цикл агента
Пусть агент запускает redditlens как часть более широкого исследовательского пайплайна:
SERPER_API_KEY=xxx redditlens search "<topic>" --comments | jq '.posts[] | {title, url, score}'JSON-вывод позволяет любому агенту или скрипту парсить результаты. Claude, GPT, OpenAI Responses — что угодно.
Как это работает
Вопрос пользователя
│
▼
SKILL.md задаёт 5 вопросов
│
▼
redditlens search "<фраза боли>"
│
▼
Serper (Google) → URL постов Reddit
│
▼
Reddit .json endpoint → оценка, комментарии, тело
│ (троттлинг или ротация прокси)
▼
JSON в stdout
│
▼
Агент кластеризует боли, составляет ответы
Ключевой инсайт: .json-эндпоинт Reddit публичен и бесплатен. Никакого ключа API, никакого OAuth. Нужен только Google-поиск для нахождения нужных тредов — и не нужно перегружать эндпоинт.
Справочник CLI
redditlens search "<query>" [options]
redditlens post <reddit-url> [--comments]
redditlens subreddits "<niche>"
Опции поиска
| Флаг | Описание | По умолчанию |
|---|---|---|
--subreddits | Список сабреддитов через запятую | (все) |
--period | Временной диапазон: day, week, month, year | week |
--limit | Максимум результатов | 20 |
--comments | Включить топовые комментарии | выкл. |