home / skills / resciencelab / opc-skills / producthunt

producthunt skill

safe

/skills/producthunt

This skill helps you search and retrieve posts, topics, users, and collections from Product Hunt via GraphQL API.

npx playbooks add skill resciencelab/opc-skills --skill producthunt

Review the files below or copy the command above to add this skill to your agents.

Files (13)

SKILL.md

1.8 KB

---
name: producthunt
description: Search and retrieve content from Product Hunt. Get posts, topics, users, and collections via the GraphQL API. Use when user mentions Product Hunt, PH, or product launches.
---

# ProductHunt Skill

Get posts, topics, users, and collections from Product Hunt via the official GraphQL API.

## Prerequisites

Set access token in `~/.zshrc`:
```bash
export PRODUCTHUNT_ACCESS_TOKEN="your_developer_token"
```

Get your token from: https://www.producthunt.com/v2/oauth/applications

**Quick Check**:
```bash
cd <skill_directory>
python3 scripts/get_posts.py --limit 3
```

## Commands

All commands run from the skill directory.

### Posts
```bash
python3 scripts/get_post.py chatgpt                    # Get post by slug
python3 scripts/get_post.py 12345                      # Get post by ID
python3 scripts/get_posts.py --limit 20                # Today's featured posts
python3 scripts/get_posts.py --topic ai --limit 10     # Posts in topic
python3 scripts/get_posts.py --after 2026-01-01        # Posts after date
python3 scripts/get_post_comments.py POST_ID --limit 20
```

### Topics
```bash
python3 scripts/get_topic.py artificial-intelligence  # Get topic by slug
python3 scripts/get_topics.py --query "AI" --limit 20 # Search topics
python3 scripts/get_topics.py --limit 50              # Popular topics
```

### Users
```bash
python3 scripts/get_user.py rrhoover                  # Get user by username
python3 scripts/get_user_posts.py rrhoover --limit 20 # User's posts
```

### Collections
```bash
python3 scripts/get_collection.py SLUG_OR_ID          # Get collection
python3 scripts/get_collections.py --featured --limit 20
```

## API Info
- **Endpoint**: https://api.producthunt.com/v2/api/graphql
- **Type**: GraphQL
- **Rate Limits**: 6250 complexity points / 15 min
- **Docs**: https://api.producthunt.com/v2/docs

Overview

This skill connects to Product Hunt to search and retrieve posts, topics, users, and collections via the Product Hunt GraphQL API. It is designed for solopreneurs and agents who need structured product launch data, topic discovery, and user activity. Use it when you need authoritative, up-to-date Product Hunt content for research, monitoring, or content creation.

How this skill works

The skill uses your Product Hunt developer access token to call the official GraphQL endpoint and fetch posts, topics, users, collections, and comments. Commands let you query by slug, ID, topic, date range, or search term and return structured JSON-like results for easy downstream processing. Rate limits are managed by the API; the skill exposes simple scripts to run common queries from the command line.

When to use it

Monitor new product launches and featured posts
Research products or makers before outreach or partnerships
Find topic-specific content and trends on Product Hunt
Aggregate user activity and post comments for sentiment or feedback analysis
Curate collections or discover community-curated lists for content

Best practices

Set your PRODUCTHUNT_ACCESS_TOKEN as an environment variable and keep it secure
Specify limits and date filters to reduce API load and stay within rate limits
Use topic and query filters to narrow results and avoid unnecessary requests
Cache results for repeated queries when building dashboards or reports
Validate and sanitize returned fields before displaying or storing externally

Example use cases

Fetch today’s featured posts to power a newsletter or daily digest
Search Product Hunt topics for "AI" to discover new tools and trends
Retrieve a maker’s recent posts to prepare for outreach or competitive research
Pull comments on a product to surface user feedback and common issues
Export collections to curate resources for a landing page or resource guide

FAQ

How do I authenticate this skill?

Set PRODUCTHUNT_ACCESS_TOKEN in your environment with a Product Hunt developer token from your applications page.

What endpoint and API type does it use?

It calls https://api.producthunt.com/v2/api/graphql using Product Hunt’s GraphQL API and returns structured results.