requesthunt

Files (4)

• plugin.json · .claude-plugin/
• SKILL.md
• calendar-app-research.md · examples/
• scheduling-tools-research-report.md · examples/

SKILL.md (first lines)

# RequestHunt Skill

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

## Prerequisites

Install the CLI and authenticate:
```bash
curl -fsSL https://requesthunt.com/cli | sh
requesthunt auth login
```

The installer downloads a pre-built binary from [GitHub Releases](https://github.com/ReScienceLab/requesthunt-cli/releases) and verifies its SHA256 checksum before installation. Alternatively, build from source with `cargo install --path cli` from the [requesthunt-cli](https://github.com/ReScienceLab/requesthunt-cli) repository.

The CLI displays a verification code and opens `https://requesthunt.com/device` — the human must enter the code to approve. Verify with:
```bash
requesthunt config show
```
Expected output contains: `resolved_api_key:` with a masked key value (not `null`).

For headless/CI environments, set the API key via environment variable (preferred):
```bash
export REQUESTHUNT_API_KEY="$YOUR_KEY"
```

Or save it to the local config file (created with owner-only permissions):
```bash
requesthunt config set-key "$YOUR_KEY"
```

Get your key from: https://requesthunt.com/dashboard

> **Security**: Never hardcode API keys directly in skill instructions or agent output. Use environment variables or the secured config file.

## Output Modes

Default output is TOON (Token-Oriented Object Notation) — structured and token-efficient.
Use `--json` for raw JSON or `--human` for table/key-value display.

## Platform Selection Guide

Each platform captures different types of user feedback. Choose platforms based on the product category to maximize signal quality.

### Platform Strengths

| Platform | Best For | Signal Type | Typical Yield |
|----------|----------|-------------|---------------|
| **YouTube** | Consumer products, hardware, lifestyle apps | Specific feature asks from review/tutorial comments | High (10-29 per topic) |
| **Reddit** | Developer tools, creator economy, niche communities | Deep technical discussions, long-tail needs | High for dev topics (up to 176) |
| **LinkedIn** | B2B software, healthcare, enterprise tools | Professional/industry opinions, market context | Low volume but high engagement |
| **X** | Trending topics, quick sentiment signals | Fragmented feedback, emotional reactions | Low-medium (1-6 per topic) |
| **GitHub** | Open-source tools, developer infrastructure | Concrete bugs and feature requests from issues | High for OSS, zero for non-tech |
| **Amazon** | Consumer products, electronics, home goods | Product review complaints and feature wishes | High for physical products |

### Recommended Platforms by Category

| Category | Primary | Secondary | Notes |
|----------|---------|-----------|-------|
| **Automotive / Hardware** | YouTube | Amazon, Reddit | Video review comments + Amazon product reviews are richest sources |
| **Gaming / Entertainment** | YouTube | Amazon, Reddit | Game streams, product reviews, and community feedback |
| **Travel / Transportation** | YouTube | Amazon, LinkedIn | Travel vlogs + Amazon gear reviews + business travel needs |
| **Social / Communication** | YouTube | Reddit | App review videos + community discussions |
| **Food / Dining** | YouTube | Amazon, Reddit | Recipe/delivery app reviews + Amazon kitchen product feedback |
| **Real Estate / Home** | Amazon | YouTube, Reddit | Amazon dominates for home improvement and smart home products |
| **Education / Learning** | YouTube | Amazon | Tutorial video comments + Amazon course/book reviews |
| **Health / Medical** | LinkedIn | Amazon, X | Professional healthcare + Amazon health product reviews |
| **Creator Economy** | Reddit | GitHub | Reddit communities overwhelmingly active (Newsletter: 176 requests) |
| **Developer Tools** | Reddit | GitHub | Technical communities + open-source issue trackers |
| **AI / SaaS Products** | Reddit | LinkedIn | Reddit for user complaints, LinkedIn for industry analysis |
| **Consumer Electronics** | Amazon | YouTube, Reddit | Amazon product reviews are the primary signal source |

### Quick Selection Rules

- **Consumer / hardware / lifestyle** → Amazon + YouTube first, Reddit second
- **Developer / creator tools** → Reddit first, GitHub second
- **B2B / enterprise / medical** → LinkedIn first, X second
- **Physical products / electronics** → Amazon first, YouTube second
- **Has open-source projects** → add GitHub
- **Everything** → add X as a supplementary source

## Research Workflow

### Step 1: Define Scope

Before collecting data, clarify with the user:
1. **Research Goal**: What domain/area to investigate?
2. **Specific Products**: Any products/competitors to focus on?
3. **Platform Selection**: Use the guide above to pick 2-3 best platforms for the category
4. **Time Range**: How recent should the feedback be?
5. **Report Purpose**: Product planning / competitive analysis / market research?

### Step 2: Collect Data

Choose platforms strategically based on the category:

```bash
# Consumer hardware — YouTube-first strategy
requesthunt scrape start "smart home devices" --platforms youtube,reddit --depth 2

# Developer tools — Reddit-first strategy
requesthunt scrape start "code editors" --platforms reddit,github --depth 2

# B2B / enterprise — LinkedIn-first strategy
requesthunt scrape start "electronic health records" --platforms linkedin,x --depth 2

# Consumer products — Amazon-first strategy
requesthunt scrape start "wireless earbuds" --platforms amazon,youtube,reddit --depth 2

# Broad research — all platforms
requesthunt scrape start "AI coding assistants" --platforms reddit,x,github,youtube,linkedin,amazon --depth 2

# Search with expansion for more data
requesthunt search "dark mode" --expand --limit 50

# List requests filtered by topic
requesthunt list --topic "ai-tools" --limit 100
```

### Step 3: Generate Report

From ReScienceLab/opc-skills, Apache-2.0.

More from ReScienceLab/opc-skills