API контента Reddit

API контента Reddit — руководство по настройке и использованию

Этот проект предоставляет инструменты MCP (Model Context Protocol) для взаимодействия с Reddit через Claude и Cursor.

Функции

Чтение популярных сообщений из subreddit
Анализ обсуждений Reddit с комментариями
Создание постов на Reddit
Добавление комментариев к сообщениям или ответы на существующие комментарии
Голосование за посты и комментарии

Требования

Питон 3.10+
Аккаунт Reddit
Зарегистрированное приложение Reddit (для получения client_id и client_secret)
Виртуальная среда (venv или подобная)
Рабочий стол Клода и/или курсор (необязательно, но рекомендуется)

Установка с нуля

Чтобы избежать проблем с импортом и настройкой, внимательно следуйте этим шагам:

# 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

⚠️ ВАЖНО : НЕ устанавливайте пакет в режиме редактирования ( pip install -e . ), так как это может вызвать проблемы с импортом модулей.

Конфигурация среды

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

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_REFRESH_TOKEN=your_refresh_token

Чтобы получить токен обновления, выполните:

python -m mcp_reddit.auth_helper

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

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

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

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

Для запуска вручную (полезно для разработки и тестирования):

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

Вы должны увидеть журналы, в которых указано:

Инициализация сервера
Проверка подлинности Reddit
Регистрация 10 инструментов (5 оригинальных + 5 с префиксом)
«Запуск сервера MCP...»

Конфигурация рабочего стола Клода

Найдите файл конфигурации:
- В macOS: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
- В Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте конфигурацию для 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"
  }
}

⚠️ КРАЙНЕ ВАЖНО : PYTHONPATH должен включать как каталог src , так и корень проекта, именно в таком порядке, разделенные : (в Unix/macOS) или ; (в Windows)

Конфигурация курсора

Найдите файл конфигурации:
- В macOS: /Users/your-username/.cursor/mcp.json
- В Windows: %USERPROFILE%\.cursor\mcp.json
Добавьте ту же конфигурацию, что и в Клоде, при необходимости скорректировав пути.

Устранение распространенных проблем

Проблема: вместо ожидаемых 10 инструментов отображается только 2.

Симптомы : при запуске сервера появляются только 2 инструмента вместо ожидаемых 10.

Возможные причины и решения :

Проблема импорта : Python импортирует установленную версию из site-packages вместо локального кода в src/ .Решение :
- Убедитесь, что пакет НЕ установлен в режиме редактирования ( pip install -e . )
- Явно добавьте src в начало PYTHONPATH в конфигурациях
- Если вы уже установили его, используйте pip uninstall reddit-content-api чтобы удалить его.
Кэш Python : старые файлы .pyc могут вызывать проблемы.Решение :
- Удалить все каталоги __pycache__ из проекта
Конфликты версий : разные версии одной и той же библиотеки.Решение :
- Переустановите зависимости с помощью pip install -r requirements.txt

Проблема: «Невозможно создать публикацию: аутентификация Reddit настроена неправильно»

Причина : токен обновления недействителен или срок его действия истек.

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

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

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

Решение :

Проверьте пути и особенно PYTHONPATH в файлах конфигурации.
Полностью перезапустите Claude/Cursor после изменения конфигурации.

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

После настройки вы сможете использовать следующие инструменты:

mcp_reddit_content_api_fetch_reddit_hot_threads — Получайте популярные сообщения
mcp_reddit_content_api_fetch_reddit_post_content — Анализ поста и его комментариев
mcp_reddit_content_api_create_reddit_post — Создать новый пост
mcp_reddit_content_api_add_reddit_comment - Добавить комментарий
mcp_reddit_content_api_vote_on_reddit_content — Голосование за контент

Примеры

Получение популярных сообщений :

Subreddit: python
Number of posts: 5

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

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

Вклады

Если вы обнаружили проблемы или хотите что-то улучшить, пожалуйста, создайте проблему или отправьте запрос на внесение изменений.

Лицензия

Массачусетский технологический институт

Поддержать этот проект

Если вы считаете этот проект полезным для своей работы или исследования, пожалуйста, рассмотрите:

⭐ Отметьте репозиторий звездочкой, чтобы продемонстрировать свою поддержку
🔄 Следите за обновлениями репозитория о новых функциях и улучшениях
🐛 Открытие вопросов об ошибках или запросах на новые функции
🛠️ Вносите свой вклад с помощью запросов на включение внесенных изменений, если у вас есть улучшения, которыми вы хотите поделиться

Ваша поддержка поможет сделать этот проект лучше для всех!

Reddit Content API

Integrations