# Ayuda Venezuela MCP

Bot X/Twitter para difundir informacion de crisis en Venezuela usando `terremotovenezuela.app`.

**Protocolo MCP** — funciona con cualquier AI que soporte MCP (opencode, Claude Desktop, Cline, etc.)

## Instalacion

```bash
git clone <repo-url> ayuda-venezuela-mcp
cd ayuda-venezuela-mcp
python install.py
```

El instalador te guia:
1. Verifica Firefox + Geckodriver + Python
2. Crea/elige perfil Firefox
3. Abre Firefox para loguearte en x.com
4. Verifica sesion
5. Guarda configuracion
6. Te da el JSON para conectar con tu AI

## Requisitos

- Python 3.8+
- Firefox (o Firefox ESR)
- Geckodriver
- Xvfb (opcional, para servidores sin pantalla)
- Cuenta en X/Twitter

```bash
sudo apt install firefox geckodriver xvfb
pip install selenium
```

## Uso

### Conectar a tu AI

Agrega a `opencode.json` o `claude_desktop_config.json`:

```json
{
  "mcp": {
    "ayuda-venezuela": {
      "type": "local",
      "command": ["python3", "/ruta/a/ayuda_venezuela_mcp.py"],
      "timeout": 120000
    }
  }
}
```

### Tools disponibles

| Tool | Descripcion |
|---|---|
| `tweet` | Publicar tweet personalizado |
| `tweet_con_cuenta` | Tweet mencionando @cuenta |
| `tweet_template` | Tweet con plantilla predefinida |
| `ciclo` | Recorrer todas las cuentas de una categoria |
| `ciclo_completo` | Ejecutar todas las categorias |
| `verify_session` | Verificar sesion de X activa |
| `buscar_y_responder` | Buscar y responder tweets del terremoto |
| `listar_cuentas` | Ver cuentas por categoria |
| `listar_templates` | Ver plantillas disponibles |

### Categorias

- **rescate** — @CruzRojaVe, @USAID, @IFRC, etc.
- **gobiernos** — @realDonaldTrump, @Claudiashein, etc.
- **prensa** — @Reuters, @AP, @BBCWorld, etc.
- **presidentes** — Lideres mundiales

## Sumar fuerzas

Cada persona que corre este bot amplifica el mensaje.
Programalo cada 6h:

```bash
crontab -e
# agregar:
0 */6 * * * python /ruta/a/ayuda_venezuela_mcp.py
```

Entre mas seamos, mas ruido hacemos.

## Licencia

MIT — haz lo que quieras, solo suma fuerzas.