Reddit Content API

Автоматизируйте задачи Reddit с помощью Reddit Content API. Читайте популярные посты, анализируйте обсуждения, создавайте контент, голосуйте и многое другое прямо в Claude и Cursor! Бесшовная интеграция с MCP.

Социальные сети Разработка API Прочее ★ 16 GitHub (16 ★)

Этот инструмент предоставляет возможности Model Context Protocol (MCP) для взаимодействия с Reddit. Он позволяет пользователям получать популярные посты из сабреддитов, анализировать обсуждения на Reddit с комментариями, создавать новые посты, добавлять комментарии или ответы, а также голосовать за существующий контент, бесшовно интегрируясь с Claude и Cursor для расширенного управления Reddit и взаимодействия.

Ключевые возможности

01Чтение популярных постов из сабреддитов

02Анализ обсуждений на Reddit с комментариями

Reddit Content API - Setup and Usage Guide

This project provides MCP (Model Context Protocol) tools for interacting with Reddit through Claude and Cursor.

Features

Reading trending posts from subreddits
Analyzing Reddit discussions with comments
Creating posts on Reddit
Adding comments to posts or replies to existing comments
Voting on posts and comments

Requirements

Python 3.10+
A Reddit account
A registered Reddit application (to obtain client_id and client_secret)
Virtual environment (venv or similar)
Claude Desktop and/or Cursor (optional but recommended)

Installation from Scratch

Follow these steps carefully to avoid import and configuration issues:

# 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

⚠️ IMPORTANT: DO NOT install the package in editable mode (pip install -e .) as it can cause module import problems.

Environment Configuration

Create a .env file in the project root with the following variables:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_REFRESH_TOKEN=your_refresh_token

To obtain a refresh token, run:

python -m mcp_reddit.auth_helper

Follow the instructions to authorize the application. The token will be automatically saved to the .env file.

Project Structure

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

Running the Server Directly

To run manually (useful for development and testing):

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

You should see logs indicating:

Server initialization
Reddit authentication verification
Registration of 10 tools (5 original + 5 with prefix)
"Running MCP server..."

Claude Desktop Configuration

Locate the configuration file:
- On macOS: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the configuration for 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"
  }
}

⚠️ EXTREMELY IMPORTANT: PYTHONPATH must include both the src directory and the project root, in that order, separated by : (on Unix/macOS) or ; (on Windows)

Cursor Configuration

Locate the configuration file:
- On macOS: /Users/your-username/.cursor/mcp.json
- On Windows: %USERPROFILE%\.cursor\mcp.json
Add the same configuration as in Claude, adjusting paths as necessary.

Troubleshooting Common Issues

Issue: Only 2 tools appear instead of the expected 10

Symptoms: When running the server, only 2 tools appear instead of the expected 10.

Possible causes and solutions:

Import problem: Python is importing an installed version from site-packages instead of the local code in src/.

Solution:
- Make sure NOT to install the package in editable mode (pip install -e .)
- Explicitly add src to the beginning of PYTHONPATH in the configurations
- If you've already installed it, use pip uninstall reddit-content-api to remove it
Python cache: Old .pyc files can cause problems.

Solution:
- Remove all __pycache__ directories from the project
Version conflicts: Different versions of the same library.

Solution:
- Reinstall dependencies with pip install -r requirements.txt

Issue: "Cannot create post: Reddit authentication is not configured properly"

Cause: The refresh token is invalid or has expired.

Solution: Regenerate the token by running python -m mcp_reddit.auth_helper and make sure it's saved in .env.

Issue: Tools don't appear in Claude/Cursor

Cause: Incorrect configuration in the configuration files.

Solution:

Check paths and especially PYTHONPATH in the configuration files
Completely restart Claude/Cursor after modifying the configuration

Using the Tools in Claude/Cursor

Once configured, you can use the following tools:

mcp_reddit_content_api_fetch_reddit_hot_threads - Get trending posts
mcp_reddit_content_api_fetch_reddit_post_content - Analyze a post and its comments
mcp_reddit_content_api_create_reddit_post - Create a new post
mcp_reddit_content_api_add_reddit_comment - Add a comment
mcp_reddit_content_api_vote_on_reddit_content - Vote on content

Examples

Getting trending posts:

Subreddit: python
Number of posts: 5

Creating a post:

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

Contributions

If you find issues or have improvements, please create an issue or submit a pull request.

License

MIT

Support This Project

If you find this project useful in your work or research, please consider:

⭐ Starring the repository to show your support
🔄 Following the repository for updates on new features and improvements
🐛 Opening issues for bugs or feature requests
🛠️ Contributing with pull requests if you have improvements to share

Your support helps make this project better for everyone!

Reddit Content API — MCP-сервер для работы с Reddit

