reddit-skills
reddit-skills
Reddit-Automatisierungs-Skills – nutzt direkt Ihren angemeldeten Browser und Ihr echtes Konto, um Reddit wie ein gewöhnlicher Benutzer zu bedienen.
Unterstützt OpenClaw und alle KI-Agenten-Plattformen, die mit dem SKILL.md-Format kompatibel sind (z. B. Claude Code).
⚠️ Nutzungshinweis: Obwohl dieses Projekt Ihren echten Browser und Ihr Konto verwendet, sollten Sie dennoch die Häufigkeit der Vorgänge kontrollieren und Massenaktionen in kurzer Zeit vermeiden. Aggressive Automatisierung kann die Ratenbegrenzungen von Reddit oder Kontobeschränkungen auslösen.
Funktionen
Skill | Beschreibung | Kernfähigkeiten |
reddit-auth | Authentifizierung | Login-Prüfung, Sitzungsverwaltung |
reddit-publish | Inhaltsveröffentlichung | Einreichen von Text- / Link- / Bildbeiträgen |
reddit-explore | Entdeckung | Suche, Subreddit-Browsing, Beitragsdetails, Benutzerprofile |
reddit-interact | Soziale Interaktion | Kommentieren, Antworten, Hochstimmen, Runterstimmen, Speichern |
reddit-content-ops | Verbundene Vorgänge | Subreddit-Analyse, Trendverfolgung, Engagement-Kampagnen |
Unterstützt verkettete Vorgänge – Sie können komplexe Anweisungen in natürlicher Sprache geben und der Agent verkettet automatisch mehrere Skills. Zum Beispiel:
"Suche in r/Python nach den Beiträgen mit den meisten Upvotes über FastAPI diese Woche, speichere den obersten und sag mir, worum es geht"
Der Agent führt aus: Suche → Filtern nach Top/Woche → Speichern → Details abrufen → Zusammenfassen.
Related MCP server: mcp-reddit
Installation
Voraussetzungen
Python >= 3.11
uv Paketmanager
Google Chrome Browser
Schritt 1: Projekt installieren
Option A: ZIP herunterladen (empfohlen)
Von GitHub herunterladen und in Ihr Agent-Skills-Verzeichnis entpacken:
# OpenClaw
<openclaw-project>/skills/reddit-skills/
# Claude Code
<your-project>/.claude/skills/reddit-skills/Option B: Git Clone
cd <your-agent-project>/skills/
git clone https://github.com/1146345502/reddit-skills.gitDann die Python-Abhängigkeiten installieren:
cd reddit-skills
uv syncSchritt 2: Browser-Erweiterung installieren
Die Erweiterung ermöglicht es der KI, Reddit in Ihrem Browser unter Verwendung Ihrer echten Anmeldesitzung zu bedienen.
Öffnen Sie Chrome und navigieren Sie zu
chrome://extensions/Aktivieren Sie den Entwicklermodus (oben rechts)
Klicken Sie auf Entpackte Erweiterung laden und wählen Sie das Verzeichnis
extension/dieses Projekts ausBestätigen Sie, dass die Reddit Bridge-Erweiterung aktiviert ist
Sobald sie installiert ist, können Sie loslegen – alle Aktionen finden in Ihrem eigenen Browser unter Verwendung Ihres echten Kontos statt.
Verwendung
Als KI-Agent-Skill (empfohlen)
Nach der Installation in einem Skills-Verzeichnis sprechen Sie einfach in natürlicher Sprache mit dem Agenten. Er leitet Ihre Absicht automatisch an den richtigen Skill weiter.
Authentifizierung:
"Prüfe, ob ich bei Reddit angemeldet bin" / "Melde mich bei Reddit ab"
Suchen & Browsen:
"Suche auf Reddit nach Beiträgen über maschinelles Lernen" / "Zeige mir die Top-Beiträge auf r/Python"
Inhalte einreichen:
"Reiche einen Textbeitrag bei r/learnpython mit diesem Titel und Inhalt ein..."
Interagieren:
"Gib diesem Beitrag ein Upvote" / "Kommentiere diesen Beitrag: Toller Artikel!" / "Speichere diesen Beitrag"
Verbundene Vorgänge:
"Analysiere die Top-Beiträge in r/startups diesen Monat und fasse die gemeinsamen Themen zusammen"
Als MCP-Server
reddit-skills enthält einen integrierten Model Context Protocol-Server, wodurch es mit jedem MCP-Client (Claude Desktop, Cursor usw.) kompatibel ist.
Server starten (stdio):
cd reddit-skills
python scripts/mcp_server.pyIn Ihrem MCP-Client konfigurieren (z. B. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"reddit-skills": {
"command": "python",
"args": ["scripts/mcp_server.py"],
"cwd": "/path/to/reddit-skills"
}
}
}Der Server stellt 16 Tools bereit: 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.
Umgebungsvariablen:
Variable | Standard | Beschreibung |
|
| WebSocket-URL für den Bridge-Server |
Als CLI-Tool
Alle Funktionen können direkt über die Befehlszeile aufgerufen werden, mit JSON-Ausgabe für Skripte.
# 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 spezWenn Chrome beim ersten Start nicht geöffnet ist, startet die CLI es automatisch.
CLI-Befehlsreferenz
Unterbefehl | Beschreibung |
| Anmeldestatus prüfen, Benutzernamen zurückgeben, falls angemeldet |
| Abmelden (UI-basiertes Abmelden) |
| Beiträge des Home-Feeds abrufen |
| Beiträge aus einem Subreddit abrufen (unterstützt Sortierung: hot/new/top/rising) |
| Beiträge suchen (unterstützt Sortier- und Zeitfilter) |
| Vollständigen Beitragsinhalt und Kommentare abrufen |
| Benutzerprofil und aktuelle Beiträge abrufen |
| Einen Beitrag kommentieren |
| Auf einen bestimmten Kommentar antworten |
| Einen Beitrag hochstimmen |
| Einen Beitrag runterstimmen |
| Einen Beitrag speichern / Speicherung aufheben |
| Einen Textbeitrag (Self-Post) einreichen |
| Einen Link-Beitrag einreichen |
| Einen Bildbeitrag einreichen |
Exit-Codes: 0 Erfolg · 1 nicht angemeldet · 2 Fehler
Projektstruktur
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.mdEntwicklung
uv sync # Install dependencies
uv run ruff check . # Lint
uv run ruff format . # Format
uv run pytest # Run testsLizenz
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.62,162 npm908MIT
- 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.83 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to prepare, preview, and get human approval before publishing Reddit posts and comments via a local authenticated browser session, without Reddit API credentials.96 npm2MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to autonomously operate Reddit with human-like behavior, including posting, commenting, voting, searching, messaging, and lead generation.15MIT