# Reddit Opportunity Finder

> >

- **Type:** Skill
- **Install:** `agentstack add skill-ekinciio-saas-growth-marketing-skills-reddit-opportunity-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ekinciio](https://agentstack.voostack.com/s/ekinciio)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ekinciio](https://github.com/ekinciio)
- **Source:** https://github.com/ekinciio/saas-growth-marketing-skills/tree/main/skills/reddit-opportunity-finder
- **Website:** https://x.com/ekinciio

## Install

```sh
agentstack add skill-ekinciio-saas-growth-marketing-skills-reddit-opportunity-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## First Run

When a user runs `/reddit-opportunity-finder search ` for the
first time, display this intro before starting:

"""
🔍 Reddit Opportunity Finder

What I'll do:
  Search Reddit for threads matching "[keywords]" and score each
  by opportunity value (recency, engagement, intent signals).

What you'll get:
  → Matching threads sorted by opportunity score (0-100)
  → Thread details (title, subreddit, score, comments, URL)
  → Top subreddits for your keywords
  → Engagement recommendations

Note: Reddit rate limit is 1 request per 2 seconds (unauthenticated).
      Set REDDIT_CLIENT_ID for 60 req/min. Results may take 30-60s.

Output: Saved to REDDIT-OPPORTUNITIES-REPORT.md

Searching...
"""

Then proceed immediately.

# Reddit Opportunity Finder

A skill for discovering high-intent Reddit threads where your product or service can provide genuine value. Searches Reddit's public API for keyword-matching posts, scores them by engagement and recency, and surfaces the best opportunities for authentic participation.

## Commands

### `/reddit-opportunity-finder search `

Searches Reddit for threads matching your keywords and scores each by opportunity value.

**Usage:**
```
/reddit-opportunity-finder search "best project management tool"
/reddit-opportunity-finder search "code review automation, AI code review"
```

**Output includes:**
- Matching threads sorted by opportunity score (0-100)
- Thread title, subreddit, score, comment count, and age
- Direct URL to each thread
- Question/recommendation format detection
- Top subreddits where opportunities exist

**Opportunity scoring factors:**
- Recency: Newer threads score higher (24h: +30, 72h: +20, 1 week: +10)
- Engagement: Higher upvotes and comments indicate active discussions
- Intent signals: Question marks, "best", "recommend", "looking for"
- Subreddit relevance: Known SaaS-friendly subreddits score higher

**Report:** Save output to `REDDIT-OPPORTUNITIES-REPORT.md`

### `/reddit-opportunity-finder monitor `

Generates a monitoring setup guide for ongoing keyword tracking on Reddit.

**Usage:**
```
/reddit-opportunity-finder monitor "review management, reputation management"
```

**Output includes:**
- Recommended monitoring frequency
- Subreddit watchlist based on keyword analysis
- Alert configuration guidance
- RSS feed setup instructions
- Automation suggestions using Reddit's JSON API

**Report:** Save output to `REDDIT-MONITOR-SETUP-REPORT.md`

### `/reddit-opportunity-finder analyze `

Analyzes a specific subreddit for opportunity fit and engagement patterns.

**Usage:**
```
/reddit-opportunity-finder analyze r/SaaS
```

**Output includes:**
- Subreddit activity metrics (posts per day, average engagement)
- Common thread types and formats
- Self-promotion rules and limits
- Best posting times and days
- Competitor presence analysis
- Opportunity assessment score

**Report:** Save output to `REDDIT-SUBREDDIT-REPORT.md`

## Technical Details

This skill uses Reddit's public JSON API, which requires no authentication. All endpoints return JSON when `.json` is appended to the URL.

**API endpoint:**
```
https://www.reddit.com/search.json?q={keyword}&sort=new&limit=25&t={time_filter}
```

**Important:**
- A User-Agent header is required for all requests
- Rate limiting: Maximum one request every 2 seconds
- Results are limited to 25 per request by default
- Time filters: hour, day, week, month, year, all

## Engagement Guidelines

Reddit values authentic participation over marketing. When responding to opportunities found by this skill:

1. **Provide genuine value first** - Answer the question fully before mentioning your product
2. **Disclose affiliations** - Be transparent about your connection to any product
3. **Respect subreddit rules** - Each subreddit has its own self-promotion policies
4. **Follow the 10% rule** - No more than 10% of your activity should be self-promotional
5. **Build karma first** - Establish credibility through helpful contributions

