Agent skill

Product Hunt Search and Monitoring

by dylanfeltus in dylanfeltus/skills

Looks up Product Hunt launches, products and makers through its GraphQL API: daily top posts, topic browsing and per-post details, using a free developer token.

MITAuto-check passedMarketing & SEO

Install Product Hunt Search and Monitoring

skills CLI
$ npx skills add dylanfeltus/skills --skill producthunt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dylanfeltus/skills producthunt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dylanfeltus/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/producthunt .claude/skills/producthunt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
producthunt
GitHub stars
179
Token cost
~1.7k tokens
SKILL.md length
554 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Looks up Product Hunt launches, products and makers through its GraphQL API: daily top posts, topic browsing and per-post details, using a free developer token.

  • Works in 4 steps: Go to API Dashboard → Create an application (any name/URL works) → Use the Developer Token at the bottom of… → …
  • Checking how a product performed when it launched on Product Hunt
  • SKILL.md covers When to Use, Requirements, Key Limitation: No Text Search and API Overview, plus 9 more sections
  • Calls curl; reaches producthunt.com and api.producthunt.com; needs PH_API_TOKEN

What it does

The agent queries the Product Hunt GraphQL V2 API with curl, using a free developer token kept in the `PH_API_TOKEN` environment variable. Queries cover today's top posts by votes, posts browsed by topic and the full details of one post by its slug, including votes, comments and makers. Setup takes about two minutes through the API dashboard and needs no OAuth flow for read-only access.

The API has no free-text search on posts, so to find a product by name the agent first runs a web search restricted to producthunt.com and then looks up the slug through the API. With no token available it falls back to web search alone. Rate limits are given as about 900 requests per 15 minutes and a complexity limit of 1000 per query. A README.md ships alongside, and the excerpt is cut off in the single-post query.

When your agent uses it

  • Checking how a product performed when it launched on Product Hunt
  • Finding trending products in a category such as developer tools
  • Monitoring Product Hunt for competitors or similar products
  • Answering what launched on Product Hunt today or this week

Example prompts

  • “What were the top five Product Hunt launches today, and how many votes did each get?”
  • “Show the top posts in the developer-tools topic on Product Hunt.”
  • “Look up our competitor's Product Hunt launch and summarize its votes, comments and makers.”

Requirements

  • A free Product Hunt developer token in `PH_API_TOKEN`
  • Network access to `api.producthunt.com`
  • `curl` for sending the GraphQL requests

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Go to API Dashboard
  2. Create an application (any name/URL works)
  3. Use the Developer Token at the bottom of your app's page (no OAuth flow needed for read-only access)
  4. Store the token in an environment variable: PH_API_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit b97a48f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • producthunt.com
    • api.producthunt.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PH_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Product Hunt Search and Monitoring loads about 1.7k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 554 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dylanfeltus/skills at commit b97a48f, republished under its MIT licence (© dylanfeltus). 554 words, ~1,734 tokens.

Download SKILL.mdSave it as .claude/skills/producthunt/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
producthunt
description
Search Product Hunt launches, products, and makers via the GraphQL V2 API. Use when the user asks about Product Hunt launches, trending products, or wants to research a product's reception. Requires a free developer token (~2 min setup).

Product Hunt Search & Monitoring

Search for products, track launches, and monitor Product Hunt activity via the GraphQL V2 API.

When to Use

  • User asks about a product's Product Hunt launch or performance
  • User wants to find trending products in a category
  • User wants to monitor Product Hunt for competitors or similar products
  • User asks "what launched on Product Hunt today/this week"
  • User wants to research a product's reception on PH

Requirements

API Token Required. The Product Hunt API requires authentication — but it's free and takes ~2 minutes to set up.

Getting a Token
  1. Go to API Dashboard
  2. Create an application (any name/URL works)
  3. Use the Developer Token at the bottom of your app's page (no OAuth flow needed for read-only access)
  4. Store the token in an environment variable: PH_API_TOKEN

