ProductHunt 技能 - 通过官方 API 查询 Product Hunt 产品发布数据

技能概述

ProductHunt 是一个面向 AI 智能体的技能，通过 Product Hunt 官方 GraphQL API 查询帖子（Posts）、话题（Topics）、用户（Users）和合集（Collections）数据，让智能体能够自动获取产品发布信息和社区讨论内容。

适用场景

1. 竞品监控与新品追踪：按日期获取每日精选帖子，或按话题筛选特定领域的新产品发布，及时发现竞品动态和潜在威胁。
2. 出海市场调研：在产品上线前查询同品类产品在 Product Hunt 上的表现、评分与用户评论，验证市场需求并挖掘差异化机会。
3. 用户与项目深度分析：查询特定用户发布的历史产品，或获取帖子下的评论列表，帮助投资人、市场分析师挖掘早期项目与真实用户反馈。

核心功能

1. 帖子查询（Posts）：支持按 slug 或 ID 获取单个帖子详情、拉取今日精选帖子列表、按话题（如 AI）或日期（--after）筛选帖子，并可获取指定帖子下的用户评论。
2. 话题查询（Topics）：按 slug 获取话题详情，或按关键词搜索话题、拉取热门话题列表，帮助智能体理解产品所属的品类结构。
3. 用户与合集查询（Users & Collections）：通过用户名查询用户资料及其发布的产品列表；获取官方合集详情与精选合集列表，快速浏览编辑推荐的产品组合。

常见问题

如何获取 Product Hunt 的访问令牌（Access Token）？

访问 https://www.producthunt.com/v2/oauth/applications 创建应用即可获得开发者令牌，然后将 export PRODUCTHUNT_ACCESS_TOKEN="your_developer_token" 添加到 ~/.zshrc 中。技能依赖此令牌调用 API，未配置时无法使用。

使用 Product Hunt API 有速率限制吗？

有。Product Hunt 官方 API 采用复杂度配额机制，每 15 分钟 6250 个复杂度点。普通查询场景足够使用，但若批量拉取大量帖子或评论，需注意配额消耗，避免短时间内密集调用。

这项技能和直接浏览 Product Hunt 网站有什么区别？

这项技能面向智能体自动化场景：无需人工浏览网页，智能体即可通过命令行脚本（python3 scripts/...）批量、结构化地获取帖子、话题、用户和合集数据，并支持按日期、话题等条件筛选，适合监控、调研等需要重复执行的任务。它只读取数据，不提供发布产品或互动等写操作。