🎣 Pesca Huelva — Sistema de recomendaciones con AgentCrew

Sistema multi-agente construido con AgentCrew que analiza las condiciones meteorológicas y marinas de la costa de Huelva para recomendar dónde, cómo y a qué pescar cada día.

¿Qué hace?

Cada mañana a las 06:00 el sistema genera automáticamente un informe como este:

🎣 Pesca Huelva — Sábado 25 abril 2026
──────────────────────────────
💨 8 km/h Poniente · 🌊 0.4m · 🌡️ 16°C mar
🌊 Marea: Entrante (coef. 72) · 👁️ Visibilidad: 4m

🦶 PIE — 🟢 Bueno
🎣 Spinning → 🐟 Chopa → Espigón de Huelva · 75/100 · ⏰ 06:30-09:30
🏄 Surfcasting → 🐡 Corvina → Mazagón playa · 76/100 · ⏰ 11:37-17:00

🤿 PATO — 🟡 Precaución
🪨 Rockfishing → 🐠 Sargo → El Portil zona rocosa · 72/100 · ⏰ 18:00-20:00

🛶 KAYAK — 🟢 Bueno
🦑 Egging → 🦑 Choco → El Portil laguna · 87/100 · ⏰ 06:00-11:00

🚤 BARCO — 🟢 Bueno
🎏 Curricán/Egging → 🦑 Choco → Puente del Odiel · 90/100 · ⏰ 06:00-11:30
⚓ Jigging → 🐡 Corvina → Canal del Odiel · 79/100 · ⏰ 11:37-17:00

🦑 Similitud con día del choco (2 abr 2026): 71/100
💡 Consejo: Sal antes de las 07:00 — la ventana del choco con marea entrante es el momento estrella.

Arquitectura

El sistema tiene 5 agentes organizados en un equipo AgentCrew:

coordinador (Leader)
├── agente-meteo        → IHM + AEMET + Open-Meteo
├── agente-acceso       → Seguridad pie/pato/kayak/barco
├── agente-especies     → Puntuación 0-100 por especie
└── agente-combinaciones → Ranking acceso × técnica × zona

Accesos soportados

Acceso	Límites de seguridad
🦶 Pie	Olas ≤3.5m
🤿 Pato	Olas ≤0.4m · Agua ≥17°C · Marea entrante/llena
🛶 Kayak	Viento ≤15 km/h · Olas ≤0.5m (límite legal)
🚤 Barco	Viento ≤30 km/h · Olas ≤1.5m

Técnicas soportadas

Surfcasting · Spinning · Egging · Rockfishing · Al vivo · Jigging · Curricán

Especies objetivo

Choco · Lubina · Dorada · Corvina · Chopa · Sargo · Urta · Mero

Fuentes de datos meteorológicos

• Mareas: IHM — 5 estaciones en la costa de Huelva (ids: 32, 33, 34, 35, 36)
• Predicción costera: AEMET OpenData (boletín and1 — aguas de Huelva)
• Temperatura del mar y oleaje: Open-Meteo Marine API

Estructura del repositorio

agentcrew-pesca/
├── .claude/
│   ├── CLAUDE.md                    # Instrucciones del coordinador (Leader)
│   └── agents/
│       ├── agente-meteo.md          # Meteorólogo marino
│       ├── agente-acceso.md         # Evaluador de seguridad
│       ├── agente-especies.md       # Analista de especies
│       └── agente-combinaciones.md  # Generador de recomendaciones
├── data/
│   └── perfiles_pesca.json          # Base de conocimiento
├── Dockerfile
├── .env.example
└── README.md

Instalación

Prerequisitos

• AgentCrew instalado y funcionando
• Docker
• API key de AEMET OpenData (gratuita)

1. Obtener la API key de AEMET

El sistema usa AEMET OpenData para la predicción marítima costera y la predicción horaria del municipio de Huelva. El registro es gratuito:

1. Ve a opendata.aemet.es
2. Rellena el formulario con tu email
3. Recibirás la API key por correo en unos minutos

2. Clonar y configurar

git clone https://github.com/helmcode/agentcrew-pesca
cd agentcrew-pesca

cp .env.example .env

Edita .env y añade tu clave:

export AEMET_API_KEY=aquí_tu_clave_de_aemet

Nota: AEMET funciona en dos pasos — la primera llamada devuelve una URL en el campo datos, y hay que hacer una segunda llamada a esa URL para obtener los datos reales. El agente-meteo ya está configurado para hacer las dos llamadas correctamente.

