Skip to content

AI agent for mining micro-product ideas using existing demand methodology

Notifications You must be signed in to change notification settings

11me/idea-miner

Repository files navigation

⛏️ Idea Miner

AI agent for discovering micro-product opportunities using the "existing demand" methodology: find products with proven users → extract ONE function → make it simpler.

🎯 What it does

  1. 🔍 Searches multiple sources (Chrome Web Store, Product Hunt) across specified niches
  2. 📊 Finds products with proven demand (10k+ users, good ratings)
  3. 🔬 Deep analysis of each product:
    • Features, target audience, pricing model
    • Review mining: extracts recurring complaints, missing features, UX issues
    • Identifies weaknesses and simple use cases not handled well
  4. 💡 Generates micro-product ideas in "one function" format:
    • Concrete input→output examples
    • Evidence of existing demand
    • How it differs from bloated competitors
  5. 📈 Scores each idea (1-10) on:
    • Existing demand, time-saving potential, monetization
    • Competition saturation, MVP simplicity, personal fit
  6. 📝 Outputs sorted by score:
    • JSON for programmatic use
    • Markdown summary for human review

🚀 Quick Start

# Install dependencies
npm install

# Run in mock mode (no API keys required)
npm run mine

# Check results
cat out/ideas-summary-*.md

⚙️ CLI Options

# Single niche
npm run mine -- --niche="YouTube creators"

# Multiple niches (semicolon-separated)
npm run mine -- --niches="YouTube creators;Developers and programmers"

# Custom search query
npm run mine -- --query="AI writing assistant"

# Set minimum score threshold (default: 5)
npm run mine -- --min-score=7

# Enable Google Trends analysis (enabled by default in real mode)
npm run mine -- --enable-trends

# Skip Google Trends analysis
npm run mine -- --skip-trends

# Filter by minimum search demand (requires --enable-trends)
npm run mine -- --enable-trends --min-search-demand=6

📚 Documentation

🧮 Idea Scoring

Each idea is scored on 8 dimensions (1-10 scale):

Metric Weight Description
Existing Demand 18% Competitors, user counts
Time Saving 12% How much time does user save
Monetization 18% B2B/creator audience, willingness to pay
Competition -10% How crowded (high = bad)
Simplicity 13% Can build MVP in weekend-month
Personal Fit 9% Matches your skills
Platform Risk -15% ToS/policy risk (high = bad)
Search Demand 15% Google Trends data for US/Europe

finalScore = weighted sum, normalized to 1-10 scale.

Ideas with platformRisk >= 7 or matching risky patterns (downloaders, mass actions) are auto-filtered.

🔎 SEO Analysis

When --enable-trends is active, each idea gets:

  • Primary keyword: main search query users would type
  • Secondary keywords: related long-tail queries
  • Suggested name: SEO-friendly product name
  • Search regions: US + major EU countries (GB, DE, FR, ES, IT, NL, SE, PL)

This data helps validate search demand and plan SEO strategy before building.

Note: Google Trends API has strict rate limits. If you see many failures, the system will automatically use fallback scores (searchDemand=4) and continue processing. Keyword generation uses OPENAI_API_KEY (same as browser automation).

🎨 Supported Niches

  • 🎬 YouTube creators
  • 📱 Instagram Reels editors
  • 🎵 TikTok content creators
  • 📊 Excel/Google Sheets power users
  • ✍️ Copywriters and content marketers
  • 🛒 Small e-commerce owners
  • 💻 Developers and programmers
  • 🎓 Students and researchers

🌐 Sources

  • ✅ Chrome Web Store (browser extensions)
  • 🔜 Product Hunt (coming soon)

🛠️ Tech Stack

  • Stagehand - AI browser automation
  • Zod - schema validation
  • TypeScript / Node.js 20+

📄 License

MIT

About

AI agent for mining micro-product ideas using existing demand methodology

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published