Monitor ICP do Reddit

O que Monitor ICP do Reddit faz?

Monitore subreddits em busca de pessoas descrevendo o problema que você resolve. Pontue a relevância delas. Crie um rascunho de resposta útil para cada correspondência.

---

Regra crítica: Nunca invente URLs, títulos ou conteúdo de posts. Cada post na saída deve vir de um resultado de pesquisa do Reddit. Marque qualquer seção sem resultados como "Nenhuma correspondência encontrada." Nunca crie um rascunho de resposta para um post que não foi retornado pela pesquisa.

Regra anti-spam: Os rascunhos de resposta nunca devem mencionar seu produto ou nome da empresa, a menos que o post peça explicitamente recomendações de ferramentas. Soe como um profissional, não como um profissional de marketing.

---

Etapa 1: Verificação de Configuração

echo "GEMINI_API_KEY: ${GEMINI_API_KEY:+set}"
echo "REDDIT_CLIENT_ID: ${REDDIT_CLIENT_ID:-não definido, usando endpoints públicos (10 RPM)}"

Se GEMINI_API_KEY estiver faltando: Pare. Diga ao usuário: "GEMINI_API_KEY é necessária. Obtenha em aistudio.google.com. Adicione ao seu arquivo .env."

Se as credenciais do Reddit estiverem faltando: Continue. Use os endpoints públicos JSON do Reddit (sem autenticação, limite de 10 RPM). Para a maioria das sessões de monitoramento de 3-6 pesquisas em subreddits, isso é suficiente.

Se REDDIT_CLIENT_ID estiver definido: Use OAuth para 60 RPM. Obtenha um token primeiro:

