Compétence Reddit
Présentation
Utilisez cette compétence pour collecter des recherches reproductibles sur Reddit à partir d'un seul subreddit ou de r/all via PRAW avec OAuth. Privilégiez les artefacts bruts en premier, puis l'analyse, afin que la même exécution puisse être re-classée, résumée, importée ou traduite ultérieurement sans avoir à récupérer à nouveau Reddit.
Politique linguistique
Adaptez la langue aux sorties destinées à l'utilisateur. Si l'utilisateur écrit en chinois ou que le contexte du projet est chinois, rédigez les rapports, notes, index Markdown, files de révision, résumés et recommandations en chinois.
Maintenez les schémas de données brutes stables : les clés JSON, les en-têtes CSV, les titres Reddit, les corps de publication, les commentaires, les URL et les noms de champs d'API peuvent rester dans leur langue d'origine. Lorsque vous exécutez le script fourni dans un contexte chinois, transmettez --language zh afin que index.md et les messages destinés à la ligne de commande utilisent des libellés en chinois.
Configuration requise
Installez la dépendance Python si elle est absente :
python3 -m pip install praw
Lors de la première utilisation, faites de la configuration des identifiants la prochaine étape avant la collecte. Le flux le plus simple est :
python3 scripts/setup_reddit_env.py
Ce script demande à l'utilisateur :
REDDIT_CLIENT_ID=votre_reddit_client_id
REDDIT_CLIENT_SECRET=votre_reddit_client_secret
et les écrit dans ~/.config/reddit-skill/.env, que scripts/reddit_mine_posts.py lit automatiquement. Le collecteur lit également les fichiers .env locaux du projet et les variables d'environnement du processus.
Si l'utilisateur possède déjà une application OAuth Reddit, dites-lui de réutiliser l'ID d'application existant comme REDDIT_CLIENT_ID et le secret de l'application comme REDDIT_CLIENT_SECRET.
Si l'utilisateur n'a pas encore d'identifiants, expliquez que https://www.reddit.com/prefs/apps est une page d'application OAuth legacy qui peut encore fonctionner après connexion, mais peut ne pas être le seul chemin d'inscription actuel. Lorsqu'elle fonctionne, créez une application script, utilisez n'importe quel nom d'application, définissez l'URI de redirection sur http://localhost:8080, puis copiez l'ID de l'application comme REDDIT_CLIENT_ID et le secret comme REDDIT_CLIENT_SECRET. Si la page legacy ne permet pas la création d'application, guidez l'utilisateur vers le flux actuel d'inscription/demande d'API Data de Reddit dans les pages d'aide officielles pour développeurs de Reddit.
Ne stockez pas les identifiants Reddit dans le dépôt de la compétence. Stockez-les dans des variables d'environnement, un .env de projet, ou ~/.config/reddit-skill/.env.
Flux de travail de collecte
- Clarifiez le subreddit cible et la dimension de classement. Choix courants :
--listing top --time-filter allpour les meilleurs de tous les temps.--listing top --time-filter monthpour les succès récents avérés.--listing hotpour ce qui bouge actuellement.--listing newou--listing risingpour la découverte précoce.--listing search --query "mot-clé" --search-sort comments --time-filter yearpour l'exploration de sujets.
- Exécutez
scripts/reddit_mine_posts.pyavec un--out-direxplicite dans la zone de recherche du projet actuel. - Conservez les fichiers bruts générés :
posts.jsonl: une publication normalisée par ligne.comments.jsonl: un commentaire normalisé par ligne lorsque les commentaires sont demandés.posts.csv: tableau de publications compatible tableur.index.md: index lisible par l'humain des meilleures publications.summary.json: métadonnées et comptages de l'exécution.
- Analysez à partir des artefacts générés. Privilégiez la relecture des JSONL/CSV plutôt qu'une nouvelle requête à Reddit, sauf si l'utilisateur demande des données plus récentes.
Commandes rapides
Exécutez ces commandes depuis le répertoire contenant ce SKILL.md, ou remplacez scripts/reddit_mine_posts.py par le chemin absolu du script de la compétence installée.
Collectez les meilleures publications de tous les temps dans un 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
Exploitez les publications les plus chaudes de r/all :
python3 scripts/reddit_mine_posts.py \
--subreddit all \
--listing hot \
--language zh \
--limit 100 \
--out-dir research/reddit/all-hot
Recherchez un subreddit par sujet et classez par volume de commentaires :
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
Conseils d'analyse
- Classez les publications à la fois par
scoreetnum_comments; un nombre élevé de commentaires peut être plus utile pour l'exploration des problèmes qu'un score élevé. - Pour la stratégie de contenu, inspectez d'abord les modèles de titres, puis les modèles de commentaires.
- Gardez la publication ou la réponse sur Reddit comme une file d'attente révisée par un humain, sauf si l'utilisateur demande explicitement le contraire.
- Traitez les points de terminaison
.jsonpublics anonymes comme peu fiables lorsqu'ils renvoient403ou des données éparses. Préférez PRAW avec des identifiants OAuth. - Pour l'exploration de leads DevRel ou de produits, évaluez l'intention à partir du titre, du texte de la publication et des meilleurs commentaires ensemble.
Ressources
scripts/setup_reddit_env.py: assistant de configuration interactif pourREDDIT_CLIENT_IDetREDDIT_CLIENT_SECRET.scripts/reddit_mine_posts.py: collecteur PRAW pour les listes de subreddits, la recherche, les commentaires et les artefacts de recherche.references/reddit-research-patterns.md: significations des champs, conventions de sortie et modèles d'analyse de suivi.
Lisez le fichier de référence lorsque l'utilisateur demande une notation, une synthèse de recherche, une disposition d'espace de travail réutilisable ou une interprétation d'artefacts au-delà de la simple collecte.