CommunitySchreiben & Editierengithub.com

zicojiao/reddit-skill

Installierbare KI-Agenten-Fähigkeit zum Mining von Reddit-Subreddit-Beiträgen mit PRAW.

Was ist reddit-skill?

Diese Fähigkeit ermöglicht KI-Agenten wie Claude Code oder Cursor, reproduzierbare Reddit-Recherche durchzuführen, indem sie Beiträge und Kommentare aus einem bestimmten Subreddit oder aus r/all über OAuth-gesichertes PRAW sammeln. Sie priorisiert die Erstellung roher Artefakte (JSONL, CSV, Index), sodass Analysen wie Ranking, Zusammenfassung oder Import später ohne erneutes Abrufen von Reddit durchgeführt werden können. Die Fähigkeit unterstützt mehrere Listings (top, hot, new, rising, search) und Zeitfilter, und bietet eine einheitliche Ausgabe für die weitere Verarbeitung. Ein besonderes Merkmal ist die Sprachpolitik: Die Benutzeroberfläche und Berichte spiegeln die Sprache des Benutzers wider (z. B. Chinesisch mit --language zh), während Rohdaten wie JSON-Schlüssel und Reddit-Titel in ihrer Originalsprache bleiben. Die Einrichtung erfolgt über ein Skript, das die Reddit-OAuth-Zugangsdaten sicher in einer .env-Datei speichert, und die Sammlung wird über die CLI gesteuert, wobei die Ergebnisse direkt im Projektverzeichnis abgelegt werden.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add zicojiao/reddit-skill

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Reddit Skill

Übersicht

Verwenden Sie diese Fähigkeit, um reproduzierbare Reddit-Recherche aus einem Subreddit oder aus r/all über OAuth-gesichertes PRAW zu sammeln. Bevorzugen Sie zuerst rohe Artefakte, dann die Analyse, sodass derselbe Durchlauf später neu bewertet, zusammengefasst, importiert oder übersetzt werden kann, ohne Reddit erneut abzurufen.

Sprachrichtlinie

Spiegeln Sie die Sprache des Benutzers für menschenlesbare Ausgaben wider. Wenn der Benutzer auf Chinesisch schreibt oder der umgebende Projektkontext auf Chinesisch ist, schreiben Sie generierte Berichte, Notizen, Markdown-Indizes, Review-Queues, Zusammenfassungen und Empfehlungen auf Chinesisch.

Halten Sie die Rohdatenschemata stabil: JSON-Schlüssel, CSV-Header, Reddit-Titel, Beitragstexte, Kommentare, URLs und API-Feldnamen können in ihrer Originalsprache bleiben. Wenn Sie das gebündelte Skript in einem chinesischen Kontext ausführen, übergeben Sie --language zh, sodass index.md und CLI-Meldungen chinesische Bezeichnungen verwenden.

Erforderliche Einrichtung

Installieren Sie die Python-Abhängigkeit, falls sie fehlt:

python3 -m pip install praw

Machen Sie bei der ersten Verwendung die Einrichtung der Zugangsdaten zum nächsten Schritt vor der Sammlung. Der einfachste Ablauf ist:

python3 scripts/setup_reddit_env.py

Dieses Skript fragt den Benutzer nach:

REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret

und schreibt sie in ~/.config/reddit-skill/.env, das scripts/reddit_mine_posts.py automatisch einliest. Der Kollektor liest auch projektspezifische .env-Dateien und Prozessumgebungsvariablen.

Wenn der Benutzer bereits eine Reddit-OAuth-App hat, sagen Sie ihm, dass er die vorhandene App-ID als REDDIT_CLIENT_ID und das App-Geheimnis als REDDIT_CLIENT_SECRET wiederverwenden soll.

Wenn der Benutzer noch keine Zugangsdaten hat, erklären Sie, dass https://www.reddit.com/prefs/apps eine Legacy-OAuth-App-Seite ist, die nach dem Login möglicherweise noch funktioniert, aber möglicherweise nicht der einzige aktuelle Onboarding-Pfad ist. Wenn es funktioniert, erstellen Sie eine script-App, verwenden Sie einen beliebigen App-Namen, setzen Sie die Umleitungs-URI auf http://localhost:8080 und kopieren Sie dann die App-ID als REDDIT_CLIENT_ID und das Geheimnis als REDDIT_CLIENT_SECRET. Wenn die Legacy-Seite keine App-Erstellung erlaubt, führen Sie den Benutzer zum aktuellen Reddit-Daten-API-Anmelde-/Anforderungsablauf auf den offiziellen Reddit-Hilfe-Entwicklerseiten.

