Reddit Sonar

AI-powered Reddit lead generation, from your terminal. Search Reddit for posts, score them as potential leads with AI, summarize threads, watch keywords and competitors in the background, and draft comments — all from a fast, keyboard-driven terminal UI.

Built with Playwright (real browser automation), OpenRouter / DeepSeek (AI), and Ink (React TUI).

Features

• 🔍 Search Reddit — keyword search with time filters (today, week, month, year, all)
• 🎯 AI Lead Scoring — score posts 0–100 against your product profile
• 📡 Lead Listener — watch keywords for new leads in the background
• 👁 Subreddit & Competitor Watch — scan a subreddit's feed or track competitor mentions
• 📊 Insights — lead analytics, trends, and CSV export
• 📝 Post Summarization — AI summarizes posts + comments with relevance angles
• 💬 AI Comment Drafting — natural-sounding Reddit comments drafted by AI
• ⌨️ Terminal UI — keyboard-driven interface with a live hint bar on every screen
• 🔐 Licensed — 5-hour free trial, then a license key tied to your account

Prerequisites

• Node.js ≥ 18
• Google Chrome (or Chromium installed via npx playwright install chromium)
• An OpenRouter or DeepSeek API key — OpenRouter · DeepSeek

Install

npm install -g reddit-sonar

Then launch it:

reddit-sonar

First-time setup

On first run the app launches a Setup Wizard that verifies everything is configured, then opens your browser to sign in with Google — you approve the device from that page, and your free trial starts once the device is authorized:

○ Node.js ≥ 18              — ✓ Node v20.x
○ Playwright + Chrome        — ✓ Chrome launches correctly
○ Reddit logged in           — opens a browser for you to log in
○ AI provider API key        — validates your OpenRouter/DeepSeek key
○ Licensing backend          — checks the service is reachable
○ Search smoke test          — runs a real search to confirm

Press a to run all checks, or Enter on individual steps. Once the required steps pass, press c to continue into the app.

Configuration

Your AI provider and key are set inside the app — press k on the home menu to pick OpenRouter or DeepSeek and paste your key. It is stored only on your machine and never sent anywhere except your chosen AI provider.

If you prefer a file, create config.json in the app-data directory. On Windows this is %APPDATA%\reddit-sonar\config.json; on macOS ~/Library/Application Support/reddit-sonar/config.json; on Linux ${XDG_CONFIG_HOME:-~/.config}/reddit-sonar/config.json.

{
  "AI_PROVIDER": "openrouter",

  "OPENROUTER_API_KEY": "sk-or-v1-...",
  "OPENROUTER_MODEL": "openai/gpt-4o-mini",

  "DEEPSEEK_API_KEY": "sk-...",
  "DEEPSEEK_MODEL": "deepseek-chat"
}

| Key | Default | | -------------------- | --------------------------- | | AI_PROVIDER | openrouter (or deepseek)| | OPENROUTER_API_KEY | (required for OpenRouter) | | OPENROUTER_MODEL | openai/gpt-4o-mini | | DEEPSEEK_API_KEY | (required for DeepSeek) | | DEEPSEEK_MODEL | (your DeepSeek model id) |

You only need a key for the provider you actually use; you can configure both and switch between them instantly with k. For the current DeepSeek model IDs, see the DeepSeek docs.

Usage

reddit-sonar           # normal launch
reddit-sonar --setup   # re-run the setup wizard

Getting around

The app opens on a home menu — every feature is a row there. You never have to memorize a map of keys; a persistent hint bar shows the live shortcuts on every screen.

| Where | Keys | | ---------------- | -------------------------------------------------------------- | | Home menu | ↑ ↓ move · Enter open · 1–9 jump to a row | | Anywhere | Ctrl+L jump to the Listener · Ctrl+C quit · Esc back | | Search | type a keyword · Enter search · Tab change time filter | | Results | ↑ ↓ move · Enter read · b open in browser · f score leads · s summarize · c comment · r re-run · u unfilter | | Post reader | ↑ ↓ scroll · g/G top/bottom · b open in browser · Esc back | | Comment editor | type (or Ctrl+D to AI-draft) · Ctrl+S post to Reddit · Esc cancel | | Lists | n new · d delete (press twice to confirm) · Enter select |

Posting a comment is always the deliberate Ctrl+S — Enter only re-shows the review hint, so a stray keystroke can never publish a public comment. After a successful post the draft clears and you return to the results, so the same comment can't be sent twice.

Product profiles

Press p (or open Profiles from the menu) to describe your product. Profiles are used by AI to score leads and generate tailored summaries.

• n — create a new profile
• d — delete the selected profile (press d again to confirm)
• Enter — select and activate

Licensing

Reddit Sonar includes a 5-hour free trial per account (your email). After that, full access requires a license key, which you can buy at wholesaas.com. Your license is tied to your account, so it follows you across machines and reinstalls — activate it from the license screen or from Account Status in the menu. A connection to the licensing service is required to use the app; a valid license keeps working through brief outages.

Troubleshooting

| Problem | Fix | | ----------------------------- | --------------------------------------------------------------------- | | "Chrome not found" | Install Google Chrome, or run npx playwright install chromium | | "Not logged in to Reddit" | Run reddit-sonar --setup and complete the login step | | "No … API key" | Press k in-app to add your OpenRouter/DeepSeek key | | "Backend unreachable" | Check your internet connection, then press Enter to retry | | "Search returned no results" | Check your Reddit login, or try a broader keyword / longer time range | | "AI returned no summary" | Check your provider's credits (openrouter.ai / platform.deepseek.com) |

License

Reddit Sonar is proprietary, commercial software. See the LICENSE file. It is licensed, not sold; copying, redistribution, and resale are not permitted.