Product Hunt

Descubra e pesquise os produtos e tecnologias mais recentes usando a API do Product Hunt.

Documentação

🚀 Servidor MCP do Product Hunt

Um servidor MCP plug-and-play para o Product Hunt

📦 Instalação Rápida

pip install product-hunt-mcp

🏃‍♂️ Exemplo de Início Rápido

# Run the MCP server (requires PRODUCT_HUNT_TOKEN environment variable)
export PRODUCT_HUNT_TOKEN=your_token_here
product-hunt-mcp

✨ O que é isso?

Servidor MCP do Product Hunt conecta a API do Product Hunt a qualquer LLM ou agente que fale o Model Context Protocol (MCP). Perfeito para assistentes de IA, chatbots ou suas próprias automações!

🔍 Obtenha posts, coleções, tópicos, usuários
🗳️ Obtenha votos, comentários e mais
🛠️ Use com Claude Desktop, Cursor ou qualquer cliente MCP

🛠️ Recursos

Obtenha informações detalhadas sobre posts, comentários, coleções, tópicos, usuários
Pesquise/filtre por tópico, data, votos, etc.
Comentários paginados, upvotes de usuários e mais
Construído com FastMCP para velocidade e compatibilidade

🧑‍💻 Para quem é isso?

Usuários de IA/LLM: Conecte-se ao Claude Desktop, Cursor ou seu próprio agente
Desenvolvedores: Crie bots, painéis ou automações com dados do Product Hunt
Curiosos: Explore o ecossistema MCP e crie suas próprias ferramentas

🏁 Configuração

Pré-requisitos

Python 3.10+
Token da API do Product Hunt (obtenha um aqui)
- Você precisará criar uma conta no Product Hunt
- Navegue até o Painel da API e crie um novo aplicativo
- Use o Developer Token para o token

Nota: Ao criar um novo aplicativo no Product Hunt, será solicitado um redirect_uri. Embora o servidor MCP não use o URI de redirecionamento, ele é um campo obrigatório. Você pode inserir qualquer URL válida, como https://localhost:8424/callback.

Instalação

Preferido: uv (instalador Python rápido e moderno)

# Install uv if you don't have it
pip install uv

Instalar a partir do PyPI (recomendado)

uv pip install product-hunt-mcp
# or
pip install product-hunt-mcp

Instalar a partir do GitHub (branch main mais recente)

uv pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'
# or
pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'

Instalar localmente a partir do código-fonte

uv pip install .
# or
pip install .

🚀 Uso com Claude Desktop e Cursor

Após a instalação, o comando product-hunt-mcp estará disponível. Adicione-o à sua configuração do Claude Desktop ou Cursor:

{
  "mcpServers": {
    "product-hunt": {
      "command": "product-hunt-mcp",
      "env": {
        "PRODUCT_HUNT_TOKEN": "your_token_here"
      }
    }
  }
}

Substitua your_token_here pelo seu token real da API do Product Hunt.
O token deve ser definido como uma variável de ambiente na configuração do Claude Desktop ou Cursor para que o servidor autentique.
Sempre reinicie seu cliente (Claude Desktop/Cursor) após editar o arquivo de configuração.

Dica: No macOS, o Claude Desktop pode nem sempre encontrar o comando product-hunt-mcp se ele não estiver no PATH padrão. Se você encontrar problemas, pode fornecer o caminho completo para o executável. Após a instalação, execute:
which product-hunt-mcp
Use o caminho de saída na sua configuração do Claude Desktop, substituindo "command": "product-hunt-mcp" pelo caminho completo (por exemplo, "command": "/Users/youruser/.local/bin/product-hunt-mcp").

Encontrando seu arquivo de configuração

Claude Desktop:
- Windows: %APPDATA%\claude-desktop\config.json
- macOS: ~/Library/Application Support/claude-desktop/config.json
- Linux: ~/.config/claude-desktop/config.json
Cursor:
- Windows: %APPDATA%\Cursor\User\settings.json
- macOS: ~/Library/Application Support/Cursor/User/settings.json
- Linux: ~/.config/Cursor/User/settings.json

Docker

Você também pode executar o servidor usando Docker:

# Build the Docker image
docker build -t product-hunt-mcp .

# Run the Docker container (interactive for MCP)
docker run -i --rm -e PRODUCT_HUNT_TOKEN=your_token_here product-hunt-mcp

Para integração com Claude Desktop/Cursor usando Docker, use esta configuração:

{
  "mcpServers": {
    "product-hunt": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PRODUCT_HUNT_TOKEN=your_token_here", "product-hunt-mcp"],
      "env": {}
    }
  }
}

Nota de Segurança: Seu PRODUCT_HUNT_TOKEN é sensível. Não o compartilhe nem o envie para o controle de versão.

🛠️ Ferramentas MCP

Ferramenta	Descrição	Parâmetros-chave
get_post_details	Obtenha informações sobre um post específico	`id` ou `slug`, `comments_count`, `comments_after`
get_posts	Obtenha posts com filtros	`topic`, `order`, `count`, `featured`, `posted_before`, `posted_after`
get_comment	Obtenha informações sobre um comentário específico	`id` (obrigatório)
get_post_comments	Obtenha comentários de um post	`post_id` ou `slug`, `order`, `count`, `after`
get_collection	Obtenha informações sobre uma coleção	`id` ou `slug`
get_collections	Obtenha coleções com filtros	`featured`, `user_id`, `post_id`, `order`, `count`
get_topic	Obtenha informações sobre um tópico	`id` ou `slug`
search_topics	Pesquise tópicos	`query`, `followed_by_user_id`, `order`, `count`
get_user	Obtenha informações sobre um usuário	`id` ou `username`, `posts_type`, `posts_count`
get_viewer	Obtenha informações sobre o usuário autenticado	Nenhum
check_server_status	Verifique o status do servidor/API e autenticação	Nenhum

🏗️ Estrutura do Projeto

product-hunt-mcp/
├── src/
│   └── product_hunt_mcp/ # Main package directory
│       ├── __init__.py
│       ├── cli.py        # Command-line entry point
│       ├── api/          # API clients & queries
│       ├── schemas/      # Data validation schemas
│       ├── tools/        # MCP tool definitions
│       └── utils/        # Utility functions
├── pyproject.toml      # Project metadata, dependencies, build config
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
├── Dockerfile
└── ... (config files, etc.)

🔄 Limite de Taxa

A API do Product Hunt tem limites de taxa que este cliente respeita. Se você encontrar erros de limite de taxa, o cliente informará quando o limite for redefinido. Você pode verificar o status atual do seu limite de taxa usando as ferramentas get_api_rate_limits ou check_server_status.

🐛 Solução de Problemas

Token ausente: Certifique-se de que seu PRODUCT_HUNT_TOKEN esteja definido corretamente como uma variável de ambiente.
Problemas de conexão: Verifique sua conexão com a internet e se a API do Product Hunt está acessível.
Limite de taxa: Se você atingir os limites de taxa, aguarde até o horário de redefinição ou reduza a frequência das suas consultas.
Claude Desktop/Cursor não encontrando o servidor: Verifique o caminho para o seu executável Python e reinicie o cliente.

🤝 Contribuindo

PRs e issues são bem-vindos!
Por favor, siga o PEP8 e use o ruff para linting.
Veja pyproject.toml para dependências de desenvolvimento.

🌐 Links

📝 Notas

Este projeto não é afiliado ao Product Hunt.
A API do Product Hunt está sujeita a alterações.

📜 Licença

MIT