If no token is available, fall back to using web_search with site:producthunt.com queries.

The Product Hunt API does not support free-text search on posts. You can browse by topic, date, or get a specific post by slug — but you cannot search "AI writing tool" and get matching products.

To find a product by name, use web_search first:

web_search: site:producthunt.com/posts "product name"

Then use the slug from the result to query the API for full details (votes, comments, makers, etc.).

API Overview

  • Endpoint: https://api.producthunt.com/v2/api/graphql
  • Method: POST
  • Auth: Authorization: Bearer {token}
  • Format: GraphQL
  • Rate Limit: ~900 requests per 15 minutes, complexity limit of 1000 per query

How to Query

Use exec with curl to make GraphQL requests:

bash
curl -s -X POST https://api.producthunt.com/v2/api/graphql \
  -H "Authorization: Bearer $PH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "YOUR_GRAPHQL_QUERY"}'

Common Queries

Today's Top Posts
graphql
query {
  posts(order: VOTES, first: 10) {
    edges {
      node {
        id
        name
        tagline
        votesCount
        commentsCount
        url
        website
        createdAt
        makers {
          name
          username
        }
        topics {
          edges {
            node {
              name
            }
          }
        }
      }
    }
  }
}
Browse Posts by Topic
graphql
query {
  posts(order: VOTES, first: 10, topic: "developer-tools") {
    edges {
      node {
        id
        name
        tagline
        votesCount
        url
        website
      }
    }
  }
}

Remember: This browses a topic — it's not a text search. To find a specific product by name, use web_search with site:producthunt.com/posts "product name", then look up the post by slug via the API.

Get a Specific Post
graphql
query {
  post(slug: "chatgpt") {
    id
    name
    tagline
    description
    votesCount
    commentsCount
    reviewsCount
    reviewsRating
    url
    website
    createdAt
    featuredAt
    makers {
      name
      username
      headline
    }
    topics {
      edges {
        node {
          name
          slug
        }
      }
    }
    comments(first: 5) {
      edges {
        node {
          body
          votesCount
          createdAt
          user {
            name
            username
          }
        }
      }
    }
  }
}
Get Posts by Topic
graphql
query {
  topic(slug: "artificial-intelligence") {
    name
    postsCount
    posts(first: 10, order: VOTES) {
      edges {
        node {
          name
          tagline
          votesCount
          url
          createdAt
        }
      }
    }
  }
}
Get Posts for a Specific Date
graphql
query {
  posts(postedAfter: "2024-01-15T00:00:00Z", postedBefore: "2024-01-16T00:00:00Z", order: VOTES, first: 10) {
    edges {
      node {
        name
        tagline
        votesCount
        url
      }
    }
  }
}
Look Up a User
graphql
query {
  user(username: "rrhoover") {
    name
    username
    headline
    followersCount
    followingCount
    madePosts(first: 5) {
      edges {
        node {
          name
          tagline
          votesCount
          url
        }
      }
    }
  }
}

Available Topics (Common Slugs)

  • artificial-intelligence, developer-tools, design-tools
  • productivity, marketing, saas, fintech
  • no-code, open-source, social-media
  • web-app, iphone, android, mac, chrome-extensions

For a full list, query:

graphql
query { topics(first: 50, order: FOLLOWERS_COUNT) { edges { node { name slug followersCount } } } }
Show full SKILL.md (221 more words)Show less
  • Product page: https://www.producthunt.com/posts/{slug}
  • User profile: https://www.producthunt.com/@{username}
  • Topic page: https://www.producthunt.com/topics/{slug}

Fallback: No API Token

If no PH_API_TOKEN is available:

  1. Use web_search with queries like:
    • site:producthunt.com/posts "product name"
    • site:producthunt.com "topic" launched
  2. Use web_fetch on specific Product Hunt URLs to get basic info
  3. Inform the user that richer data (vote counts, comments, maker info) requires an API token

