🚦 Border Wait Times Scraper

Este proyecto recopila y procesa los tiempos de espera en las principales garitas de Tijuana, Mexicali y Tecate, obteniendo información cada 10 minutos mediante GitHub Actions desde Bordify y mostrándolos en un sitio web con JavaScript.

📌 Descripción

Este sistema cuenta con scrapers en Python que extraen los tiempos de espera de cada garita, detectan el estado del tráfico mediante colores (rojo, amarillo, verde) y clasifican los cruces como vehiculares o peatonales. La información se almacena en archivos JSON y se actualiza cada 10 minutos automáticamente.

Un script en JavaScript consume estos datos para mostrarlos dinámicamente en un sitio web.

🚀 Funcionalidad

• Extrae datos cada 10 minutos desde Bordify.
• Identifica tiempos de espera para diferentes tipos de carriles (General, Sentri, ReadyLane).
• Detecta el estado del tráfico mediante colores (rojo, amarillo, verde).
• Clasifica cada cruce como vehicular o peatonal.
• Extrae el icono correspondiente (auto o peatón).
• Guarda los datos en archivos JSON.
• Publica la información en un sitio web dinámico usando JavaScript.

🛠 Instalación y Configuración

1. Clonar el repositorio:

   git clone https://github.com/tu_usuario/border-wait-times.git
   cd border-wait-times

2. Instalar dependencias:

   pip install -r requirements.txt

3. Ejecutar los scrapers manualmente:

   python3 scraper-tijuana.py
   python3 scraper-mexicali.py
   python3 scraper-tecate.py

4. Ejecutar el script en JavaScript localmente:

   node scraper.js

5. Ver los datos generados en JSON:

   cat wait-times-tijuana.json

🖮 Ejemplo de Salida JSON

{
    "Garita Otay Mesa": [
        {
            "tipo": "General",
            "tiempo": "2:24 horas",
            "líneas_abiertas": "2 líneas abiertas",
            "color": "red",
            "icono": "vehicular"
        },
        {
            "tipo": "Sentri",
            "tiempo": "18 minutos",
            "líneas_abiertas": "3 líneas abiertas",
            "color": "green",
            "icono": "vehicular"
        }
    ],
    "Ultima_actualizacion": "2025-03-20 14:43"
}

🌐 Funcionamiento del Script en JavaScript

El script scraper.js obtiene los datos desde los archivos JSON y los muestra en un sitio web. Si se usa con Webflow, se puede incrustar el archivo webflow script.js.

Ejemplo de ejecución manual:

node scraper.js

🔄 Automatización con GitHub Actions

El script scraper.yml ejecuta los scrapers cada 10 minutos de forma automática y actualiza los archivos JSON en el repositorio.

on:
  schedule:
    - cron: '*/10 * * * *'  # Ejecuta cada 10 minutos
  workflow_dispatch: {}  # Permite ejecución manual

🔍 Tecnologías Utilizadas

• Python 🐍
• JavaScript (Node.js) 📝
• Selenium 🌐
• Puppeteer 🤖
• WebDriver Manager 🚗
• YAML 📝
• JSON 📊
• GitHub Actions 🔄

🛠 Mantenimiento y Errores

Si encuentras errores, verifica lo siguiente:

• El sitio Bordify está activo y su estructura HTML no ha cambiado.
• El WebDriver está actualizado:

  pip install -U webdriver-manager

• Las dependencias están instaladas correctamente.
• Para el script en JavaScript, asegúrate de tener Node.js instalado:

  node -v

📩 Contacto

Si tienes preguntas o mejoras, contáctanos en tu_email@example.com.

📌 Desarrollado por: MadMath Creative Studio 🚀