CommunityRédaction et éditiongithub.com

zicojiao/reddit-skill

Compétence d'agent IA installable pour extraire des publications de subreddits Reddit avec PRAW.

Qu'est-ce que reddit-skill ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor ou Codex) de collecter des données de recherche reproductibles depuis Reddit, en utilisant l'API PRAW avec authentification OAuth. Elle est idéale pour les développeurs, les analystes ou les équipes DevRel qui souhaitent explorer les tendances, analyser les commentaires ou extraire des informations sur un sujet ou un subreddit spécifique. La compétence favorise la préservation des artefacts bruts (JSON, CSV) pour permettre des analyses ultérieures sans refetch, et prend en charge les classements top, hot, new, rising et search. Elle respecte une politique linguistique qui adapte les rapports et l'index à la langue de l'utilisateur (par exemple, le chinois si le contexte est chinois), tout en maintenant les données brutes en anglais. L'installation nécessite PRAW et la configuration des identifiants OAuth via un script interactif. Les cas d'utilisation typiques incluent la curation de contenu pour les réseaux sociaux, l'étude de marché, la détection de signaux précoces et la recherche produit.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add zicojiao/reddit-skill

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Clarifiez le subreddit cible et la dimension de classement. Choix courants :
    • --listing top --time-filter all pour les meilleurs de tous les temps.
    • --listing top --time-filter month pour les succès récents avérés.
    • --listing hot pour ce qui bouge actuellement.
    • --listing new ou --listing rising pour la découverte précoce.
    • --listing search --query "mot-clé" --search-sort comments --time-filter year pour l'exploration de sujets.
  2. Exécutez scripts/reddit_mine_posts.py avec un --out-dir explicite dans la zone de recherche du projet actuel.
  3. 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.
  4. 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 score et num_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 .json publics anonymes comme peu fiables lorsqu'ils renvoient 403 ou 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 pour REDDIT_CLIENT_ID et REDDIT_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.

Skills associés