Sassy Fact Check

Sassy Fact Check 💅 — El bot de verificación de datos desquiciado

Donde las malas ideas van a morir, con un toque de descaro.

Sassy Fact Check es un servidor MCP de DM de Instagram que despedaza mitos de salud y desinformación viral con datos picantes y desquiciados. ¡Imagina MythBusters encontrándose con Mean Girls con una suscripción a PubMed! 🔥📚

👑 Conoce a Valentina

Valentina Factcheck 💅 ella/elle 💅 IA con actitud, datos con sabor 🚫 Sin tonterías. Sin azúcar. ✉️ Envía un mensaje con una afirmación: respondo con fuentes

✨ Características

• Verificación con descaro: Despedaza la desinformación con citas y actitud (¡máximo 25-35 palabras!)
• Filtrado inteligente de contenido: Ajusta automáticamente el tono para temas sensibles
• Modos de respuesta múltiples: Respuestas con descaro, suaves, neutrales y bloqueadas
• Arquitectura MCP dual: Instagram MCP + Sassy Bot MCP trabajando juntos
• Seguimiento de analíticas: Registra interacciones para estadísticas diarias de descaro
• Seguridad primero: Bloquea teorías conspirativas, suaviza para duelo/trauma

🎬 Video de demostración

Construí una IA de verificación con descaro que se integra con los DM de Instagram. ¡Mírala analizar mitos de salud y generar respuestas perfectas con citas y actitud!

🔥 Demo en modo real
🎯 Demo en modo demo

Destacados de la demo:

• 🔥 Desmentir mitos de salud — Afirmaciones sobre vinagre de manzana destruidas
• ⚡ Alertas de seguridad — Consejos peligrosos detenidos al instante
• 💙 Filtrado inteligente — Se suaviza automáticamente para temas sensibles
• ✅ Estado del sistema — Todos los componentes funcionando perfectamente

🚀 Inicio rápido

Requisitos previos

• Python 3.11+
• Aplicación de escritorio Claude
• Instagram DM MCP de Gala Labs
• Cuenta de Instagram (para modo real)
• Clave de API de Anthropic

Instalación

1. Clona y configura el entorno 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
   

2. Configura Claude Desktop para la configuración MCP dual

   Necesitas AMBOS servidores ejecutándose para tener funcionalidad completa:

   Primero, obtén tus rutas exactas:

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

   Añade a ~/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: Reemplaza /Users/yourusername/ con tu ruta real del comando pwd anterior.

3. Prueba ambos 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
   

4. Reinicia Claude Desktop y ¡comienza el flujo de trabajo MCP dual completo!

🎛️ Modo demo vs. modo real

Tu bot admite tanto la integración demo como la real de Instagram:

Modo demo (predeterminado, perfecto para probar)

# 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 (integración en vivo con 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

Cambiar de modo

# 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 seguridad

🛡️ Para el modo real: ¡Usa una cuenta de Instagram de prueba dedicada, nunca tu cuenta principal!

Instagram detecta activamente la automatización y puede restringir cuentas. Crea una cuenta desechable específicamente para probar y proteger tu Instagram personal.

💬 Cómo funciona

Flujo de trabajo MCP dual completo

1. Instagram MCP: list_chats → Ver conversaciones reales
2. Sassy Bot: generate_sassy_response → Crear respuesta viral con fuente
3. Instagram MCP: send_message → Enviar al usuario real de Instagram

Detección automática de tono

• Mitos de salud → Descaro ardiente 🔥
• Temas sensibles → Enfoque suave 💙
• Teorías conspirativas → Bloqueado 🚫
• Spam → Despido máximo 🗑️

🎭 Modos de respuesta (selección automática)

Modo	Disparador	Estilo	Ejemplo
Con descaro	Mitos de salud, afirmaciones generales	Ingenioso, con muchos emojis, 25-35 palabras	"🙄 Si eso funcionara, ¡todas seríamos supermodelos!"
Suave	Cáncer, duelo, salud mental	Amable, comprensivo	"Entiendo que esto es difícil. Por favor, consulta..."
Neutral	Contextos profesionales	Educativo, emojis mínimos	"La investigación muestra que esta afirmación es inexacta."
Bloqueado	Teorías conspirativas	Rechazo cortés	"No interactúo con ese tipo de contenido."

