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
- Esclareça o subreddit alvo e a dimensão de classificação. Escolhas comuns:
--listing top --time-filter allpara os melhores de todos os tempos.--listing top --time-filter monthpara sucessos recentes comprovados.--listing hotpara o que está bombando no momento.--listing newou--listing risingpara descoberta precoce.--listing search --query "palavra-chave" --search-sort comments --time-filter yearpara mineração por tópico.
- Execute
scripts/reddit_mine_posts.pycom um--out-direxplícito dentro da área de pesquisa do projeto atual. - 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.
- 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
scorequanto pornum_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
.jsonpúblicos e anônimos como não confiáveis quando retornarem403ou 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 paraREDDIT_CLIENT_IDeREDDIT_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.