---
name: crear-alerta-subastech
description: Cómo crear y auditar una alerta de nuevas subastas (provincia, municipio, tipo, precio) con criterios válidos, evitando errores frecuentes.
---
# Crear una alerta de subastas en Subastech

Las alertas avisan (correo, push y, en Team o superior, Telegram/webhook) cuando aparece una subasta que cumple los criterios. Requieren cuenta; el plan Radar gratuito permite hasta 50 alertas activas.

## Criterios válidos

- `provinceSlugs`: slugs de https://app.subastech.com/v1/provincias (p. ej. `madrid`, `valencia-valencia`).
- `municipalityKeys`: claves `"{provinceSlug}:{municipalitySlug}"` de `/v1/provincias/{prov}/municipios`.
- `propertyTypes`: nombres EXACTOS de https://app.subastech.com/v1/tipos (singular, p. ej. `Vivienda`; nunca `casas`).
- `minPrice` / `maxPrice` (euros), `minArea` / `maxArea` (m²).
- `keywords`: máximo 10; filtran por dirección, municipio o tipo. Una palabra clave NO acota la zona: no pongas aquí topónimos ni tipos de inmueble.
- Avanzados (plan Pro o superior): `discountMinPct`, `scoreMin`. Si el plan no los permite se ignoran y la respuesta lo indica en `ajustes`. `roiMin` no está soportado.

## Errores frecuentes (y cómo evitarlos)

1. Alerta sin criterios → coincide con todo el catálogo. Pon al menos provincia, municipio o tipo.
2. Topónimo en `keywords` ("Getafe") → usa `municipalityKeys`.
3. Tipo inventado ("casa", "piso") → nunca dispara. Consulta `/v1/tipos`.
4. Rango de precio imposible (`minPrice` > `maxPrice`) → la previsualización lo avisa.

## Con MCP

1. `alertas_previsualizar` (sin efectos secundarios): devuelve cuántas subastas coinciden ahora, `avisos` de auditoría con un `fix` aplicable, `ajustes` (criterios ignorados por el plan) y una `muestra`. Úsala siempre antes de crear.
2. `alertas_crear`: crea la alerta con los criterios ya validados; el usuario recibe un correo de confirmación.
3. `alertas_listar`, `alertas_editar`, `alertas_activar` (activar o pausar) y `alertas_eliminar` para gestionarlas.

Si una herramienta responde con un objeto `locked`, la función requiere un plan superior: enlaza su `upgradeUrl`. Sin MCP, las alertas se gestionan en https://app.subastech.com/alertas