mcpField
P
producthunt

producthunt

github.com/dylanfeltusマーケティング・グロース180231 回インストール7 週間前に更新
リポジトリ

producthunt について

producthunt は、Product Hunt の製品やローンチを調べる開発者・マーケター向けのリサーチスキルです。GraphQL V2 API でトピックや日付から閲覧し、製品名の検索には Web 検索を代替手段として使います。

主な機能

  1. 01トピックや日付でローンチを閲覧
  2. 02slugから投稿の詳細を取得
  3. 03投票数、コメント、メーカーの確認
  4. 04ユーザーとトピックの検索
  5. 05製品名検索のWeb検索フォールバック

活用シーン

  1. 01今日または今週のローンチを探す
  2. 02カテゴリ内の製品を追跡
  3. 03ローンチへの反応を調査
  4. 04類似製品や競合製品をモニタリング

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dylanfeltus/skills --skill producthunt

インストール後、Claude Code で/producthuntを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

Product Hunt の検索とモニタリング

GraphQL V2 API を使用して、製品を検索し、ローンチを追跡し、Product Hunt のアクティビティをモニタリングします。

使用する場面

  • ユーザーが製品の Product Hunt でのローンチや実績について質問した場合
  • ユーザーがカテゴリ内のトレンド製品を探したい場合
  • ユーザーが競合製品や類似製品について Product Hunt をモニタリングしたい場合
  • ユーザーが「今日／今週、Product Hunt で何がローンチされましたか」と質問した場合
  • ユーザーが PH での製品の反応を調査したい場合

要件

API トークンが必要です。 Product Hunt API では認証が必要ですが、設定は無料で約 2 分で完了します。

トークンの取得方法
  1. API ダッシュボードにアクセスします
  2. アプリケーションを作成します（名前や URL は任意です）
  3. アプリのページ下部にあるDeveloper Tokenを使用します（読み取り専用アクセスでは OAuth フローは不要です）
  4. トークンを環境変数 PH_API_TOKEN に保存します

トークンを使用できない場合は、site:producthunt.com のクエリで web_search を使用します。

主な制限：テキスト検索には非対応

Product Hunt API は投稿のフリーテキスト検索に対応していません。トピックや日付から投稿を閲覧したり、スラッグを指定して特定の投稿を取得したりできますが、「AI writing tool」を検索して一致する製品を取得することはできません。

**製品名で検索するには、**まず web_search を使用します：

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

その後、検索結果のスラッグを使って API にクエリを送り、詳細（投票、コメント、メーカーなど）を取得します。

API の概要

  • エンドポイント： https://api.producthunt.com/v2/api/graphql
  • メソッド： POST
  • 認証： Authorization: Bearer {token}
  • 形式： GraphQL
  • レート制限： 15 分あたり約 900 リクエスト、クエリごとの複雑度上限は 1000

クエリの実行方法

exec と curl を使って GraphQL リクエストを送信します：

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"}'

よく使うクエリ

今日の人気投稿
query {
  posts(order: VOTES, first: 10) {
    edges {
      node {
        id
        name
        tagline
        votesCount
        commentsCount
        url
        website
        createdAt
        makers {
          name
          username
        }
        topics {
          edges {
            node {
              name
            }
          }
        }
      }
    }
  }
}
トピック別に投稿を閲覧する
query {
  posts(order: VOTES, first: 10, topic: "developer-tools") {
    edges {
      node {
        id
        name
        tagline
        votesCount
        url
        website
      }
    }
  }
}

注意： これはトピックの閲覧であり、テキスト検索ではありません。製品名で特定の製品を探すには、site:producthunt.com/posts "product name" を指定して web_search を使い、API でスラッグから投稿を検索します。

特定の投稿を取得する
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
          }
        }
      }
    }
  }
}
トピック別に投稿を取得する
query {
  topic(slug: "artificial-intelligence") {
    name
    postsCount
    posts(first: 10, order: VOTES) {
      edges {
        node {
          name
          tagline
          votesCount
          url
          createdAt
        }
      }
    }
  }
}
特定の日付の投稿を取得する
query {
  posts(postedAfter: "2024-01-15T00:00:00Z", postedBefore: "2024-01-16T00:00:00Z", order: VOTES, first: 10) {
    edges {
      node {
        name
        tagline
        votesCount
        url
      }
    }
  }
}
ユーザーを検索する
query {
  user(username: "rrhoover") {
    name
    username
    headline
    followersCount
    followingCount
    madePosts(first: 5) {
      edges {
        node {
          name
          tagline
          votesCount
          url
        }
      }
    }
  }
}

利用可能なトピック（一般的なスラッグ）

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

一覧をすべて取得するには、次のクエリを実行します：

query { topics(first: 50, order: FOLLOWERS_COUNT) { edges { node { name slug followersCount } } } }

Product Hunt のリンクの作成

  • 製品ページ： https://www.producthunt.com/posts/{slug}
  • ユーザープロフィール： https://www.producthunt.com/@{username}
  • トピックページ： https://www.producthunt.com/topics/{slug}

フォールバック：API トークンがない場合

PH_API_TOKEN を使用できない場合：

  1. 次のようなクエリで web_search を使用します：
    • site:producthunt.com/posts "product name"
    • site:producthunt.com "topic" launched
  2. 特定の Product Hunt URL に対して web_fetch を使い、基本情報を取得します
  3. より詳細なデータ（投票数、コメント、メーカー情報）の取得には API トークンが必要であることをユーザーに伝えます

出力形式

### Product Hunt Results

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

2. ...

エラー処理

  • 401 Unauthorized： トークンが無効または期限切れです。PH_API_TOKEN を確認してください。
  • 429 Rate Limited： レート制限がリセットされるまで 15 分待ちます。
  • 複雑度上限を超過： フィールド数やネストされたクエリを減らします。comments、topics、または makers のサブクエリを削除してください。
  • 投稿が見つからない： スラッグが間違っている可能性があります。まず web_search で検索して、正確なスラッグを確認してください。
  • トピックの検索結果がない： トピックのスラッグを確認してください。トピックのクエリを使って有効なスラッグを探します。

例

例 1：「今日、Product Hunt で何がローンチされましたか？」

今日の投稿を投票数順にクエリし、上位 10 件を提示します。

例 2：「Linear は Product Hunt でどのような実績でしたか？」
  1. 検索します：web_search "site:producthunt.com/posts linear"
  2. 検索結果からスラッグを取得します
  3. post(slug: "linear-5") を使って詳細をすべて取得します
例 3：「今月のProduct HuntのAIツール上位を見せて」
  1. 日付フィルターを使って、トピックartificial-intelligenceの投稿を検索します
  2. 投票数で並べ替え、上位の結果を提示します

データソース

Product Hunt API V2 — GraphQL APIです。無料の開発者トークンが必要です。

コメント

Markdown 対応