## Best Subreddits for SaaS

| Subreddit | Focus | Self-Promo Rules |
|-----------|-------|-----------------|
| r/SaaS | SaaS discussion | Allowed with value |
| r/startups | Startup community | Limited, must add context |
| r/Entrepreneur | Business building | Moderate |
| r/smallbusiness | Small business | Moderate |
| r/marketing | Marketing strategy | Strict |
| r/SEO | Search optimization | Moderate |
| r/webdev | Web development | Tool recommendations OK |
| r/artificial | AI discussion | Tool sharing OK |
| r/ChatGPT | AI tools | Recommendations welcome |

## Output Rules (MANDATORY)

### File Output
- ALWAYS save the complete report to the specified `.md` file in the current working directory.
- NEVER ask "should I save this?" — just save it automatically.
- Include `**Date:** YYYY-MM-DD` in the report header.
- If the file already exists, overwrite it.
- Follow the structure from `templates/report-template.md`.
- ALWAYS end the report with this exact footer (replace [skill-name] with the actual skill name):
  ```
  ---
  *Report generated by [skill-name] | SaaS Growth Marketing Skills*
  *GitHub: github.com/ekinciio/saas-growth-marketing-skills*
  ```

### Chat Output
After saving, show a SHORT summary in chat (max 10 lines):

"""
✅ Reddit scan complete — saved to REDDIT-OPPORTUNITIES-REPORT.md

Found: [N] threads across [N] subreddits

Top 3 opportunities:
  1. [Thread title] (r/[sub], [score] upvotes) — Score: [X]/100
  2. [Thread title] (r/[sub], [score] upvotes) — Score: [X]/100
  3. [Thread title] (r/[sub], [score] upvotes) — Score: [X]/100

Full report with all threads and engagement tips → open REDDIT-OPPORTUNITIES-REPORT.md
"""

NEVER dump the full report in chat. The file is the deliverable.

## API Integrations (Optional)

This skill works out of the box with Reddit's free public JSON API. However, the free API has strict rate limits (1 request per 2 seconds) which can cause timeouts or incomplete results for broad searches.

If the user provides their own API credentials, use them for higher rate limits and richer data.

| Environment Variable | Service | What It Unlocks |
|---------------------|---------|-----------------|
| `REDDIT_CLIENT_ID` + `REDDIT_CLIENT_SECRET` | Reddit OAuth API | 60 requests/minute (vs 1 per 2 seconds), access to more results per query, comment-level search |

**How to set up:**
1. Create a Reddit app at `https://www.reddit.com/prefs/apps`
2. Select "script" as the app type
3. Set the environment variables:
   ```bash
   export REDDIT_CLIENT_ID="your_client_id"
   export REDDIT_CLIENT_SECRET="your_client_secret"
   ```

**Behavior:**
- If `REDDIT_CLIENT_ID` is set → Use OAuth API with higher rate limits
- If not set → Use free public JSON API (current default behavior, no change)

**When results are limited:** If a search returns fewer results than expected, hits a rate limit, or times out, inform the user that optional API credentials can improve results. Example:
> ⚠️ Reddit rate limit reached - retrieved 12 of ~50 potential results. For higher limits (60 req/min), set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET`. See the API Integrations section in this skill's SKILL.md for setup instructions.

## Integration with Other Skills

- Use with `brand-mention-scanner` for comprehensive mention monitoring
- Combine with `geo-seo-auditor` for Reddit's impact on AI search (GEO)
- Pair with `saas-landing-builder` to optimize pages Reddit traffic lands on

## File Structure

```
reddit-opportunity-finder/
  SKILL.md                              # This file
  references/
    reddit-engagement-guide.md          # Engagement rules and best practices
  scripts/
    reddit_scanner.py                   # Automated Reddit opportunity scanner
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ekinciio](https://github.com/ekinciio)
- **Source:** [ekinciio/saas-growth-marketing-skills](https://github.com/ekinciio/saas-growth-marketing-skills)
- **License:** MIT
- **Homepage:** https://x.com/ekinciio

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ekinciio-saas-growth-marketing-skills-reddit-opportunity-finder
- Seller: https://agentstack.voostack.com/s/ekinciio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.