map-your-market

​

Install

npx "@opendirectory.dev/skills" install map-your-market --target claude

npx skills add Varnan-Tech/opendirectory --skill map-your-market

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

​

What It Does

• Accepts any combination of: product description, category keywords, competitor names
• Auto-detects relevant subreddits from the category
• Searches Reddit public JSON API for pain posts (top posts, last 12 months)
• Searches Hacker News Algolia API for stories and Ask HN threads
• Searches GitHub Issues on competitor repos for high-reaction complaints
• Scrapes G2 category pages for vendor count and top products
• Fetches Google Trends direction (up / flat / down) for the category
• Scores every signal by source weight and recency (GitHub issues score 3x Reddit — more deliberate signal)
• Clusters top 60 signals into 5-7 named pain themes
• Extracts ICP from subreddit and post metadata (not just content)
• Generates a positioning framework with messaging angles using verbatim market language
• Saves output to docs/market-maps/[category]-[date].md + JSON snapshot

​

Requirements

​

Setup

cp .env.example .env
# Add GITHUB_TOKEN if you want higher GitHub rate limits

​

How to Use

"Map my market: I build developer observability tools"
"Who is my ICP? Competitors: Datadog, Grafana, New Relic"
"What are the top pains in the HR software market?"
"Find messaging angles for my B2B analytics tool"
"Map the CRM market. What are people complaining about?"
"I build payment APIs. Who should I be selling to?"

​

Why This Instead of Manual Research

• Reading Reddit threads, taking notes
• Scrolling HN “Ask HN” posts
• Checking G2 review counts per vendor
• Looking up Google Trends
• Synthesizing into a document

​

The Pain Score

• GitHub issue reactions: reactions * 3 — a developer deliberately clicking +1 is the strongest signal
• Reddit: upvotes + (comments * 0.3) — upvotes count more than comments (comments include noise)
• HN: points + (comments * 0.3) — same structure

​

Velocity Tracking

​

Cost Per Run

• Reddit, HN, Google Trends: free, no auth
• GitHub Issues: free with optional token
• G2 scrape: free HTML fetch
• AI analysis: uses the model already running the skill
• Total: free

​

Standalone Script

# Basic usage
python3 scripts/fetch.py "developer observability"

# With competitors
python3 scripts/fetch.py "developer observability" --competitors "Datadog,Grafana,New Relic"

# With product context
python3 scripts/fetch.py "B2B analytics" --context "We help ops teams track spend"

# Print to stdout
python3 scripts/fetch.py "devops tooling" --stdout | jq '.summary'

# With GitHub token for higher rate limits
GITHUB_TOKEN=your_token python3 scripts/fetch.py "CRM software" --competitors "Salesforce,HubSpot" --output results.json

​

Project Structure

map-your-market/
├── SKILL.md
├── README.md
├── .env.example
├── scripts/
│   └── fetch.py           standalone data collector
├── evals/
│   └── evals.json
└── references/
    ├── subreddit-map.md   category to subreddit mapping
    ├── pain-scoring.md    scoring formula and tier thresholds
    └── icp-signals.md     how to extract ICP from post metadata

​

License