Skip to main content
Glama
deenesjakoruzh
phuhao00

productHuntAnalyst

by phuhao00
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Product Hunt Analyst

독립 프로젝트: Product Hunt 데이터를 가져와 최근 1 / 2 / 3 / 4주 또는 1개월의 인기 제품 트렌드를 분석하고, 시각화 Web 인터페이스를 제공합니다.

Codex, Cursor, Claude Desktop, Workbuddy 등 도구와 MCP / CLI / HTTP API로 통합할 수 있습니다.

기능

  • 시간 창별로 Product Hunt 제품 가져오기(upvotes 기준 정렬)

  • 트렌드 보고서 자동 생성: Top 제품, 카테고리 분포, 일별 게시량, 주제 키워드, 텍스트 인사이트

  • React 시각화 대시보드(꺾은선 그래프, 막대 그래프, 순위표)

  • AI Agent가 직접 호출할 수 있는 MCP Server

  • CLI 스크립트로 JSON / Markdown 출력

Related MCP server: Trends MCP

빠른 시작

1. 의존성 설치

cd product-hunt-analyst
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

pip install -r requirements.txt

2. Product Hunt Token 설정

  1. Product Hunt OAuth Apps에서 앱 생성

  2. Developer Token 복사

  3. .env.example을 .env로 복사하고 입력:

PRODUCT_HUNT_TOKEN=your_token_here

Token이 설정되지 않은 경우 Web UI가 자동으로 Demo 모드로 전환되어 예시 데이터를 표시합니다.

3. 명령줄 분석

# JSON 报告
python scripts/analyze.py --period 2w

# Markdown 报告
python scripts/analyze.py --period 1m --markdown

# 仅拉取原始数据
python scripts/fetch_posts.py --period 3w --compact

4. Web 시각화 시작

방식 A: 개발 모드(프론트엔드/백엔드 분리)

# 终端 1 - API
python -m backend.app

# 终端 2 - 前端
cd frontend
npm install
npm run dev
# 打开 http://localhost:5173

방식 B: 프로덕션 모드(단일 포트)

cd frontend && npm install && npm run build
cd ..
python -m backend.app
# 打开 http://127.0.0.1:8765

시간 범위

매개변수

의미

1w

최근 1주(7일)

2w

최근 2주(14일)

3w

최근 3주(21일)

4w

최근 4주(28일)

1m

최근 1개월(30일)

MCP 통합(Codex / Cursor / Claude)

Codex

pip install -r requirements.txt
export PRODUCT_HUNT_TOKEN=your_token
codex mcp add productHuntAnalyst --command python --arg mcp/server.py

skill/SKILL.md를 Codex skills 디렉터리에 링크하거나 복사한 후 $product-hunt-analyst로 트리거할 수 있습니다.

Cursor

프로젝트 루트 디렉터리의 .cursor/mcp.json에 추가:

{
  "mcpServers": {
    "productHuntAnalyst": {
      "command": "python",
      "args": ["mcp/server.py"],
      "cwd": "E:/codex/product-hunt-analyst",
      "env": {
        "PRODUCT_HUNT_TOKEN": "your_token"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json에 동일한 MCP server 구성을 등록합니다.

MCP 도구 목록

도구

설명

list_periods

지원되는 시간 창 나열

fetch_posts

지정된 기간의 제품 목록 가져오기

analyze_trends

전체 트렌드 분석(JSON)

analyze_market

전체 보고서(JSON 또는 Markdown)

get_top_products

Top N 제품

get_topic_trends

카테고리 트렌드

HTTP API

엔드포인트

설명

GET /api/health

상태 확인

GET /api/periods

시간 창 목록

GET /api/posts?period=2w

원본 제품 데이터

GET /api/analyze?period=2w

분석 보고서(JSON)

GET /api/analyze?period=2w&format=markdown

Markdown 보고서

GET /api/demo?period=2w

Demo 데이터(Token 불필요)

Workbuddy / 자동화

HTTP 또는 CLI로 호출하면 됩니다:

curl "http://127.0.0.1:8765/api/analyze?period=4w"
python scripts/analyze.py -p 4w --markdown > report.md

프로젝트 구조

product-hunt-analyst/
├── backend/           # FastAPI + PH API 客户端 + 分析引擎
├── frontend/          # React + Vite + Recharts 可视化
├── mcp/               # MCP Server
├── scripts/           # CLI 工具与测试
├── skill/             # Codex/Cursor Agent Skill
├── agents/            # OpenAI Agents 配置
└── requirements.txt

테스트

python scripts/test_product_hunt_analyst.py

주의사항

  • Product Hunt API에는 속도 제한이 있습니다(약 6250 complexity points / 15분)

  • 데이터는 연구 참고용으로만 제공되며 투자 또는 비즈니스 결정에 대한 조언을 구성하지 않습니다.

  • Product Hunt API Terms를 준수하세요.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Trends MCP

    trendsmcp
    A
    license
    Not graded
    quality
    C
    maintenance
    Real-time trend data from Google Trends (Search, Images, News, Shopping), YouTube, TikTok, Reddit, Amazon, Wikipedia, npm, Steam, Spotify, X (Twitter), App Store, Google Play, web traffic, and news sentiment via one MCP connection. Works with Claude, Cursor, VS Code, Windsurf, ChatGPT, and any MCP-compatible AI.
    28
    MIT