producthunt

1# ProductHunt Skill
2 
3Get posts, topics, users, and collections from Product Hunt via the official GraphQL API.
4 
5## Prerequisites
6 
7Set access token in `~/.zshrc`:
8```bash
9export PRODUCTHUNT_ACCESS_TOKEN="your_developer_token"
10```
11 
12Get your token from: https://www.producthunt.com/v2/oauth/applications
13 
14**Quick Check**:
15```bash
16cd <skill_directory>
17python3 scripts/get_posts.py --limit 3
18```
19 
20## Commands
21 
22All commands run from the skill directory.
23 
24### Posts
25```bash
26python3 scripts/get_post.py chatgpt                    # Get post by slug
27python3 scripts/get_post.py 12345                      # Get post by ID
28python3 scripts/get_posts.py --limit 20                # Today's featured posts
29python3 scripts/get_posts.py --topic ai --limit 10     # Posts in topic
30python3 scripts/get_posts.py --after 2026-01-01        # Posts after date
31python3 scripts/get_post_comments.py POST_ID --limit 20
32```
33 
34### Topics
35```bash
36python3 scripts/get_topic.py artificial-intelligence  # Get topic by slug
37python3 scripts/get_topics.py --query "AI" --limit 20 # Search topics
38python3 scripts/get_topics.py --limit 50              # Popular topics
39```
40 
41### Users
42```bash
43python3 scripts/get_user.py rrhoover                  # Get user by username
44python3 scripts/get_user_posts.py rrhoover --limit 20 # User's posts
45```
46 
47### Collections
48```bash
49python3 scripts/get_collection.py SLUG_OR_ID          # Get collection
50python3 scripts/get_collections.py --featured --limit 20
51```
52 
53## API Info
54…