API de contenido de Reddit

API de contenido de Reddit: Guía de configuración y uso

Este proyecto proporciona herramientas MCP (Protocolo de contexto de modelo) para interactuar con Reddit a través de Claude y Cursor.

Características

Leyendo publicaciones de tendencia de subreddits
Análisis de las discusiones de Reddit con comentarios
Creando publicaciones en Reddit
Agregar comentarios a publicaciones o respuestas a comentarios existentes
Votación de publicaciones y comentarios

Requisitos

Python 3.10+
Una cuenta de Reddit
Una aplicación Reddit registrada (para obtener client_id y client_secret)
Entorno virtual (venv o similar)
Escritorio y/o cursor de Claude (opcional pero recomendado)

Instalación desde cero

Siga estos pasos cuidadosamente para evitar problemas de importación y configuración:

# 1. Clone the repository
git clone https://github.com/your-username/mcp-reddit.git
cd mcp-reddit

# 2. Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 3. Install dependencies (WITHOUT installing the package in editable mode)
pip install -r requirements.txt

# 4. Configure environment variables (see below)
# Create and edit the .env file

⚠️ IMPORTANTE : NO instale el paquete en modo editable ( pip install -e . ) ya que puede causar problemas de importación del módulo.

Configuración del entorno

Cree un archivo .env en la raíz del proyecto con las siguientes variables:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_REFRESH_TOKEN=your_refresh_token

Para obtener un token de actualización, ejecute:

python -m mcp_reddit.auth_helper

Siga las instrucciones para autorizar la aplicación. El token se guardará automáticamente en el archivo .env .

Estructura del proyecto

mcp-reddit/
│
├── src/
│   └── mcp_reddit/
│       ├── __init__.py
│       ├── main.py           # Entry point for the MCP server
│       ├── reddit_fetcher.py # Implementation of Reddit tools
│       └── auth_helper.py    # Helper for generating authentication tokens
│
├── .env                      # Environment variables (create manually)
├── requirements.txt
├── setup.py
└── README.md

Ejecutar el servidor directamente

Para ejecutar manualmente (útil para desarrollo y pruebas):

cd /path/to/mcp-reddit
.venv/bin/python src/mcp_reddit/main.py

Debería ver registros que indiquen:

Inicialización del servidor
Verificación de autenticación de Reddit
Registro de 10 herramientas (5 originales + 5 con prefijo)
"Ejecutando servidor MCP..."

Configuración del escritorio de Claude

Localice el archivo de configuración:
- En macOS: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
- En Windows: %APPDATA%\Claude\claude_desktop_config.json
Agregue la configuración para reddit-content-api:

"reddit-content-api": {
  "command": "/full/path/to/mcp-reddit/.venv/bin/python",
  "args": [
    "-m",
    "mcp_reddit.main",
    "--stdio"
  ],
  "cwd": "/full/path/to/mcp-reddit",
  "env": {
    "PYTHONPATH": "/full/path/to/mcp-reddit/src:/full/path/to/mcp-reddit",
    "DEBUG": "true"
  }
}

⚠️ EXTREMADAMENTE IMPORTANTE : PYTHONPATH debe incluir tanto el directorio src como la raíz del proyecto, en ese orden, separados por : (en Unix/macOS) o ; (en Windows)

Configuración del cursor

Localice el archivo de configuración:
- En macOS: /Users/your-username/.cursor/mcp.json
- En Windows: %USERPROFILE%\.cursor\mcp.json
Agregue la misma configuración que en Claude, ajustando las rutas según sea necesario.

Solución de problemas comunes

Problema: solo aparecen 2 herramientas en lugar de las 10 esperadas

Síntomas : al ejecutar el servidor, solo aparecen 2 herramientas en lugar de las 10 esperadas.

Posibles causas y soluciones :

Problema de importación : Python está importando una versión instalada desde site-packages en lugar del código local en src/ .Solución :
- Asegúrese de NO instalar el paquete en modo editable ( pip install -e .
- Agregue explícitamente src al comienzo de PYTHONPATH en las configuraciones
- Si ya lo has instalado, usa pip uninstall reddit-content-api para eliminarlo
Caché de Python : los archivos .pyc antiguos pueden causar problemas.Solución :
- Eliminar todos los directorios __pycache__ del proyecto
Conflictos de versiones : diferentes versiones de la misma biblioteca.Solución :
- Reinstale las dependencias con pip install -r requirements.txt

Problema: "No se puede crear una publicación: la autenticación de Reddit no está configurada correctamente"

Causa : El token de actualización no es válido o ha expirado.

Solución : regenere el token ejecutando python -m mcp_reddit.auth_helper y asegúrese de que esté guardado en .env .

Problema: Las herramientas no aparecen en Claude/Cursor

Causa : Configuración incorrecta en los archivos de configuración.

Solución :

Verifique las rutas y especialmente PYTHONPATH en los archivos de configuración
Reiniciar completamente Claude/Cursor después de modificar la configuración

Uso de las herramientas en Claude/Cursor

Una vez configurado, podrá utilizar las siguientes herramientas:

mcp_reddit_content_api_fetch_reddit_hot_threads - Obtén publicaciones populares
mcp_reddit_content_api_fetch_reddit_post_content - Analizar una publicación y sus comentarios
mcp_reddit_content_api_create_reddit_post - Crear una nueva publicación
mcp_reddit_content_api_add_reddit_comment - Agregar un comentario
mcp_reddit_content_api_vote_on_reddit_content - Votar sobre el contenido

Ejemplos

Conseguir publicaciones de tendencia :

Subreddit: python
Number of posts: 5

Creando una publicación :

Subreddit: test
Title: Test from MCP
Content type: text
Content: This is a test from the Reddit Content API using MCP.

Contribuciones

Si encuentra problemas o desea realizar mejoras, cree un problema o envíe una solicitud de extracción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Apoya este proyecto

Si encuentra este proyecto útil en su trabajo o investigación, considere:

⭐ Destaca el repositorio para mostrar tu apoyo
🔄Seguir el repositorio para obtener actualizaciones sobre nuevas funciones y mejoras
🐛 Apertura de problemas por errores o solicitudes de funciones
🛠️ Contribuir con solicitudes de extracción si tienes mejoras para compartir

¡Tu apoyo ayuda a hacer este proyecto mejor para todos!

Reddit Content API

Integrations