Product Hunt

Descubre y busca los últimos productos y tecnología usando la API de Product Hunt.

Documentación

🚀 Servidor MCP de Product Hunt

Un servidor MCP plug-and-play para Product Hunt

📦 Instalación rápida

pip install product-hunt-mcp

🏃‍♂️ Ejemplo de inicio rápido

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

✨ ¿Qué es esto?

El servidor MCP de Product Hunt conecta la API de Product Hunt con cualquier LLM o agente que hable el Protocolo de Contexto de Modelo (MCP). ¡Perfecto para asistentes de IA, chatbots o tus propias automatizaciones!

🔍 Obtén publicaciones, colecciones, temas y usuarios
🗳️ Obtén votos, comentarios y más
🛠️ Úsalo con Claude Desktop, Cursor o cualquier cliente MCP

🛠️ Características

Obtén información detallada sobre publicaciones, comentarios, colecciones, temas y usuarios
Busca/filtra por tema, fecha, votos, etc.
Comentarios paginados, votos positivos de usuarios y más
Construido con FastMCP para velocidad y compatibilidad

🧑‍💻 ¿Para quién es?

Usuarios de IA/LLM: Conéctalo a Claude Desktop, Cursor o tu propio agente
Desarrolladores: Crea bots, paneles o automatizaciones con datos de Product Hunt
Curiosos: Explora el ecosistema MCP y construye tus propias herramientas

🏁 Configuración

Requisitos previos

Python 3.10+
Token de API de Product Hunt (consíguelo aquí)
- Necesitarás crear una cuenta en Product Hunt
- Navega al Panel de API y crea una nueva aplicación
- Usa el Developer Token como token

Nota: Al crear una nueva aplicación en Product Hunt, se te pedirá un redirect_uri. Aunque el servidor MCP no utiliza el URI de redirección, es un campo obligatorio. Puedes ingresar cualquier URL válida, como https://localhost:8424/callback.

Instalación

Preferido: uv (instalador de Python rápido y moderno)

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

Instalar desde PyPI (recomendado)

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

Instalar desde GitHub (rama main más reciente)

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 desde el código fuente

uv pip install .
# or
pip install .

🚀 Uso con Claude Desktop y Cursor

Una vez instalado, el comando product-hunt-mcp estará disponible. Añádelo a tu configuración de Claude Desktop o Cursor:

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

Reemplaza your_token_here con tu token real de la API de Product Hunt.
El token debe configurarse como variable de entorno en tu configuración de Claude Desktop o Cursor para que el servidor se autentique.
Reinicia siempre tu cliente (Claude Desktop/Cursor) después de editar el archivo de configuración.

Consejo: En macOS, es posible que Claude Desktop no encuentre el comando product-hunt-mcp si no está en el PATH predeterminado. Si encuentras problemas, puedes proporcionar la ruta completa al ejecutable. Después de instalar, ejecuta:
which product-hunt-mcp
Usa la ruta de salida en tu configuración de Claude Desktop, reemplazando "command": "product-hunt-mcp" con la ruta completa (p. ej., "command": "/Users/youruser/.local/bin/product-hunt-mcp").

Cómo encontrar tu archivo de configuración

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

También puedes ejecutar el 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 la integración con Claude Desktop/Cursor mediante Docker, usa esta configuración:

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

Nota de seguridad: Tu PRODUCT_HUNT_TOKEN es sensible. No lo compartas ni lo subas a control de versiones.

🛠️ Herramientas MCP

Herramienta	Descripción	Parámetros clave
get_post_details	Obtén información sobre una publicación específica	`id` o `slug`, `comments_count`, `comments_after`
get_posts	Obtén publicaciones con filtros	`topic`, `order`, `count`, `featured`, `posted_before`, `posted_after`
get_comment	Obtén información sobre un comentario específico	`id` (obligatorio)
get_post_comments	Obtén comentarios de una publicación	`post_id` o `slug`, `order`, `count`, `after`
get_collection	Obtén información sobre una colección	`id` o `slug`
get_collections	Obtén colecciones con filtros	`featured`, `user_id`, `post_id`, `order`, `count`
get_topic	Obtén información sobre un tema	`id` o `slug`
search_topics	Busca temas	`query`, `followed_by_user_id`, `order`, `count`
get_user	Obtén información sobre un usuario	`id` o `username`, `posts_type`, `posts_count`
get_viewer	Obtén información sobre el usuario autenticado	Ninguno
check_server_status	Comprueba el estado del servidor/API y la autenticación	Ninguno

🏗️ Estructura del proyecto

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.)

🔄 Límites de velocidad

La API de Product Hunt tiene límites de velocidad que este cliente respeta. Si encuentras errores de límite de velocidad, el cliente te informará cuándo se restablece el límite. Puedes comprobar tu estado actual de límite de velocidad usando las herramientas get_api_rate_limits o check_server_status.

🐛 Solución de problemas

Token faltante: Asegúrate de que tu PRODUCT_HUNT_TOKEN esté configurado correctamente como variable de entorno.
Problemas de conexión: Verifica tu conexión a internet y que la API de Product Hunt sea accesible.
Límite de velocidad: Si alcanzas los límites, espera hasta el momento de restablecimiento o reduce la frecuencia de tus consultas.
Claude Desktop/Cursor no encuentra el servidor: Verifica la ruta a tu ejecutable de Python y reinicia el cliente.

🤝 Contribuciones

¡Se aceptan PRs e issues!
Sigue PEP8 y usa ruff para el linting.
Consulta pyproject.toml para las dependencias de desarrollo.

🌐 Enlaces

📝 Notas

Este proyecto no está afiliado con Product Hunt.
La API de Product Hunt está sujeta a cambios.

📜 Licencia

MIT