Output Format

### Product Hunt Results

1. **Product Name** — Tagline
   🔼 votes · 💬 comments · ⭐ rating
   By @maker_username
   Topics: AI, Developer Tools
   🔗 product_url
   🏠 website_url
   📅 launched_date

2. ...

Error Handling

  • 401 Unauthorized: Token is invalid or expired. Check PH_API_TOKEN.
  • 429 Rate Limited: Wait 15 minutes for rate limit reset.
  • Complexity limit exceeded: Reduce the number of fields or nested queries. Remove comments, topics, or makers sub-queries.
  • Post not found: The slug may be wrong. Try searching with web_search first to confirm the exact slug.
  • No results for topic: Check the topic slug — use the topics query to find valid slugs.

Examples

Example 1: "What launched on Product Hunt today?"

Query today's posts sorted by votes, present top 10.

Example 2: "How did Linear do on Product Hunt?"
  1. Search: web_search "site:producthunt.com/posts linear"
  2. Get the slug from results
  3. Query: post(slug: "linear-5") with full details
Example 3: "Show me top AI tools on Product Hunt this month"
  1. Query posts by topic artificial-intelligence with date filters
  2. Sort by votes, present top results

Data Source

Product Hunt API V2 — GraphQL API, requires free developer token.

© dylanfeltus, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in producthunt of dylanfeltus/skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit b97a48f

Compare with similar skills

Product Hunt Search and Monitoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Product Hunt Search and Monitoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Product Hunt Search and Monitoring this skilldylanfeltus/skills179—~1.7kAutomated safety check: PassMIT
Competitor Comparison Matrixfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
Consulting Analysisbytedance/deer-flow84k4 repos~8.4kAutomated safety check: PassMIT
Startup Designferdinandobons/startup-skill1.2k—~8.1kAutomated safety check: PassMIT
Market Research ReportsK-Dense-AI/claude-scientific-writer2.4k1 repos~3.5kAutomated safety check: PassMIT
Market Research Analysismanojbajaj95/claude-gtm-plugin105—~2.6kAutomated safety check: PassMIT

Similar skills

  • Competitor Comparison Matrix

    firecrawl/web-agent

    Compares two or more products or companies on pricing, features and positioning by scraping their sites, and returns a normalized JSON matrix.

    1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    84k GitHub starsUsed in 4 repos~8.4k tokens
    Marketing & SEOAuto-check passed
  • Startup Design

    ferdinandobons/startup-skill

    Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub stars~8.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Market Research Reports

    K-Dense-AI/claude-scientific-writer

    Builds market research reports and market sizing or forecast scenarios in which every claim, source, assumption and uncertainty can be traced and audited.

    2.4k GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Market Research Analysis

    manojbajaj95/claude-gtm-plugin

    Comprehensive market research and analysis skill. An agent skill from manojbajaj95/claude-gtm-plugin.

    105 GitHub stars~2.6k tokensUpdated 21 days ago
    Marketing & SEOAuto-check passed
  • Competitive Analysis Brief

    NateBJones-Projects/OB1

    Turns a competitor set into a decision-ready brief: profiles, pricing and packaging comparisons, a positioning map, a SWOT and recommended moves for operators and founders.

    4.7k GitHub stars~1.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from dylanfeltus/skills