TOKEN=$(curl -s -X POST \
  -d "grant_type=password&username=$REDDIT_USERNAME&password=$REDDIT_PASSWORD" \
  --user "$REDDIT_CLIENT_ID:$REDDIT_CLIENT_SECRET" \
  -H "User-Agent: varnan-skills/1.0" \
  https://www.reddit.com/api/v1/access_token \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

Use Authorization: Bearer $TOKEN e a URL base https://oauth.reddit.com para todas as requisições subsequentes.

---

Etapa 2: Carregar ICP

Verifique se existe um arquivo ICP:

ls docs/icp.md 2>/dev/null && echo "icp encontrado" || echo "icp ausente"

Se docs/icp.md existir: Leia. Extraia:

• product: descrição do produto em uma frase
• pain_points: lista de frases de ponto de dor (linguagem exata do comprador)
• anti_keywords: frases que desqualificam um post
• subreddits: lista de subreddits a pesquisar

Se docs/icp.md não existir: Faça estas 3 perguntas. Não prossiga até que todas as 3 sejam respondidas:

1. O que seu produto faz? (uma frase)
2. Em quais subreddits seu ICP posta? (separados por vírgula, ex: devops, startups, SaaS)
3. Quais frases de ponto de dor devem acionar uma correspondência? (3-5 frases nas próprias palavras do seu comprador, ex: "o onboarding demora uma eternidade", "não consigo ver por que os usuários cancelam")

Após as respostas serem coletadas, salve em docs/icp.md no formato canônico de references/icp-format.md. Confirme: "ICP salvo em docs/icp.md. Será usado automaticamente em execuções futuras."

Leia references/icp-format.md para o formato canônico e exemplos de frases de ponto de dor boas vs. ruins.

---

Etapa 3: Pesquisar no Reddit

Para cada combinação de subreddit e frase de ponto de dor, execute uma pesquisa. Use endpoints públicos, a menos que as credenciais OAuth estejam definidas.

Sem OAuth (endpoint público):

curl -s \
  -H "User-Agent: varnan-skills/1.0" \
  "https://www.reddit.com/r/{SUBREDDIT}/search.json?q={PHRASE}&sort=new&t=week&limit=25&restrict_sr=true" \
  | python3 -c "
import sys, json
d = json.load(sys.stdin)
posts = d.get('data', {}).get('children', [])
for p in posts:
    data = p['data']
    print(json.dumps({
        'id': data['id'],
        'title': data['title'],
        'body': data.get('selftext', '')[:600],
        'url': 'https://reddit.com' + data['permalink'],
        'score': data['score'],
        'comments': data['num_comments'],
        'subreddit': data['subreddit'],
        'created_utc': data['created_utc']
    }))
"

Com OAuth: Substitua https://www.reddit.com por https://oauth.reddit.com e adicione -H "Authorization: Bearer $TOKEN".

Codifique a frase na URL antes de inseri-la na string de consulta:

ENCODED=$(python3 -c "import urllib.parse, sys; print(urllib.parse.quote(sys.argv[1]))" "{PHRASE}")

Padrões de janela de tempo:

• Padrão: t=week (últimos 7 dias)
• Usuário diz "hoje" ou "últimas 24 horas": t=day
• Usuário diz "este mês": t=month

Após todas as pesquisas:

• Colete todos os posts em uma lista
• Deduplique por ID do post. Se o mesmo post corresponder a várias frases, mantenha-o uma vez e anote todas as frases correspondentes.
• Se uma pesquisa retornar 0 posts: anote e continue. Não pare.

Informe o total de candidatos antes da pontuação: "Encontrados X posts candidatos em Y subreddits."

---

Etapa 4: Pontuar Relevância com Gemini

Escreva todos os posts candidatos e o contexto do ICP em um arquivo temporário e pontue:

cat > /tmp/reddit-score-request.json << 'ENDJSON'
{
  "system_instruction": {
    "parts": [{
      "text": "Você é um analista de GTM identificando posts do Reddit onde alguém está experimentando o ponto de dor exato que um produto específico resolve. Para cada post fornecido, produza um objeto JSON com estes campos: id (o id do post), score (inteiro 1-5), reason (uma frase explicando a pontuação). Rubrica de pontuação: 5 = pessoa claramente tem o problema E está ativamente buscando ajuda ou desabafando sobre ele; 4 = sinal forte, o problema está presente, mas menos explícito; 3 = possível correspondência, incerto; 2 = tangencialmente relacionado, mas não a dor central; 1 = não relacionado. Produza apenas um array JSON de objetos de pontuação. Nenhum comentário antes ou depois do array."
    }]
  },
  "contents": [{
    "parts": [{
      "text": "POSTS_AND_ICP_CONTEXT_HERE"
    }]
  }],
  "generationConfig": {
    "temperature": 0.2,
    "maxOutputTokens": 2048
  }
}
ENDJSON
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @/tmp/reddit-score-request.json \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['candidates'][0]['content']['parts'][0]['text'])"

Substitua POSTS_AND_ICP_CONTEXT_HERE por:

• A descrição do produto e as frases de ponto de dor da Etapa 2
• Cada post candidato: id, título, trecho do corpo
• Anti-keywords do ICP (Gemini deve pontuar estes mais baixo)

Mantenha apenas posts com pontuação >= 4 para criação de rascunho de resposta.

Informe: "X posts pontuaram 4 ou 5. Criando rascunhos de respostas."

Se 0 posts pontuarem >= 4: produza a mensagem de zero resultados da Etapa 7 e pare. Não crie rascunhos de respostas vazios.

---

Etapa 5: Criar Rascunhos de Respostas com Gemini

Leia references/reply-rules.md antes de criar os rascunhos. Determine o tipo de post para cada post de alta pontuação (Modo 1, 2 ou 3) e passe o modo para o Gemini.

Para cada post com pontuação >= 4, crie um rascunho de resposta (máximo de 5 rascunhos por sessão):