Этот проект предоставляет набор инструментов MCP (Model Context Protocol) для взаимодействия с Reddit через Claude Desktop и Cursor. Сервер позволяет читать посты, анализировать обсуждения, создавать публикации, оставлять комментарии и голосовать.

Возможности

Чтение горячих постов из любого сабреддита
Получение содержимого поста вместе с комментариями
Создание новых постов (текстовых или ссылочных)
Добавление комментариев к постам или ответов на комментарии
Голосование за посты и комментарии (лайк/дизлайк)

Требования

Python 3.10 или новее
Аккаунт на Reddit
Зарегистрированное приложение Reddit (для получения client_id и client_secret)
Виртуальное окружение (venv или аналогичное)
Claude Desktop и/или Cursor (опционально, но рекомендуется)

Установка

Клонируйте репозиторий:

git clone https://github.com/jlcases/mcp-reddit.git
cd mcp-reddit

Создайте и активируйте виртуальное окружение:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

Установите зависимости (без установки пакета в режиме редактирования):

pip install -r requirements.txt

Важно: Не выполняйте pip install -e . — это может вызвать проблемы с импортом модулей.

Настройка окружения

Создайте файл .env в корне проекта со следующими переменными:

REDDIT_CLIENT_ID=ваш_client_id
REDDIT_CLIENT_SECRET=ваш_client_secret
REDDIT_REFRESH_TOKEN=ваш_refresh_token

Для получения refresh_token запустите:

python -m mcp_reddit.auth_helper

Следуйте инструкциям для авторизации приложения. Токен автоматически сохранится в .env.

Структура проекта

mcp-reddit/
├── src/
│   └── mcp_reddit/
│       ├── __init__.py
│       ├── main.py          # Точка входа MCP-сервера
│       ├── reddit_fetcher.py # Реализация инструментов Reddit
│       └── auth_helper.py   # Помощник для генерации токенов
├── .env                     # Переменные окружения (создаётся вручную)
├── requirements.txt
├── setup.py
└── README.md

Запуск сервера напрямую

Для разработки и тестирования можно запустить сервер вручную:

cd /путь/к/mcp-reddit
.venv/bin/python src/mcp_reddit/main.py

В логах должно появиться:

Инициализация сервера
Проверка аутентификации Reddit
Регистрация 10 инструментов (5 оригинальных + 5 с префиксом)
Сообщение "Running MCP server..."

Конфигурация для Claude Desktop

Найдите файл конфигурации:

macOS: /Users/ваше_имя/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте конфигурацию для reddit-content-api:

{
  "reddit-content-api": {
    "command": "/полный/путь/к/mcp-reddit/.venv/bin/python",
    "args": ["-m", "mcp_reddit.main", "--stdio"],
    "cwd": "/полный/путь/к/mcp-reddit",
    "env": {
      "PYTHONPATH": "/полный/путь/к/mcp-reddit/src:/полный/путь/к/mcp-reddit",
      "DEBUG": "true"
    }
  }
}

Важно: PYTHONPATH должен включать обе директории (src и корень проекта) в указанном порядке, разделённые : (Unix/macOS) или ; (Windows).

Конфигурация для Cursor

Найдите файл конфигурации:

macOS: /Users/ваше_имя/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json

Добавьте ту же конфигурацию, что и для Claude, скорректировав пути.

Использование инструментов

После настройки в Claude/Cursor станут доступны следующие инструменты (с префиксом mcp_reddit_content_api_):

fetch_reddit_hot_threads — получить горячие посты из сабреддита
fetch_reddit_post_content — проанализировать пост и его комментарии
create_reddit_post — создать новый пост
add_reddit_comment — добавить комментарий
vote_on_reddit_content — проголосовать за контент

Примеры

Получение горячих постов:

Сабреддит: python
Количество постов: 5

Создание поста:

Сабреддит: test
Заголовок: "Test from MCP"
Тип контента: text
Содержимое: "This is a test from the Reddit Content API using MCP."

Устранение неполадок

Отображается только 2 инструмента вместо 10

Причина: Python импортирует установленную версию пакета из site-packages, а не локальный код из src/.

Решение:

Убедитесь, что не устанавливали пакет в режиме редактирования (pip install -e .)
Явно добавьте src в начало PYTHONPATH в конфигурации
Если уже установили — удалите: pip uninstall reddit-content-api
Очистите кэш Python: удалите все директории __pycache__
Переустановите зависимости: pip install -r requirements.txt

Ошибка "Cannot create post: Reddit authentication is not configured properly"

Причина: Refresh token недействителен или истёк.

Решение: Запустите python -m mcp_reddit.auth_helper заново и убедитесь, что токен сохранён в .env.

Инструменты не отображаются в Claude/Cursor

Причина: Неправильная конфигурация в файлах настроек.