product-hunt-scraperlisted
Install: claude install-skill gooseworks-ai/goose-skills
# Product Hunt Scraper
Scrape trending products from Product Hunt using the Apify `maximedupre/product-hunt-scraper` actor.
**Output fields:** Each product has `name`, `tagline`, `description`, `url` (Product Hunt URL), and additional fields depending on the actor's output.
## Quick Start
Requires `APIFY_API_TOKEN` env var (or `--token` flag).
```bash
# Today's top products
python3 skills/product-hunt-scraper/scripts/scrape_producthunt.py \
--time-period daily --max-products 10 --output summary
# This week's products filtered by keyword
python3 skills/product-hunt-scraper/scripts/scrape_producthunt.py \
--time-period weekly --keywords "AI,marketing" --output summary
# Monthly top products as JSON
python3 skills/product-hunt-scraper/scripts/scrape_producthunt.py \
--time-period monthly --max-products 50
```
## CLI Reference
| Flag | Default | Description |
|------|---------|-------------|
| `--time-period` | weekly | `daily`, `weekly`, or `monthly` |
| `--max-products` | 50 | Max products to scrape |
| `--keywords` | none | Keywords to filter (comma-separated, OR logic) |
| `--output` | json | Output format: `json` or `summary` |
| `--token` | env var | Apify token (prefer `APIFY_API_TOKEN` env var) |
| `--timeout` | 300 | Max seconds to wait for the Apify run |
## Notes
- Keyword filtering is client-side on product name + tagline + description
- Results are sorted by upvote count (descending)