CommunityEscrita e Ediçãogithub.com

zicojiao/reddit-skill

Habilidade instalável para agentes de IA que permite minerar postagens de subreddits do Reddit usando PRAW.

O que é reddit-skill?

Esta habilidade permite que agentes de IA (como Claude Code, Cursor ou Codex) coletem postagens e comentários do Reddit de forma estruturada e reproduzível, usando a biblioteca PRAW com autenticação OAuth. O principal diferencial é a abordagem de primeiro preservar artefatos brutos (JSON, CSV) antes de realizar análises, garantindo que os mesmos dados possam ser reordenados, resumidos ou traduzidos sem a necessidade de refetch. A habilidade suporta coleta de subreddits específicos ou de r/all, com filtros de lista (hot, new, top, rising) e busca por palavras-chave. Após configurar as credenciais via script interativo, o agente pode gerar arquivos padronizados (posts.jsonl, comments.jsonl, index.md) e um resumo executivo. A análise posterior deve priorizar a releitura desses artefatos em vez de requisições repetidas ao Reddit, a menos que dados mais recentes sejam solicitados.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add zicojiao/reddit-skill

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade Reddit (Reddit Skill)

Visão Geral

Use esta habilidade para coletar pesquisas reproduzíveis do Reddit a partir de um subreddit ou de r/all usando PRAW com autenticação OAuth. Prefira primeiro os artefatos brutos e depois a análise, para que a mesma execução possa ser reclassificada, resumida, importada ou traduzida posteriormente sem precisar buscar novamente os dados do Reddit.

Política de Idioma

Espelhe o idioma do usuário para saídas voltadas a humanos. Se o usuário escrever em português ou o contexto do projeto ao redor for em português, escreva relatórios gerados, notas, índices Markdown, filas de revisão, resumos e recomendações em português.

Mantenha os esquemas de dados brutos estáveis: chaves JSON, cabeçalhos CSV, títulos do Reddit, corpos de postagens, comentários, URLs e nomes de campos da API podem permanecer no idioma original. Ao executar o script incluído em contexto em português, passe --language pt para que index.md e mensagens da linha de comando usem rótulos em português.

Configuração Necessária

Instale a dependência Python, se estiver faltando:

python3 -m pip install praw

No primeiro uso, torne a configuração de credenciais o próximo passo antes da coleta. O fluxo mais fácil é:

python3 scripts/setup_reddit_env.py

Isso solicita ao usuário:

REDDIT_CLIENT_ID=seu_reddit_client_id
REDDIT_CLIENT_SECRET=seu_reddit_client_secret

e as escreve em ~/.config/reddit-skill/.env, que o scripts/reddit_mine_posts.py lê automaticamente. O coletor também lê arquivos .env locais do projeto e variáveis de ambiente do processo.

Se o usuário já possui um aplicativo OAuth do Reddit, diga para reutilizar o ID do aplicativo existente como REDDIT_CLIENT_ID e o secret do aplicativo como REDDIT_CLIENT_SECRET.

Se o usuário ainda não tiver credenciais, explique que https://www.reddit.com/prefs/apps é uma página de aplicativos OAuth legada que ainda pode funcionar após o login, mas pode não ser o único caminho de integração atual. Quando funcionar, crie um aplicativo script, use qualquer nome de aplicativo, defina o URI de redirecionamento como http://localhost:8080, então copie o ID do aplicativo como REDDIT_CLIENT_ID e o secret como REDDIT_CLIENT_SECRET. Se a página legada não permitir a criação de aplicativos, guie o usuário para o fluxo atual de inscrição/solicitação da API de Dados do Reddit nas páginas oficiais de ajuda para desenvolvedores do Reddit.

Não armazene credenciais do Reddit dentro do repositório da habilidade. Armazene-as em variáveis de ambiente, em um .env do projeto ou em ~/.config/reddit-skill/.env.

Fluxo de Coleta

  1. Esclareça o subreddit alvo e a dimensão de classificação. Escolhas comuns:
    • --listing top --time-filter all para os melhores de todos os tempos.
    • --listing top --time-filter month para sucessos recentes comprovados.
    • --listing hot para o que está bombando no momento.
    • --listing new ou --listing rising para descoberta precoce.
    • --listing search --query "palavra-chave" --search-sort comments --time-filter year para mineração por tópico.
  2. Execute scripts/reddit_mine_posts.py com um --out-dir explícito dentro da área de pesquisa do projeto atual.
  3. Preserve os arquivos brutos gerados:
    • posts.jsonl: uma postagem normalizada por linha.
    • comments.jsonl: um comentário normalizado por linha, quando comentários são solicitados.
    • posts.csv: tabela de postagens amigável para planilhas.
    • index.md: índice das principais postagens legível por humanos.
    • summary.json: metadados da execução e contagens.
  4. Analise a partir dos artefatos gerados. Prefira reler JSONL/CSV em vez de consultar novamente o Reddit, a menos que o usuário peça dados mais recentes.

Comandos Rápidos

Execute a partir do diretório que contém este SKILL.md, ou substitua scripts/reddit_mine_posts.py pelo caminho absoluto para o script da habilidade instalada.

Coletar as melhores postagens de todos os tempos em um subreddit:

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

Minerar as postagens mais quentes em r/all:

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

Pesquisar um subreddit por tópico e classificar por volume de comentários:

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

Orientação para Análise

  • Classifique as postagens tanto por score quanto por num_comments; muitos comentários podem ser mais úteis para mineração de dores do que pontuação alta.
  • Para estratégia de conteúdo, inspecione primeiro os padrões de títulos, depois os padrões de comentários.
  • Mantenha a postagem ou resposta no Reddit como uma fila revisada por humanos, a menos que o usuário solicite explicitamente o contrário.
  • Trate endpoints .json públicos e anônimos como não confiáveis quando retornarem 403 ou dados esparsos. Prefira PRAW com credenciais OAuth.
  • Para mineração de leads em DevRel ou produto, avalie a intenção a partir do título, do texto do post e dos principais comentários juntos.

Recursos

  • scripts/setup_reddit_env.py: auxiliar de configuração interativo para REDDIT_CLIENT_ID e REDDIT_CLIENT_SECRET.
  • scripts/reddit_mine_posts.py: coletor PRAW para listagens de subreddit, busca, comentários e artefatos de pesquisa.
  • references/reddit-research-patterns.md: significados dos campos, convenções de saída e padrões de análise de acompanhamento.

Leia o arquivo de referência quando o usuário solicitar pontuação, síntese de pesquisa, layout de espaço de trabalho reutilizável ou interpretação de artefatos além da coleta simples.

Habilidades Relacionadas