All 10 skills in this repo
  • App Store Intelligence

    dylanfeltus/skills

    Looks up app details, ratings and reviews and searches the iOS and Mac App Stores through Apple's free iTunes APIs, with a web-search fallback for Google Play.

    179 GitHub stars~2k tokensUpdated 22 days ago
    Auto-check passed
  • AI Image Creative Direction

    dylanfeltus/skills

    Gives prompt templates, a model-selection guide and anti-generic rules for AI-generated visuals: hero images, feature illustrations, OG cards, icons and backgrounds.

    179 GitHub stars~2.6k tokensUpdated 22 days ago
    Auto-check passed
  • Design Token Generator

    dylanfeltus/skills

    Generates type scales, color palettes, spacing systems, WCAG contrast checks and dark mode palettes from formulas, as CSS custom properties, a Tailwind config or JSON tokens.

    179 GitHub stars~2.9k tokensUpdated 22 days ago
    Auto-check passed
  • Hacker News Search

    dylanfeltus/skills

    Searches and monitors Hacker News stories, comments and users through the free Algolia HN Search API, with tag, points and date filters.

    179 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Framer Motion (Motion) patterns for React: spring presets, staggers, layout animations, micro-interactions, scroll effects and page transitions, with performance rules.

    179 GitHub stars~3k tokensUpdated 22 days ago
    Auto-check passed
  • Privacy.com Virtual Cards

    dylanfeltus/skills

    Creates, updates, and monitors Privacy.com virtual payment cards with spending limits for an agent making controlled purchases.

    179 GitHub stars~2.2k tokensUpdated 22 days ago
    Auto-check passed

Works with

Questions about Product Hunt Search and Monitoring

What does Product Hunt Search and Monitoring do?

Looks up Product Hunt launches, products and makers through its GraphQL API: daily top posts, topic browsing and per-post details, using a free developer token. The agent queries the Product Hunt GraphQL V2 API with curl, using a free developer token kept in the `PH_API_TOKEN` environment variable. Queries cover today's top posts by votes, posts browsed by topic and the full details of one post by its slug, including votes, comments and makers.

When should I use Product Hunt Search and Monitoring?

Product Hunt Search and Monitoring fits situations like: checking how a product performed when it launched on Product Hunt; finding trending products in a category such as developer tools; monitoring Product Hunt for competitors or similar products; answering what launched on Product Hunt today or this week.

How do I install Product Hunt Search and Monitoring in Claude Code?

Run `npx skills add dylanfeltus/skills --skill producthunt -a claude-code`. Or copy the skill folder (producthunt in dylanfeltus/skills) into .claude/skills/producthunt in your project. Claude Code loads it when a task matches its description.

How do I install Product Hunt Search and Monitoring in Codex?

Run `npx skills add dylanfeltus/skills --skill producthunt -a codex`. Or copy the skill folder (producthunt in dylanfeltus/skills) into .agents/skills/producthunt in your project. Codex loads it when a task matches its description.

Can I use Product Hunt Search and Monitoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dylanfeltus/skills --skill producthunt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/producthunt, .gemini/skills/producthunt, .github/skills/producthunt and .opencode/skills/producthunt in your project.

What does Product Hunt Search and Monitoring need to run?

Going by SKILL.md and its folder, Product Hunt Search and Monitoring needs the command-line tools its instructions call (curl) and credentials named PH_API_TOKEN. Our summary lists: A free Product Hunt developer token in `PH_API_TOKEN`; Network access to `api.producthunt.com`; `curl` for sending the GraphQL requests.

Does Product Hunt Search and Monitoring access the network?

SKILL.md names 2 domains. In commands or code: producthunt.com and api.producthunt.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Product Hunt Search and Monitoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Product Hunt Search and Monitoring use?

Product Hunt Search and Monitoring is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Product Hunt Search and Monitoring use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Product Hunt Search and Monitoring?

Skills that share tags, products or a category with Product Hunt Search and Monitoring: Competitor Comparison Matrix (firecrawl/web-agent, 1.2k stars), Consulting Analysis (bytedance/deer-flow, 84k stars), Startup Design (ferdinandobons/startup-skill, 1.2k stars) and Market Research Reports (K-Dense-AI/claude-scientific-writer, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Product Hunt Search and Monitoring?

dylanfeltus (a GitHub user) maintains it in dylanfeltus/skills, which has 179 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 17, 2026.

Source: dylanfeltus/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.