Skill

producthunt

Read Product Hunt from your terminal — works token-free for the daily skim, unlocks a launch-day cockpit and a marketer research desk in one onboarding step.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use producthunt

Choose if

You're a maker prepping a Product Hunt launch (needs the launch-day cockpit and time-window analysis) or a marketer tracking competitor launches and trending products. Alternative: hitting producthunt.com by hand or polling the RSS feed directly loses the GraphQL-only fields (votes, makers, comments) and the complexity-budget reporting.

Avoid if

You need to post or upvote on Product Hunt (the CLI is read-only by design), or your workflow needs maker/voter PII reliably surfaced — OAuth client_credentials mode returns [REDACTED] for most user fields. Also avoid if a heavy GraphQL workload would burn through the 6,250 point / 15-min complexity budget without graceful backoff.

Risk Flags

  • MEDIUM rate_limit Product Hunt's GraphQL API enforces a per-token complexity budget of 6,250 points / 15 min. Heavy commands return RATE_LIMIT_EXCEEDED; `producthunt whoami` reports remaining budget and reset epoch.
  • LOW data_quality Public RSS feed entries are missing votes, comments, and makers — those fields require the GraphQL token. With OAuth client_credentials mode, maker names and commenter usernames render as [REDACTED] for most user fields and `whoami` returns null.
  • LOW scope Read-only by default — "this CLI does not create, update, delete, publish, send, or mutate." Agents can't post launches, comment, or upvote through this surface.

Cost

Type: Freemium · Free tier: The public Atom feed is fully token-free and powers the daily skim plus basic queries. GraphQL access (votes, makers, comments, complexity-budget queries) requires a free Product Hunt personal developer token — no paid tier mentioned in the README.

Install

Default

npx -y @mvanhorn/printing-press install producthunt
# Token-free for the daily skim. For votes/makers/comments, add a
# free PH personal developer token:
export PRODUCTHUNT_API_KEY=<your-token>

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js 18+ (or Go 1.26.3+ for source install)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT