Sassy Fact Check

Um bot

Documentação

Sassy Fact Check 💅 — O Bot de Verificação de Fatos Sem Filtro

Onde as más opiniões vão morrer, com uma dose de sass.

Sassy Fact Check é um servidor MCP de DM do Instagram que detona mitos de saúde e desinformação viral com fatos picantes e sem filtro. Pense em MythBusters encontrando Mean Girls com uma assinatura do PubMed! 🔥📚

👑 Conheça a Valentina

Valentina Factcheck 💅 ela/dela
💅 IA com atitude, fatos com sabor
🚫 Sem enrolação. Sem suavização.
✉️ Manda uma afirmação no DM — eu respondo na hora com fontes

✨ Recursos

Sassy Fact-Checking: Detona desinformação com citações e atitude (máx. 25-35 palavras!)
Filtro Inteligente de Conteúdo: Ajusta automaticamente o tom para tópicos sensíveis
Modos de Resposta Múltiplos: Respostas sassy, suaves, neutras e bloqueadas
Arquitetura MCP Dupla: Instagram MCP + Sassy Bot MCP trabalhando juntos
Rastreamento de Analytics: Registra interações para estatísticas diárias de sass
Segurança em Primeiro Lugar: Bloqueia teorias da conspiração, suaviza para luto/trauma

🎬 Vídeo de Demonstração

Eu construí uma IA de verificação de fatos com sass que se integra aos DMs do Instagram. Veja-a analisar mitos de saúde e gerar respostas perfeitas com citações e atitude!

🔥 Demo em Modo Real
🎯 Demo em Modo Demo

Destaques da Demo:

🔥 Detonação de Mitos de Saúde — Alegações sobre vinagre de maçã destruídas
⚡ Alertas de Segurança — Conselhos perigosos bloqueados instantaneamente
💙 Filtro Inteligente — Suaviza automaticamente para tópicos sensíveis
✅ Status do Sistema — Todos os componentes funcionando perfeitamente

🚀 Início Rápido

Pré-requisitos

Python 3.11+
Aplicativo Claude Desktop
Instagram DM MCP da Gala Labs
Conta do Instagram (para o modo real)
Chave da API da Anthropic

Instalação

Clone e configure o ambiente virtual

git clone https://github.com/sangreal-007/sassy-factcheck-bot.git
cd sassy-factcheck-bot

# Create and activate virtual environment (required on macOS)
python3 -m venv venv
source venv/bin/activate

# You should see (venv) in your terminal prompt

# Interactive credential setup
python setup_env.py

# Install dependencies
pip install -r requirements.txt

Configure o Claude Desktop para a Configuração MCP Dupla

Você precisa que AMBOS os servidores estejam rodando para funcionalidade completa:

Primeiro, obtenha seus caminhos exatos:

# Navigate to your project and get exact paths
cd sassy-factcheck-bot
pwd  # Shows your project directory

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

open -a TextEdit ~/Library/"Application Support"/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "instagram_dms": {
      "command": "/Users/yourusername/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/yourusername/instagram_dm_mcp",
        "python",
        "src/mcp_server.py"
      ]
    },
    "sassy_factcheck": {
      "command": "/Users/yourusername/sassy-factcheck-bot/venv/bin/python",
      "args": ["/Users/yourusername/sassy-factcheck-bot/src/mcp_server.py"],
      "cwd": "/Users/yourusername/sassy-factcheck-bot"
    }
  }
}

⚠️ Importante: Substitua /Users/yourusername/ pelo seu caminho real do comando pwd acima.

Teste Ambos os Servidores

# Terminal 1: Start Instagram MCP (Gala Labs)
cd ../instagram_dm_mcp
uv run python src/mcp_server.py

# Terminal 2: Start Sassy Bot
cd sassy-factcheck-bot
source venv/bin/activate
python src/mcp_server.py

Reinicie o Claude Desktop e inicie o fluxo de trabalho MCP duplo completo!

🎛️ Modo Demo vs Modo Real

Seu bot suporta tanto o modo demo quanto a integração real com o Instagram:

Modo Demo (Padrão - Perfeito para Testes)

# In your .env file
INSTAGRAM_REAL_MODE=false

# Features:
# ✅ Practice with fake health claims
# ✅ Test sassy response generation  
# ✅ Safe for development
# ✅ No Instagram account needed

Modo Real (Integração ao Vivo com Instagram)

# In your .env file  
INSTAGRAM_REAL_MODE=true

# Features:
# ✅ Real Instagram API via Gala Labs MCP
# ✅ Actual DM conversations
# ✅ Live fact-checking responses
# ✅ Production-ready deployment

Alternando Modos

# Edit your .env file
nano .env

# Change this line:
INSTAGRAM_REAL_MODE=false  # Demo mode
# OR
INSTAGRAM_REAL_MODE=true   # Real mode

# Restart your sassy bot server
python src/mcp_server.py

⚠️ Aviso de Segurança

🛡️ Para o Modo Real: Use uma conta de teste dedicada do Instagram, nunca sua conta principal!

O Instagram detecta ativamente automação e pode restringir contas. Crie uma conta descartável especificamente para testes para proteger seu Instagram pessoal.

💬 Como Funciona

Fluxo de Trabalho MCP Duplo Completo

Instagram MCP: list_chats → Veja conversas reais
Sassy Bot: generate_sassy_response → Crie resposta viral com fonte
Instagram MCP: send_message → Envie para o usuário real do Instagram

Detecção Automática de Tom

Mitos de saúde → Detonação sassy 🔥
Tópicos sensíveis → Abordagem gentil 💙
Teorias da conspiração → Bloqueadas 🚫
Spam → Descarte máximo 🗑️

🎭 Modos de Resposta (Seleção Automática)