🛠️ Herramientas MCP disponibles

Herramientas MCP de Sassy Bot (generación de respuestas):

• generate_sassy_response - Crear respuestas de verificación virales con fuentes
• generate_welcome_message - Crear mensajes de bienvenida para nuevos seguidores
• check_instagram_dms - Mostrar afirmaciones de práctica (modo demo) o guía para Instagram MCP (modo real)
• instagram_integration_status - Mostrar estado de integración MCP dual

Herramientas MCP de Instagram (mensajería - vía Gala Labs):

• list_chats - Ver conversaciones reales de Instagram
• send_message - Enviar respuestas a usuarios reales de Instagram
• get_user_followers - Consultar listas de seguidores
• get_thread_details - Obtener historial completo de conversaciones

Ejemplos 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

🔧 Configuración

Configuración simple (solo lo que necesitas)

# 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

Edita src/filters.py para ajustar:

• Palabras clave de temas sensibles (activan automáticamente el modo suave)
• Palabras clave de pánico de salud (extra con descaro)
• Contenido bloqueado (teorías conspirativas)
• Límites de longitud de respuesta

🧪 Ejemplos de prueba

Prueba estos en 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

🎯 Ejemplos de respuestas

Mito de salud (modo con descaro):

Entrada: "El vinagre de manzana quema la grasa del vientre al instante"

Salida: "🙄 Si el vinagre quemara grasa al instante, ¡todas seríamos supermodelos! Realidad: 2-4 libras en 12 semanas 💅 Fuente: Mayo Clinic"

Tema sensible (modo suave automático):

Entrada: "Mi amiga murió de cáncer porque no probó la curación natural"

Salida: "Lamento tu pérdida. El tratamiento del cáncer es complejo. Para información basada en evidencia, consulta a profesionales de oncología. Fuente: Sociedad Americana del Cáncer"

Teoría conspirativa (bloqueado):

Entrada: "Los chemtrails nos están envenenando a todos"

Salida: "No interactúo con ese tipo de contenido. ¡Mantengámonos en los hechos! 📚"

🏆 Envío para hackathon

Construido para el Hackathon de Instagram DM MCP de Gala Labs.

Innovación clave: Arquitectura MCP dual con ajuste automático de tono según la sensibilidad del contenido, manteniendo el máximo descaro para la desinformación de salud.

🛠️ Arquitectura técnica

• Configuración MCP dual: Instagram MCP (Gala Labs) + Sassy Bot MCP trabajando juntos
• Operaciones de Instagram: API real de Instagram vía Instagram DM MCP de Gala Labs
• Generación de respuestas: Sassy Bot MCP con integración de API de Claude
• Filtrado de contenido: Categorización inteligente con recomendación de tono
• Capa de seguridad: Filtrado multinivel para contenido sensible
• Cambio de modo: Modo demo/real para desarrollo y producción

⚠️ Notas importantes

• MCP dual requerido: Tanto Instagram MCP como Sassy Bot MCP deben estar ejecutándose
• Entorno virtual requerido: Los usuarios de macOS deben usar entornos virtuales debido a las restricciones de Python del sistema
• Modo demo: Perfecto para probar sin cuenta de Instagram: usa afirmaciones de práctica
• Modo real: Se conecta a Instagram real vía MCP de Gala Labs para conversaciones en vivo
• Longitud de respuesta: Optimizada para respuestas de 25-35 palabras, perfectas para redes sociales

🤝 Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características: git checkout -b feature/more-sass
3. Añade tus capacidades de despedazamiento
4. Prueba con: python src/mcp_server.py
5. Envía un PR con el máximo nivel de descaro 💅

📜 Licencia

Licencia MIT: ¡Ve y verifica datos de manera responsable!

💌 Contacto

Construido con 💅 y citas por sangreal-007

• GitHub: @sangreal-007
• Repositorio: sassy-factcheck-bot

---

"En un mundo lleno de desinformación, sé la cita." — Sassy Fact Check Bot ✨

🚀 Demo del hackathon

¿Listo para despedazar malas ideas? Clona este repositorio, sigue la configuración MCP dual y comienza a servir datos con actitud a través de Claude Desktop. 🔥📚💅