zicojiao/reddit-skill

Reddit Skill

Resumen

Usa esta habilidad para recopilar investigación reproducible de Reddit desde un subreddit o desde r/all mediante PRAW con autenticación OAuth. Prioriza primero los artefactos sin procesar y luego el análisis, de modo que la misma ejecución pueda ser reordenada, resumida, importada o traducida posteriormente sin necesidad de volver a obtener datos de Reddit.

Política de Idioma

Refleja el idioma del usuario para las salidas dirigidas a humanos. Si el usuario escribe en chino o el contexto del proyecto circundante es chino, redacta los informes generados, notas, índices Markdown, colas de revisión, resúmenes y recomendaciones en chino.

Mantén estables los esquemas de datos sin procesar: las claves JSON, los encabezados CSV, los títulos de Reddit, los cuerpos de las publicaciones, los comentarios, las URLs y los nombres de campos de la API pueden permanecer en su idioma original. Al ejecutar el script incluido en un contexto chino, pasa --language zh para que index.md y los mensajes de la CLI utilicen etiquetas en chino.

Configuración Necesaria

Instala la dependencia de Python si falta:

python3 -m pip install praw

En el primer uso, configura las credenciales como el siguiente paso antes de la recolección. El flujo más sencillo es:

python3 scripts/setup_reddit_env.py

Esto le pide al usuario:

REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret

y los escribe en ~/.config/reddit-skill/.env, que scripts/reddit_mine_posts.py lee automáticamente. El recolector también lee archivos .env locales del proyecto y variables de entorno del proceso.

Si el usuario ya tiene una aplicación OAuth de Reddit, indícale que reutilice el ID de la aplicación existente como REDDIT_CLIENT_ID y el secret de la aplicación como REDDIT_CLIENT_SECRET.

Si el usuario aún no tiene credenciales, explícale que https://www.reddit.com/prefs/apps es una página de aplicaciones OAuth heredada que puede seguir funcionando después de iniciar sesión, pero puede que no sea la única ruta actual de incorporación. Cuando funcione, crea una aplicación de tipo script, usa cualquier nombre de aplicación, establece la URI de redireccionamiento a http://localhost:8080, luego copia el ID de la aplicación como REDDIT_CLIENT_ID y el secret como REDDIT_CLIENT_SECRET. Si la página heredada no permite la creación de aplicaciones, guía al usuario al flujo actual de registro/solicitud de la API de datos de Reddit en las páginas oficiales de ayuda para desarrolladores de Reddit.

No almacenes las credenciales de Reddit dentro del repositorio de la habilidad. Almacénalas en variables de entorno, un archivo .env del proyecto o ~/.config/reddit-skill/.env.

Flujo de Recolección

1. Aclara el subreddit objetivo y la dimensión de clasificación. Opciones comunes:
   • --listing top --time-filter all para los mejores de todos los tiempos.
   • --listing top --time-filter month para éxitos recientes probados.
   • --listing hot para lo que se mueve actualmente.
   • --listing new o --listing rising para descubrimiento temprano.
   • --listing search --query "palabra clave" --search-sort comments --time-filter year para minería por tema.
2. Ejecuta scripts/reddit_mine_posts.py con un --out-dir explícito dentro del área de investigación del proyecto actual.
3. Conserva los archivos sin procesar generados:
   • posts.jsonl: una publicación normalizada por línea.
   • comments.jsonl: un comentario normalizado por línea cuando se solicitan comentarios.
   • posts.csv: tabla de publicaciones compatible con hojas de cálculo.
   • index.md: índice legible de las principales publicaciones.
   • summary.json: metadatos de ejecución y recuentos.
4. Analiza a partir de los artefactos generados. Prefiere releer JSONL/CSV en lugar de volver a consultar Reddit, a menos que el usuario solicite datos más recientes.

Comandos Rápidos

Ejecuta estos comandos desde el directorio que contiene este SKILL.md, o reemplaza scripts/reddit_mine_posts.py con la ruta absoluta al script de la habilidad instalada.

Recolecta las principales publicaciones de todos los tiempos en 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

Extrae las publicaciones más populares en r/all:

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

Busca en un subreddit por tema y clasifica por volumen de comentarios:

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

Guía de Análisis

• Clasifica las publicaciones tanto por score como por num_comments; los comentarios altos pueden ser más útiles para la minería de problemas que una puntuación alta.
• Para estrategia de contenido, inspecciona primero los patrones de títulos, luego los patrones de comentarios.
• Mantén la publicación o respuesta en Reddit como una cola revisada por humanos, a menos que el usuario solicite explícitamente lo contrario.
• Considera que los endpoints .json públicos anónimos no son fiables cuando devuelven 403 o datos dispersos. Prefiere PRAW con credenciales OAuth.
• Para minería de leads de DevRel o producto, evalúa la intención a partir del título, el texto de la publicación y los comentarios principales en conjunto.

Recursos

• scripts/setup_reddit_env.py: asistente de configuración interactiva para REDDIT_CLIENT_ID y REDDIT_CLIENT_SECRET.
• scripts/reddit_mine_posts.py: recolector PRAW para listados de subreddits, búsqueda, comentarios y artefactos de investigación.
• references/reddit-research-patterns.md: significados de campos, convenciones de salida y patrones de análisis de seguimiento.

Lee el archivo de referencia cuando el usuario solicite puntuación, síntesis de investigación, diseño de espacio de trabajo reutilizable o interpretación de artefactos más allá de la recolección simple.