MejorCrucero.com
Comparador de cruceros en español. Web estática sin dependencias (Node 22) en GitHub Pages, con una API pequeña opcional en Cloudflare Workers + D1 para la comunidad. Nada de Lovable.
Qué hay
- 343 fichas de barco (Wikipedia), 255 vídeos reales de YouTube, fotos con licencia de Wikimedia Commons (
tools/photos.py).
- Buscador por destino/mes/puerto/noches; motor de salidas, ofertas, última hora, histórico y calendario (se activa con el feed, ver
docs/feed.md).
- Navieras con tabla comparativa, 10 comparativas "X vs Y", 8 destinos, 12 meses, 16 puertos, rankings, excursiones.
- 12 herramientas: precio real (2 ofertas, cambio BCE, tarjeta para compartir), alerta de bajada + lectura del email de reserva + email de reclamación, test, asistente IA, comparadores, checklist, cuenta atrás con .ics, mareómetro, conversor horario, buscador de camarotes.
- Comunidad sin registro: opiniones con notas por categoría, preguntas, camarotes con vídeo, grupos por salida con contador, excursiones compartidas, perfiles con insignias, ranking, resumen IA de opiniones.
- Favoritos, vistos, comparador flotante, modo oscuro, PWA sin conexión, OG por barco, A/B y medición de clics sin cookies.
Editar
| Qué | Dónde |
|---|
| Barcos | src/data/ships.csv, src/data/ships_extra.csv |
| Navieras, puertos, afiliados, API, A/B | src/data/content.js |
| Destinos, meses, comparativas | src/data/destinations.js |
| Guías | src/data/guides.js |
| Plantillas | src/build.js, src/lib.js |
| Estilos / JS | public/assets/ |
| API | backend/worker.js, backend/schema.sql |
Build local: BASE=/mejorcrucero/ node src/build.js. Con salidas de prueba: SAILINGS=test/sailings.fixture.json … (nunca se publican).
Regenerar fotos: python3 tools/photos.py. Imágenes para compartir: python3 tools/og.py.
Pendiente de activar
- Dominio: DNS de mejorcrucero.com → A 185.199.108.153/.109/.110/.111 y
www CNAME calory89.github.io; variables de repo BASE=/ y CNAME=mejorcrucero.com.
- API: secretos
CLOUDFLARE_API_TOKEN y CLOUDFLARE_ACCOUNT_ID + variable DEPLOY_API=true (o desplegar desde el conector). Después, poner la URL del Worker en CONFIG.api.
- Afiliados:
CONFIG.affiliates.*.param.
- Feed de precios: variable
FEED_URL (ver docs/feed.md).
- Emails salientes (alertas, newsletter): proveedor de envío (Resend u otro) conectado al Worker.
MejorCrucero Score (nota 0–100)
- Fórmula en
src/score.js, explicada en /metodologia/. Datos:
src/data/vsp.json: inspecciones sanitarias del CDC (Vessel Sanitation Program). Solo cuentan si la última es de los últimos 4 años.src/data/ships_specs.csv: pasajeros, tripulación, eslora, cubiertas, reformas y nombres anteriores (Wikipedia, artículo de cada barco).- Opiniones de la comunidad: el build llama a
GET /ratings de la API (solo cuenta con 5 opiniones o más).
- Sin al menos espacio por pasajero + otros dos indicadores, el barco queda "sin nota".
- Imágenes para compartir con la nota:
node src/build.js && python3 tools/og.py (genera public/og/*.png).
- Fotos servidas en local desde
public/img/barcos/*.webp (sin cookies de terceros); el crédito enlaza a Wikimedia Commons.
API (Cloudflare Worker mejorcrucero-api)
- URL: https://mejorcrucero-api.mejorcrucero.workers.dev · base de datos D1
mejorcrucero.
- Migraciones en
backend/migrations/ (aplicar una vez con wrangler d1 execute mejorcrucero --remote --file ...).
- Panel interno:
/admin/ (pide la clave ADMIN_TOKEN).