2. Construir la imagen Docker

El Dockerfile usa @anthropic-ai/claude-code@2.1.90 fijado a esa versión de forma intencionada. Las versiones 2.1.92+ bloquean --dangerously-skip-permissions cuando el proceso corre como root, lo que hace que el agente arranque, ejecute durante 30 segundos y se apague en silencio con exit code 0 sin producir ningún output. Si tienes el binario sidecar-amd64 de AgentCrew, cópialo al directorio antes de construir:

# Coloca el binario sidecar en el directorio
cp /ruta/al/sidecar-amd64 .

# Construye y publica en tu registro
docker build -t tu-registro/agentcrew-pesca:latest .
docker push tu-registro/agentcrew-pesca:latest

3. Preparar el workspace

mkdir -p ~/.agentcrew/teams/agentcrew-pesca/data

cp -r .claude ~/.agentcrew/teams/agentcrew-pesca/
cp data/perfiles_pesca.json ~/.agentcrew/teams/agentcrew-pesca/data/
cp .env ~/.agentcrew/teams/agentcrew-pesca/

4. Crear el equipo en AgentCrew

En la UI de AgentCrew → New Team:

• Nombre: agentcrew-pesca
• Descripción: Sistema multi-agente para recomendaciones de pesca en la costa de Huelva
• Workspace path: /home/tu-usuario/.agentcrew/teams/agentcrew-pesca
• Agent image: tu-registro/agentcrew-pesca:latest

Configura el Leader con el contenido de .claude/CLAUDE.md y añade 4 workers con los archivos de .claude/agents/:

Worker	Archivo
agente-meteo	.claude/agents/agente-meteo.md
agente-acceso	.claude/agents/agente-acceso.md
agente-especies	.claude/agents/agente-especies.md
agente-combinaciones	.claude/agents/agente-combinaciones.md

5. Verificar que funciona

Haz clic en Deploy. Cuando el estado sea running, abre el chat del equipo y escribe:

Genera el informe de pesca de hoy para Huelva.

6. Configurar el schedule diario

Sidebar → Schedules → New Schedule:

Nombre:      Informe diario de pesca Huelva
Equipo:      agentcrew-pesca
Prompt:      Genera el informe de pesca de hoy para Huelva.
             Analiza todos los accesos y técnicas disponibles.
             Prioriza las combinaciones con puntuación superior a 70.
Frecuencia:  Todos los días a las 06:00
Zona horaria: Europe/Madrid

Referencia del día del choco

El sistema usa el 2 de abril de 2026 como referencia de calibración — ese día se realizó una buena pesca de chocos en barco frente a la bocana de la ría de Punta Umbría a 14m de profundidad. Las condiciones de ese día (viento 8 km/h Poniente, olas 0.4m, T° mar 16.2°C, marea entrante) son el baseline del sistema para el choco.

Cada informe incluye un índice de similitud con ese día (0-100).

Feedback y aprendizaje

Después de cada salida puedes registrar el resultado directamente en el chat del equipo:

Hoy salí en barco con curricán frente a la bocana de Punta Umbría.
Cogimos 8 chocos en 3 horas. Marea entrante, viento flojo del Poniente.

El sistema registra el resultado y lo usa para ajustar los perfiles de especie.

Zonas cubiertas

La costa de Huelva de este a oeste:

• Matalascañas · El Asperillo · Mazagón · Punta del Sebo
• Puerto de Huelva · Espigón de Huelva · Dique de Levante
• Bocana Punta Umbría · El Portil · El Rompido
• Isla Cristina · Isla Canela · Ayamonte

Zonas offshore:

• Canal del Odiel · Estuario Río Tinto/Odiel · Puente del Odiel
• Arrecifes de Mazagón · Bajo del Caballo · Isla de Bacuta

Contribuir

Si pescas en Huelva y quieres mejorar el sistema:

• Añade zonas que falten en data/perfiles_pesca.json
• Corrige perfiles de especies según tu experiencia
• Abre un issue con condiciones que el sistema no esté valorando bien

Construido con

• AgentCrew — plataforma de orquestación multi-agente
• Claude — modelo de lenguaje
• AEMET OpenData — predicción meteorológica oficial
• IHM — mareas oficiales (Armada Española)
• Open-Meteo — temperatura del mar y oleaje