name: requesthunt
description: Generate user demand research reports from real user feedback. Scrape and analyze feature requests, complaints, and questions from Reddit, X, and GitHub.
triggers:
- "requesthunt"
- "request hunt"
- "feature request"
- "user demand"
- "demand research"
- "用户需求"
- "需求调研"

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:
1. Research Goal: What domain/area to investigate? (e.g., AI coding assistants, project management tools)
2. Specific Products: Any products/competitors to focus on? (e.g., Cursor, GitHub Copilot)
3. Platform Preference: Which platforms to prioritize? (reddit, x, github)
4. Time Range: How recent should the feedback be?
5. 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