cat > /tmp/reddit-reply-request.json << 'ENDJSON'
{
  "system_instruction": {
    "parts": [{
      "text": "Você é um profissional que resolveu pessoalmente o problema exato descrito neste post do Reddit. Escreva uma resposta útil que: (1) aborde diretamente o que a pessoa perguntou ou está frustrada, (2) compartilhe uma percepção específica e útil de experiência real, (3) NÃO mencione nenhum produto, ferramenta ou empresa pelo nome, a menos que o post peça explicitamente recomendações de ferramentas, (4) tenha 2-5 frases, escrita em prosa coloquial simples, sem cabeçalhos ou listas com marcadores, (5) opcionalmente termine com um convite de baixa pressão para continuar a conversa. Não use linguagem de marketing. Não use estas palavras: revolucionário, melhor da classe, otimizar, transformar, revolucionar, alavancar, contínuo, robusto, abrangente, inovador. Soe como uma pessoa real."
    }]
  },
  "contents": [{
    "parts": [{
      "text": "POST_CONTENT_AND_MODE_HERE"
    }]
  }],
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 512
  }
}
ENDJSON
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @/tmp/reddit-reply-request.json \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['candidates'][0]['content']['parts'][0]['text'])"

Substitua POST_CONTENT_AND_MODE_HERE por:

• O título e corpo completos do post
• O modo de resposta (Modo 1: desabafo/frustração, Modo 2: como você lida com X, Modo 3: recomendação de ferramenta)
• A descrição do produto (para que o Gemini saiba o que evitar nomear no Modo 1/2)
• Se Modo 3: o Gemini pode nomear o produto E deve nomear uma alternativa

---

Etapa 6: Auto-QA

Execute cada verificação e corrija violações antes de apresentar:

• Nenhum nome de produto em qualquer resposta Modo 1 ou Modo 2
• Nenhuma palavra proibida em qualquer resposta: "revolucionário", "melhor da classe", "otimizar", "transformar", "revolucionar", "alavancar", "contínuo", "robusto", "inovador"
• Cada resposta tem 2-5 frases (conte e informe)
• Cada resposta aborda diretamente a pergunta ou frustração específica no post
• Todos os URLs na saída são URLs reais do Reddit dos resultados da pesquisa (não construídos ou adivinhados)
• No máximo 5 rascunhos de respostas criados no total
• Respostas Modo 3 mencionam pelo menos uma alternativa (não apenas o produto)
• Se algum subreddit retornou 0 resultados em todas as pesquisas de palavras-chave, sinalize-o na saída

Corrija qualquer violação antes de apresentar.

---

Etapa 7: Saída e Salvamento

Apresente o relatório completo:

## Monitor ICP do Reddit — [AAAA-MM-DD]

**Subreddits monitorados:** r/[subreddit1], r/[subreddit2]
**Janela de tempo:** Últimos 7 dias
**Palavras-chave pesquisadas:** [frase1], [frase2], [frase3]
**Candidatos encontrados:** X posts
**Correspondências de alto sinal (pontuação 4-5):** Y posts

---

### Correspondência 1 — Pontuação [N]/5
**Post:** [título](url)
**Subreddit:** r/[subreddit] | [N] votos positivos | [N] comentários
**Citação de sinal:** "[trecho relevante do corpo do post]"
**Palavra-chave correspondente:** [frase]
**Tipo de post:** Modo [1/2/3]

**Rascunho de resposta:**
[texto da resposta]

**Contagem de palavras da resposta:** N palavras

---

[repita para cada correspondência]

---

**Subreddits com 0 resultados:** [liste os que não retornaram nada]

Se 0 posts pontuaram >= 4: "Nenhuma correspondência de alto sinal encontrada nos últimos 7 dias em [subreddits]. Palavras-chave pesquisadas: [lista]. Tente ampliar a janela de tempo (execute novamente e diga 'mês passado') ou amplie suas frases de ponto de dor em docs/icp.md."

Salvar em arquivo:

mkdir -p docs/reddit-intel
OUTFILE="docs/reddit-intel/$(date +%Y-%m-%d).md"
cat > "$OUTFILE" << 'EOF'
CONTEUDO_DO_RELATORIO_AQUI
EOF
echo "Salvo em $OUTFILE"