Claude Info
Исследования

RedditLens

0xMassi/redditlens

CLI + Claude Code скилл для маркетингового исследования Reddit. Ищет реальные боли пользователей через Serper API, обогащает данные через публичный .json Reddit, кластеризует проблемы и генерирует ценностные ответы. Для фаундеров и маркетологов.

Установка

terminal
bash
npx redditlens search "notion alternatives" --period month --comments

README

Небольшой CLI + скилл для Claude Code, превращающий Reddit в движок маркетинговых исследований. Ответь на пять вопросов — получи отчёт о болях аудитории с готовыми ответами для публикации.

Создан для фаундеров, инди-хакеров и маркетологов, которые хотят находить реальных клиентов, а не кричать в пустоту.

Что делает

  1. Ты отвечаешь на пять вопросов о продукте, аудитории и тоне общения.
  2. redditlens ищет на Reddit через Google (Serper API) «язык боли» — не названия брендов.
  3. Каждый результат обогащается через публичный .json-эндпоинт Reddit: оценки и топовые комментарии.
  4. Агент кластеризует боли и составляет ответы, начинающиеся с эмпатии и ценности.

Никаких трюков со скрапингом. Никаких ключей 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 на несколько недель.

  1. Перейди на serper.dev
  2. Зарегистрируйся через Google или email
  3. Скопируй ключ API из дашборда
  4. Экспортируй его:
export SERPER_API_KEY=your_key_here

Добавь в профиль шелла (~/.zshrc, ~/.bashrc) для постоянного хранения.

Использование

CLI

bash
# Поиск болей в нише
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).

Затем:

bash
export PROXIES_FILE=./proxies.txt
redditlens search "pain language" --limit 50 --comments

Подходит любой HTTP/HTTPS-провайдер прокси (для Reddit рекомендуются резидентские — датацентровые IP блокируются быстро).

Сценарии использования

1. Валидация идеи продукта

Ты думаешь, что фаундеры ненавидят свой текущий инструмент для выставления счетов. Прежде чем что-то строить:

bash
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 как часть более широкого исследовательского пайплайна:

bash
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, yearweek
--limitМаксимум результатов20
--commentsВключить топовые комментариивыкл.

Похожие скиллы