Speichern Sie Reddit-Zugangsdaten nicht im Skill-Repository. Speichern Sie sie in Umgebungsvariablen, einer Projektspezifischen .env oder in ~/.config/reddit-skill/.env.

Sammlungs-Workflow

  1. Klären Sie das Ziel-Subreddit und die Ranking-Dimension. Übliche Auswahlmöglichkeiten:
    • --listing top --time-filter all für die Besten aller Zeiten.
    • --listing top --time-filter month für aktuelle bewährte Treffer.
    • --listing hot für das, was gerade aktuell ist.
    • --listing new oder --listing rising für die frühe Entdeckung.
    • --listing search --query "Stichwort" --search-sort comments --time-filter year für Themen-Mining.
  2. Führen Sie scripts/reddit_mine_posts.py mit einem expliziten --out-dir im Forschungsbereich des aktuellen Projekts aus.
  3. Bewahren Sie die generierten Rohdateien auf:
    • posts.jsonl: ein normalisierter Beitrag pro Zeile.
    • comments.jsonl: ein normalisierter Kommentar pro Zeile, wenn Kommentare angefordert werden.
    • posts.csv: tabellenfreundliche Beitragstabelle.
    • index.md: menschenlesbarer Top-Beitrags-Index.
    • summary.json: Ausführungsmetadaten und Zählungen.
  4. Analysieren Sie auf der Grundlage der generierten Artefakte. Ziehen Sie es vor, JSONL/CSV erneut zu lesen, anstatt Reddit erneut abzufragen, es sei denn, der Benutzer fragt nach aktuelleren Daten.

Kurzbefehle

Führen Sie diese aus dem Verzeichnis aus, das diese SKILL.md enthält, oder ersetzen Sie scripts/reddit_mine_posts.py durch den absoluten Pfad zum installierten Skill-Skript.

Sammeln Sie die besten Beiträge aller Zeiten in einem Subreddit:

python3 scripts/reddit_mine_posts.py \
  --subreddit LocalLLaMA \
  --listing top \
  --time-filter all \
  --language zh \
  --limit 100 \
  --include-comments \
  --max-comments 8 \
  --out-dir research/reddit/localllama-top-all

Minen Sie die heißesten Beiträge aus r/all:

python3 scripts/reddit_mine_posts.py \
  --subreddit all \
  --listing hot \
  --language zh \
  --limit 100 \
  --out-dir research/reddit/all-hot

Durchsuchen Sie ein Subreddit nach Thema und sortieren Sie nach Kommentarvolumen:

python3 scripts/reddit_mine_posts.py \
  --subreddit SaaS \
  --listing search \
  --query "voice agent" \
  --search-sort comments \
  --time-filter year \
  --language zh \
  --limit 75 \
  --include-comments \
  --out-dir research/reddit/saas-voice-agent-comments

Analysehilfe

  • Bewerten Sie Beiträge sowohl nach score als auch nach num_comments; viele Kommentare können für das Mining von Problemen nützlicher sein als eine hohe Bewertung.
  • Untersuchen Sie für die Content-Strategie zuerst Titel-Muster, dann Kommentar-Muster.
  • Behalten Sie das Posten oder Antworten auf Reddit als eine von Menschen überprüfte Warteschlange bei, es sei denn, der Benutzer wünscht ausdrücklich etwas anderes.
  • Behandeln Sie öffentliche anonyme .json-Endpunkte als unzuverlässig, wenn sie 403 oder spärliche Daten zurückgeben. Bevorzugen Sie PRAW mit OAuth-Zugangsdaten.
  • Bewerten Sie für DevRel- oder Produkt-Lead-Mining die Absicht aus dem Titel, dem Selbsttext und den Top-Kommentaren gemeinsam.

Ressourcen

  • scripts/setup_reddit_env.py: interaktiver Einrichtungshelfer für REDDIT_CLIENT_ID und REDDIT_CLIENT_SECRET.
  • scripts/reddit_mine_posts.py: PRAW-Kollektor für Subreddit-Listen, Suche, Kommentare und Forschungsartefakte.
  • references/reddit-research-patterns.md: Feldbedeutungen, Ausgabekonventionen und Folgemuster für Analysen.

Lesen Sie die Referenzdatei, wenn der Benutzer nach Bewertung, Forschungszusammenfassung, wiederverwendbarem Arbeitsbereichs-Layout oder Artefaktinterpretation fragt, die über die einfache Sammlung hinausgeht.

Verwandte Skills