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
- Klären Sie das Ziel-Subreddit und die Ranking-Dimension. Übliche Auswahlmöglichkeiten:
--listing top --time-filter allfür die Besten aller Zeiten.--listing top --time-filter monthfür aktuelle bewährte Treffer.--listing hotfür das, was gerade aktuell ist.--listing newoder--listing risingfür die frühe Entdeckung.--listing search --query "Stichwort" --search-sort comments --time-filter yearfür Themen-Mining.
- Führen Sie
scripts/reddit_mine_posts.pymit einem expliziten--out-dirim Forschungsbereich des aktuellen Projekts aus. - 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.
- 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
scoreals auch nachnum_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 sie403oder 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ürREDDIT_CLIENT_IDundREDDIT_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.