skill-cochessubasta

Pipeline completo para convertir una subasta de coche del BOE en un post de carrusel de Instagram con funnel de mensajes directos. Pensado como skill autónoma para Claude Code, pero los scripts funcionan por sí solos desde la terminal.

Perfil de destino de ejemplo: Instagram @subasta.motor.

⚠️ Aviso legal / privacidad. Es una herramienta para difundir subastas públicas del BOE, no para vender coches. Difumina SIEMPRE las matrículas (propias y de terceros) antes de publicar, mantén el disclaimer del caption y cita la fuente. Los datos textuales del BOE son reutilizables (Ley 37/2007) sin alterarlos. Las carpetas con fotos y datos extraídos (boe_*/) no se suben al repo (ver .gitignore): contienen matrículas reales y datos personales.

---

Cómo funciona (5 fases)

BOE (búsqueda pública)
  → 0. boe_search.py      candidatos en subasta (sin login)     → tabla con idSub + precios
BOE (idSub)
  → 1. boe_extract.py     fotos reales + datos + pliego         → carpeta con foto_*.jpg + data.json
  → 2. make_carousel.py   carrusel IG (Nano Banana)             → carrusel/slide_*.png
  → 3. Upload-Post (MCP)  publica el carrusel en Instagram      → post_url
  → 4. manage_autodms     comentar "subasta" → DM con link BOE  → monitor_id

Cada script es independiente y solo necesita httpx (y PyMuPDF opcional para leer el pliego PDF).

---

Requisitos

• Python 3.9+ con httpx (pip install httpx). Opcional: PyMuPDF para el texto del pliego.
• Clave de Gemini (GEMINI_API_KEY) para generar el carrusel con Nano Banana (fase 2).
• Servidor MCP de Upload-Post conectado en Claude Code, con un perfil que tenga Instagram vinculado (fases 3-4). Cuenta de Upload-Post: https://upload-post.com
• Para las fotos de las subastas (fase 1): una sesión iniciada en subastas.boe.es (Cl@ve / certificado) desde la que obtener la cookie SESSID.

---

Configuración

1. Variables de entorno (.env)

Copia .env.example a .env y rellena tu clave. El .env no se sube al repo (.gitignore).

cp .env.example .env
# edita .env y pon tu clave:
# GEMINI_API_KEY=AI...tu_clave...

make_carousel.py busca la clave en este orden: variable de entorno GEMINI_API_KEY → fichero .env del proyecto (subiendo carpetas).

2. La parte del BOE (búsqueda y extracción)

Búsqueda (fase 0) — pública, sin login ni base de datos. Usa la búsqueda avanzada del portal de subastas (BIEN.TIPO=V, subtipo turismos) y el detalle público de cada subasta:

python3 scripts/boe_search.py --sort precio
python3 scripts/boe_search.py --sort precio --max-precio 8000 --provincia 28
python3 scripts/boe_search.py --subtipo industriales --estado PU --json

Devuelve una tabla con idSub, vehículo, valor de subasta, puja mínima y fecha de conclusión. Copia el idSub del coche elegido para la fase 1.