Skip to main content
Glama
reddit-skills

reddit-skills

by 1146345502

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.git

Dann die Python-Abhängigkeiten installieren:

cd reddit-skills
uv sync

Schritt 2: Browser-Erweiterung installieren

Die Erweiterung ermöglicht es der KI, Reddit in Ihrem Browser unter Verwendung Ihrer echten Anmeldesitzung zu bedienen.

  1. Öffnen Sie Chrome und navigieren Sie zu chrome://extensions/

  2. Aktivieren Sie den Entwicklermodus (oben rechts)

  3. Klicken Sie auf Entpackte Erweiterung laden und wählen Sie das Verzeichnis extension/ dieses Projekts aus

  4. Bestä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.py

In 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

REDDIT_BRIDGE_URL

ws://localhost:9334

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 spez

Wenn Chrome beim ersten Start nicht geöffnet ist, startet die CLI es automatisch.

CLI-Befehlsreferenz

Unterbefehl

Beschreibung

check-login

Anmeldestatus prüfen, Benutzernamen zurückgeben, falls angemeldet

delete-cookies

Abmelden (UI-basiertes Abmelden)

home-feed

Beiträge des Home-Feeds abrufen

subreddit-feed

Beiträge aus einem Subreddit abrufen (unterstützt Sortierung: hot/new/top/rising)

search

Beiträge suchen (unterstützt Sortier- und Zeitfilter)

get-post-detail

Vollständigen Beitragsinhalt und Kommentare abrufen

user-profile

Benutzerprofil und aktuelle Beiträge abrufen

post-comment

Einen Beitrag kommentieren

reply-comment

Auf einen bestimmten Kommentar antworten

upvote

Einen Beitrag hochstimmen

downvote

Einen Beitrag runterstimmen

save-post

Einen Beitrag speichern / Speicherung aufheben

submit-text

Einen Textbeitrag (Self-Post) einreichen

submit-link

Einen Link-Beitrag einreichen

submit-image

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.md

Entwicklung

uv sync                    # Install dependencies
uv run ruff check .        # Lint
uv run ruff format .       # Format
uv run pytest              # Run tests

Lizenz

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables 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.
      6
      2,162 npm
      908
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access public Reddit data via JSON endpoints, including subreddit trending posts, keyword search, and post details with comments, without authentication.
      83 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to autonomously operate Reddit with human-like behavior, including posting, commenting, voting, searching, messaging, and lead generation.
      15
      MIT