reddit-skills
reddit-skills
Habilidades de automatización para Reddit: utiliza directamente tu navegador con sesión iniciada y tu cuenta real, operando Reddit como un usuario normal.
Compatible con OpenClaw y todas las plataformas de agentes de IA compatibles con el formato SKILL.md (por ejemplo, Claude Code).
⚠️ Consejo de uso: Aunque este proyecto utiliza tu navegador y cuenta reales, debes controlar la frecuencia de operación y evitar acciones masivas en poco tiempo. La automatización agresiva puede activar los límites de tasa de Reddit o restricciones de cuenta.
Características
Habilidad | Descripción | Capacidades principales |
reddit-auth | Autenticación | Verificación de inicio de sesión, gestión de sesiones |
reddit-publish | Publicación de contenido | Envío de publicaciones de texto / enlaces / imágenes |
reddit-explore | Descubrimiento | Búsqueda, navegación por subreddits, detalles de publicaciones, perfiles de usuario |
reddit-interact | Interacción social | Comentar, responder, votar a favor, votar en contra, guardar |
reddit-content-ops | Operaciones compuestas | Análisis de subreddits, seguimiento de tendencias, campañas de interacción |
Admite operaciones encadenadas: puedes dar instrucciones compuestas en lenguaje natural y el Agente encadenará automáticamente múltiples habilidades. Por ejemplo:
"Busca en r/Python las publicaciones más votadas sobre FastAPI esta semana, guarda la mejor y dime de qué trata"
El Agente ejecutará: buscar → filtrar por mejor/semana → guardar → obtener detalle → resumir.
Related MCP server: Reddit MCP Server
Instalación
Requisitos previos
Python >= 3.11
Gestor de paquetes uv
Navegador Google Chrome
Paso 1: Instalar el proyecto
Opción A: Descargar ZIP (recomendado)
Descárgalo desde GitHub y extráelo en el directorio de habilidades de tu Agente:
# OpenClaw
<openclaw-project>/skills/reddit-skills/
# Claude Code
<your-project>/.claude/skills/reddit-skills/Opción B: Clonar con Git
cd <your-agent-project>/skills/
git clone https://github.com/1146345502/reddit-skills.gitLuego instala las dependencias de Python:
cd reddit-skills
uv syncPaso 2: Instalar la extensión del navegador
La extensión permite que la IA opere Reddit en tu navegador usando tu sesión de inicio de sesión real.
Abre Chrome, navega a
chrome://extensions/Habilita el Modo de desarrollador (arriba a la derecha)
Haz clic en Cargar descomprimida, selecciona el directorio
extension/de este proyectoConfirma que la extensión Reddit Bridge esté habilitada
Una vez instalada, estarás listo para empezar: todas las acciones ocurren en tu propio navegador, usando tu cuenta real.
Uso
Como habilidad de Agente de IA (recomendado)
Después de instalarlo en un directorio de habilidades, simplemente habla con el Agente en lenguaje natural. Enrutará tu intención a la habilidad correcta automáticamente.
Autenticación:
"Comprueba si he iniciado sesión en Reddit" / "Cerrar sesión en Reddit"
Buscar y navegar:
"Busca en Reddit publicaciones sobre aprendizaje automático" / "Muéstrame las publicaciones principales en r/Python"
Enviar contenido:
"Envía una publicación de texto a r/learnpython con este título y cuerpo..."
Interactuar:
"Vota a favor de esta publicación" / "Comenta en esta publicación: ¡Gran artículo!" / "Guardar esta publicación"
Operaciones compuestas:
"Analiza las publicaciones principales en r/startups este mes y resume los temas comunes"
Como servidor MCP
reddit-skills incluye un servidor integrado de Model Context Protocol, lo que lo hace compatible con cualquier cliente MCP (Claude Desktop, Cursor, etc.).
Iniciar el servidor (stdio):
cd reddit-skills
python scripts/mcp_server.pyConfigurar en tu cliente MCP (por ejemplo, claude_desktop_config.json de Claude Desktop):
{
"mcpServers": {
"reddit-skills": {
"command": "python",
"args": ["scripts/mcp_server.py"],
"cwd": "/path/to/reddit-skills"
}
}
}El servidor expone 16 herramientas: check_login, logout, home_feed, subreddit_feed, search, get_post_detail, user_profile, subreddit_rules, post_comment, reply_comment, upvote, downvote, save_post, submit_text_post, submit_link_post, submit_image_post.
Variables de entorno:
Variable | Predeterminado | Descripción |
|
| URL de WebSocket para el servidor puente |
Como herramienta CLI
Todas las funciones se pueden llamar directamente desde la línea de comandos, con salida JSON para scripting.
# Check login status
python scripts/cli.py check-login
# Browse a subreddit
python scripts/cli.py subreddit-feed --subreddit python --sort hot
# Search posts
python scripts/cli.py search --query "FastAPI tutorial" --sort top --time month
# Get post details and comments
python scripts/cli.py get-post-detail \
--post-url "https://www.reddit.com/r/Python/comments/abc123/title/"
# Submit a text post
python scripts/cli.py submit-text \
--subreddit learnpython \
--title-file title.txt \
--body-file body.txt
# Submit a link post
python scripts/cli.py submit-link \
--subreddit programming \
--title-file title.txt \
--url "https://example.com/article"
# Submit an image post
python scripts/cli.py submit-image \
--subreddit pics \
--title-file title.txt \
--images "/abs/path/image.jpg"
# Comment on a post
python scripts/cli.py post-comment \
--post-url "https://www.reddit.com/r/Python/comments/abc123/title/" \
--content "Thanks for sharing!"
# Upvote / Downvote / Save
python scripts/cli.py upvote --post-url "https://www.reddit.com/r/..."
python scripts/cli.py downvote --post-url "https://www.reddit.com/r/..."
python scripts/cli.py save-post --post-url "https://www.reddit.com/r/..."
# View user profile
python scripts/cli.py user-profile --username spezEn la primera ejecución, si Chrome no está abierto, la CLI lo iniciará automáticamente.
Referencia de comandos CLI
Subcomando | Descripción |
| Comprobar estado de inicio de sesión, devuelve el nombre de usuario si está conectado |
| Cerrar sesión (cierre de sesión basado en UI) |
| Obtener publicaciones del feed de inicio |
| Obtener publicaciones de un subreddit (admite orden: hot/new/top/rising) |
| Buscar publicaciones (admite filtros de orden y tiempo) |
| Obtener el contenido completo de la publicación y los comentarios |
| Obtener perfil de usuario y publicaciones recientes |
| Comentar en una publicación |
| Responder a un comentario específico |
| Votar a favor de una publicación |
| Votar en contra de una publicación |
| Guardar / dejar de guardar una publicación |
| Enviar una publicación de texto (self) |
| Enviar una publicación de enlace |
| Enviar una publicación de imagen |
Códigos de salida: 0 éxito · 1 no ha iniciado sesión · 2 error
Estructura del proyecto
reddit-skills/
├── extension/ # Chrome Extension (MV3)
│ ├── manifest.json
│ └── background.js
├── scripts/ # Python automation engine
│ ├── reddit/ # Core automation library
│ │ ├── bridge.py # Extension bridge client
│ │ ├── selectors.py # CSS selectors (centralized)
│ │ ├── login.py # Login check + logout
│ │ ├── feeds.py # Home feed + subreddit feed
│ │ ├── search.py # Search + filters
│ │ ├── post_detail.py # Post detail + comment loading
│ │ ├── user_profile.py # User profile
│ │ ├── comment.py # Comment, reply
│ │ ├── vote.py # Upvote, downvote, save
│ │ ├── publish.py # Post submission
│ │ ├── types.py # Data types
│ │ ├── errors.py # Exception hierarchy
│ │ ├── urls.py # URL constants
│ │ └── human.py # Behavior simulation
│ ├── cli.py # Unified CLI entry point
│ ├── mcp_server.py # MCP server wrapper (stdio/HTTP)
│ ├── bridge_server.py # Local WebSocket bridge
│ └── image_downloader.py # Image download with local cache
├── skills/ # AI Agent skill definitions
│ ├── reddit-auth/SKILL.md
│ ├── reddit-publish/SKILL.md
│ ├── reddit-explore/SKILL.md
│ ├── reddit-interact/SKILL.md
│ └── reddit-content-ops/SKILL.md
├── SKILL.md # Skill router (routes to sub-skills)
├── CONTRIBUTING.md # Contributor guide
├── Dockerfile # Container build for MCP deployment
├── pyproject.toml
└── README.mdDesarrollo
uv sync # Install dependencies
uv run ruff check . # Lint
uv run ruff format . # Format
uv run pytest # Run testsLicencia
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Reddit posts, comments, subreddits, and search for AI agents. Free key, self-minted, no signup.
Reddit posts, full comment trees, searches, subreddits and users, as JSON or Markdown for LLMs.
Reddit posts, comments, keyword search and historical archives as tools. Runs on Apify.
Query Reddit communities, posts, brands and trends from your AI agent. OAuth 2.1.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.52,001 npm874MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search, monitor, and analyze Reddit's communities and discussions through authenticated API access with intelligent caching and rate limiting.MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching Reddit posts, fetching subreddit content, and retrieving post comments without requiring an API key. It uses public JSON endpoints to provide seamless access to Reddit data for LLM-based applications.6 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access public Reddit data via JSON endpoints, including subreddit trending posts, keyword search, and post details with comments, without authentication.10 npmMIT