RequestHunt Skill

Generate user demand research reports by collecting and analyzing real user feedback from Reddit, X (Twitter), and GitHub.

Prerequisites

Set API key in ~/.zshrc:

export REQUESTHUNT_API_KEY="your_api_key"

Get your key from: https://requesthunt.com/settings/api

Quick Check:

cd <skill_directory>
python3 scripts/get_usage.py

Research Workflow

This skill helps you generate comprehensive user demand research reports. Follow this workflow:

Step 1: Define Scope

Before collecting data, clarify with the user:

Research Goal: What domain/area to investigate? (e.g., AI coding assistants, project management tools)
Specific Products: Any products/competitors to focus on? (e.g., Cursor, GitHub Copilot)
Platform Preference: Which platforms to prioritize? (reddit, x, github)
Time Range: How recent should the feedback be?
Report Purpose: Product planning / competitive analysis / market research?

Step 2: Collect Data

# 1. Trigger realtime scrape for the topic
python3 scripts/scrape_topic.py "ai-coding-assistant" --platforms reddit,x,github

# 2. Search with expansion for more data
python3 scripts/search_requests.py "code completion" --expand --limit 50

# 3. List requests filtered by topic
python3 scripts/list_requests.py --topic "ai-tools" --limit 100

Step 3: Generate Report

Analyze collected data and generate a structured Markdown report:

# [Topic] User Demand Research Report

## Overview
- Scope: ...
- Data Sources: Reddit (X), X (Y), GitHub (Z)
- Time Range: ...

## Key Findings

### 1. Top Feature Requests
| Rank | Request | Sources | Representative Quote |
|------|---------|---------|---------------------|

### 2. Pain Points Analysis
- **Pain Point A**: ...

### 3. Competitive Comparison (if specified)
| Feature | Product A | Product B | User Expectations |

### 4. Opportunities
- ...

## Methodology
Based on N real user feedbacks collected via RequestHunt...

Commands

All commands run from the skill directory.

List Requests

python3 scripts/list_requests.py --limit 20                    # Recent requests
python3 scripts/list_requests.py --topic "ai-tools" --limit 10 # By topic
python3 scripts/list_requests.py --platforms reddit,github     # By platform
python3 scripts/list_requests.py --category "Developer Tools"  # By category
python3 scripts/list_requests.py --sortBy top --limit 20       # Top voted

Search Requests

python3 scripts/search_requests.py "authentication" --limit 20
python3 scripts/search_requests.py "oauth" --expand            # With realtime expansion
python3 scripts/search_requests.py "API rate limit" --expand --platforms reddit,x

Get Topics

python3 scripts/get_topics.py                                  # List all topics by category

Check Usage

python3 scripts/get_usage.py                                   # View API usage stats

Scrape Topic (Realtime)

python3 scripts/scrape_topic.py "developer-tools"              # Default: reddit,x
python3 scripts/scrape_topic.py "ai-assistant" --platforms reddit,x,github

API Info

Base URL: https://requesthunt.com
Auth: Bearer token (API key)
Rate Limits:
- Cached requests: 1000/month
- Realtime requests: 500/month (scraping is expensive)
Docs: https://requesthunt.com/docs