Modo	Gatilho	Estilo	Exemplo
Sassy	Mitos de saúde, alegações gerais	Espirituoso, cheio de emojis, 25-35 palavras	"🙄 Se isso funcionasse, todas seríamos supermodelos!"
Suave	Câncer, luto, saúde mental	Gentil, compreensivo	"Entendo que isso é difícil. Por favor, consulte..."
Neutro	Contextos profissionais	Educacional, emojis mínimos	"A pesquisa mostra que essa alegação é imprecisa."
Bloqueado	Teorias da conspiração	Recusa educada	"Não me envolvo com esse tipo de conteúdo."

🛠️ Ferramentas MCP Disponíveis

Ferramentas do Sassy Bot MCP (Geração de Respostas):

generate_sassy_response - Crie respostas virais de verificação de fatos com fontes
generate_welcome_message - Crie mensagens de boas-vindas para novos seguidores
check_instagram_dms - Mostre alegações de prática (modo demo) ou guia para o Instagram MCP (modo real)
instagram_integration_status - Mostre o status da integração MCP dupla

Ferramentas do Instagram MCP (Mensagens - via Gala Labs):

list_chats - Veja conversas reais do Instagram
send_message - Envie respostas para usuários reais do Instagram
get_user_followers - Verifique listas de seguidores
get_thread_details - Obtenha histórico completo da conversa

Exemplos de Uso:

Use generate_sassy_response with:
- content: "Apple cider vinegar burns belly fat instantly"
- username: "wellness_guru_fake"

Use instagram_integration_status to check dual MCP setup

Use list_chats to see real Instagram conversations

🔧 Configuração

Configuração Simples (Apenas o que Você Precisa)

# Required
INSTAGRAM_USERNAME=your_username
INSTAGRAM_PASSWORD=your_password  
ANTHROPIC_API_KEY=your_claude_key

# Mode Selection
INSTAGRAM_REAL_MODE=true  # true for real Instagram, false for demo

# Optional
ENABLE_SAFE_MODE=true  # Auto-soften for sensitive topics
LOG_INTERACTIONS=true  # Track daily stats

Personalizar Filtros

Edite src/filters.py para ajustar:

Palavras-chave de tópicos sensíveis (ativa automaticamente o modo suave)
Palavras-chave de pânico de saúde (extra sassy)
Conteúdo bloqueado (teorias da conspiração)
Limites de comprimento de resposta

🧪 Exemplos de Teste

Experimente estes no Claude Desktop:

# Demo Mode Testing
Use generate_sassy_response with:
- content: "Green tea burns 100 calories per cup"
- username: "tea_fanatic"

# Real Mode Testing
Use list_chats to see real conversations
Use generate_sassy_response for real claims
Use send_message to send responses

Use instagram_integration_status to check setup

🎯 Exemplos de Respostas

Mito de Saúde (Modo Sassy):

Entrada: "O vinagre de maçã queima gordura da barriga instantaneamente"

Saída: "🙄 Se vinagre queimasse gordura instantaneamente, todas seríamos supermodelos! Realidade: 2-4 libras em 12 semanas 💅 Fonte: Mayo Clinic"

Tópico Sensível (Modo Suave Automático):

Entrada: "Minha amiga morreu de câncer porque não tentou cura natural"

Saída: "Sinto muito pela sua perda. O tratamento do câncer é complexo. Para informações baseadas em evidências, consulte profissionais de oncologia. Fonte: American Cancer Society"

Teoria da Conspiração (Bloqueado):

Entrada: "Chemtrails estão nos envenenando a todos"

Saída: "Não me envolvo com esse tipo de conteúdo. Vamos manter os fatos! 📚"

🏆 Submissão para Hackathon

Construído para o Hackathon Instagram DM MCP da Gala Labs!

Inovação Chave: Arquitetura MCP dupla com ajuste automático de tom baseado na sensibilidade do conteúdo, mantendo o máximo de sass para desinformação de saúde.

🛠️ Arquitetura Técnica

Configuração MCP Dupla: Instagram MCP (Gala Labs) + Sassy Bot MCP trabalhando juntos
Operações no Instagram: API real do Instagram via Instagram DM MCP da Gala Labs
Geração de Respostas: Sassy Bot MCP com integração com a API Claude
Filtragem de Conteúdo: Categorização inteligente com recomendação de tom
Camada de Segurança: Filtragem em vários níveis para conteúdo sensível
Alternância de Modo: Modo Demo/Real para desenvolvimento e produção

⚠️ Notas Importantes

MCP Duplo Obrigatório: Tanto o Instagram MCP quanto o Sassy Bot MCP devem estar rodando
Ambiente Virtual Obrigatório: Usuários de macOS devem usar ambientes virtuais devido às restrições do Python do sistema
Modo Demo: Perfeito para testar sem conta do Instagram - usa alegações de prática
Modo Real: Conecta-se ao Instagram real via MCP da Gala Labs para conversas ao vivo
Comprimento da Resposta: Otimizado para respostas de 25-35 palavras, perfeito para redes sociais

🤝 Contribuindo

Faça um fork do repositório
Crie um branch de recurso: git checkout -b feature/more-sass
Adicione suas capacidades de detonação
Teste com: python src/mcp_server.py
Envie um PR com nível máximo de sass 💅

📜 Licença

Licença MIT - Vá em frente e verifique fatos com responsabilidade!

💌 Contato

Construído com 💅 e citações por sangreal-007

GitHub: @sangreal-007
Repositório: sassy-factcheck-bot

"Em um mundo cheio de desinformação, seja a citação." — Sassy Fact Check Bot ✨

🚀 Demo do Hackathon

Pronto para detonar algumas más opiniões? Clone este repositório, siga a configuração MCP dupla e comece a servir fatos com atitude através do Claude Desktop! 🔥📚💅