# Demo 1 — Scraper ético de datos públicos → CSV

Descarga una **tabla pública de Wikipedia** y la exporta a un archivo **CSV**
listo para abrir en Excel o cualquier hoja de cálculo.

Como ejemplo usa la lista de países por población (Naciones Unidas). El código
es **genérico**: cambia la variable `URL` por cualquier página con una tabla y
funcionará igual. Incluye un `sample_output.csv` con el resultado de ejemplo.

---

## Qué hace (en simple)

1. Descarga la página con un *User-Agent* honesto (Wikipedia lo pide).
2. Localiza la primera tabla (`table.wikitable`) y lee todas sus filas.
3. Las guarda en `reporte.csv` (UTF-8, compatible con Excel).
4. Si en ese momento no hay internet, usa un **conjunto de ejemplo incluido**
   para que la demo **siempre** genere un CSV verificable (igual a
   `sample_output.csv`).

Wikipedia publica su contenido bajo licencia libre, por lo que este uso es
legal. Antes de aplicar scraping a otros sitios se revisan sus Términos y su
`robots.txt`.

---

## Cómo usarlo en 3 pasos

1. **Instalar dependencias** (una sola vez):
   ```
   pip install -r requirements.txt
   ```
2. **Ejecutar**:
   ```
   python scraper.py
   ```
3. **Abrir** `reporte.csv` en Excel o Google Sheets.

*(Requiere Python 3.8 o superior. Ver `sample_output.csv` para el formato de salida.)*

---

## Qué le resuelvo a tu negocio 🇪🇸
¿Copias datos de páginas web a mano para tus listas, tu competencia o tus
reportes? Eso te roba horas y se llena de errores. Yo automatizo esa
recolección: le digo al programa qué datos quieres y de dónde, y en segundos
tienes un archivo limpio y actualizado, sin copiar y pegar.

## What I solve for your business 🇬🇧
Are you copying data from websites by hand for your lists, competitor research,
or reports? That wastes hours and is full of mistakes. I automate that
collection: I tell the program what data you need and where, and in seconds you
get a clean, up-to-date file, with no copy-and-paste.

---

## Para ejecutar · To run

**Español (3 pasos):**
1. `pip install -r requirements.txt`
2. `python scraper.py`
3. Abre `reporte.csv` en Excel o Google Sheets.

**English (3 steps):**
1. `pip install -r requirements.txt`
2. `python scraper.py`
3. Open `reporte.csv` in Excel or Google Sheets.

---

## Archivos
| Archivo | Para qué sirve |
|---|---|
| `scraper.py` | El programa que descarga la tabla y genera el CSV. |
| `requirements.txt` | Librerías necesarias (`pip install -r`). |
| `sample_output.csv` | Ejemplo del resultado (para ver el formato sin ejecutar). |
| `reporte.csv` | Se genera al ejecutar el script. |
| `ui_shots/` | Capturas de evidencia. |