Venezuela Fakenews

Monorepo para combatir desinformación sobre Venezuela, enfocado en el sismo de junio 2026. Incluye un portal web de verificación de claims (Verdadero/Falso/Dudoso), un chatbot temático, y un servidor MCP para asistentes de IA.

Key Features

• Portal de verificación — Ingresá un claim, obtené veredicto con nivel de confianza, explicación, patrones detectados y fuentes oficiales
• Chatbot del sismo — Respondé preguntas sobre daños, víctimas, ayuda humanitaria y desinformación detectada
• 6+ patrones de desinformación implementados y detectables (videos descontextualizados, contenido IA, usurpación de canales, falsos anuncios, operaciones YouTube, desinformación salarial)
• Servidor MCP para que asistentes de IA consuman la misma base de conocimiento
• Búsqueda Tavily opcional — consultas en tiempo real a fuentes confiables
• Historial de verificaciones persistido en SQLite

Tech Stack

Capa	Tecnología
Frontend	Astro o Next.js (decisión pendiente)
Backend	Hono + Bun
ORM	Drizzle
Base datos	SQLite
API	oRPC (type-safe)
Búsqueda	Tavily Search API
Validación	Zod
Monorepo	Bun workspaces
MCP Server	@modelcontextprotocol/sdk + TypeScript

Architecture

venezuela-fakenew/
├── apps/
│   ├── frontend/         ← Portal web (Astro o Next.js)
│   └── backend/          ← API Hono + oRPC + Drizzle
├── packages/
│   ├── core/             ← Lógica compartida (PATTERNS, verify, key facts)
│   └── mcp-server/       ← Servidor MCP para asistentes IA
└── docs/                 ← Notas e investigación

El backend expone procedures oRPC (verifyClaim, getPatterns, chat, searchSources, getKeyFacts) que consume el frontend y potencialmente el MCP.

Equipo

Nombre	Rol	Contacto
Michel Novellino	Frontend (Diseño)	[email protected]
Carlos Gallardo	Frontend	[email protected]
Stephan Calderín	Backend + Deployment	[email protected]
Blure	Backend + BD	[email protected]
José Alejandro Castro	Coordinación + MCP/Core	[email protected]

Project Status

Fase 1 — Definición y Diseño (27 de junio 2026). Decisiones pendientes:

• Stack frontend (Astro vs Next.js)
• Integración LLM (Tavily + reglas vs LLM real)
• Plataforma de deploy
• Nombre del producto

---

Servidor MCP (packages/mcp-server)

El servidor MCP se ejecuta como subproceso del host (opencode, Claude Desktop, etc.) vía STDIO.

Prerequisites

• Node.js 18+ (20+ recomendado)
• (Opcional) API key de Tavily

Getting Started

bun install
bun run build
bun run inspect   # Probar con inspector MCP

Herramientas expuestas

Tool	Input	Output
get_fakenews_patterns	Ninguno	Lista de 6 patrones con ejemplos y detección
verify_claim	claim, context?	Análisis + patrones coincidentes + búsqueda web
search_official_sources	topic, max_results?	Fuentes confiables (USGS, IOM, Reuters, etc.)
generate_factcheck_report	topic	Reporte estructurado con datos del cuaderno

Configuración en OpenCode

{
  "mcpServers": {
    "venezuela-fakenews": {
      "command": "node",
      "args": ["<path>/packages/mcp-server/dist/index.js"]
    }
  }
}

Variables de entorno

Cada paquete trae su archivo de ejemplo — cópialo y rellená los valores.

Paquete	Archivo ejemplo	Copiar a
apps/backend	.dev.vars.example	.dev.vars (local) · wrangler secret put (prod)
apps/frontend	.env.example	.env
packages/mcp-server	.env.example	.env

Backend (apps/backend)

En local viven en .dev.vars; en producción se setean como secrets del Worker (bunx wrangler secret put <NOMBRE>). Nunca los pongas en [vars] de wrangler.toml — se escriben en texto plano y pisan el secret.

Variable	Requerida	Descripción
TURSO_DATABASE_URL	Sí	URL de la base libSQL/Turso (libsql://...).
TURSO_AUTH_TOKEN	Sí	Token de auth de Turso.
LLM_API_KEY	Sí	Key del LLM. Una sk-ant-… enruta al proveedor nativo de Anthropic; cualquier otra usa el endpoint OpenAI-compatible.
LLM_MODEL	No	Modelo a usar. Default: claude-haiku-4-5-20251001 (Anthropic) o gpt-4o-mini (OpenAI-compat).
LLM_BASE_URL	No	Base URL OpenAI-compatible (Groq, HuggingFace…). Omitir para Anthropic/OpenAI.
TAVILY_API_KEY	Sí	Key de Tavily para búsqueda en tiempo real.
CORS_ORIGIN	Sí (prod)	Orígenes exactos permitidos, separados por coma. Si esto y CORS_ORIGIN_PATTERN quedan vacíos, CORS abre a * (fail-open) — fijalo antes de producción.
CORS_ORIGIN_PATTERN	No	Regex anclado para orígenes dinámicos (p. ej. cualquier puerto de localhost en dev).

Frontend (apps/frontend)

Astro: solo las variables con prefijo PUBLIC_ llegan al cliente.

Variable	Requerida	Descripción
PUBLIC_API_URL	Sí	URL base del backend; el cliente le añade /rpc. Default: http://localhost:8787.
PUBLIC_MOCK_API	No	false usa el backend real; cualquier otro valor (o ausente) sirve datos mock.

MCP server (packages/mcp-server)

Variable	Requerida	Descripción
TAVILY_API_KEY	No	Sin ella, verify_claim y search_official_sources usan solo el conocimiento base (sin búsqueda web).

License

MIT