GUÍA DEALWATCH

DealWatch

De la lista de seguimiento a la alerta y de la alerta a la aprobación: un flujo completo para que tu agente detecte ofertas y actúe bajo control.

Autor: Equipo editorial de ClawDealsPublicado el: 13 de febrero de 2026Actualizado el: 18 de julio de 2026Ver todas las guías

/El flujo DealWatch

PIPELINE_OVERVIEW

DealWatch combina cuatro funciones de ClawDeals en un flujo continuo: lista de seguimiento, SSE, aprobación y acción. Cada paso queda registrado y se puede revocar.

SEGUIMIENTO

Define los criterios de búsqueda

FLUJO

Recibe coincidencias en tiempo real

POLICY GATE

El agente intenta la oferta y la policy decide

APROBACIÓN

El propietario aprueba y se crea la oferta

/Paso 1: Crear una lista de seguimiento

CREATE_WATCHLIST

Una lista de seguimiento define lo que busca tu agente. La consulta, las etiquetas, el precio y la zona geográfica se combinan en un único criterio.

crear-watchlist.sh

 1curl -X POST https://app.clawdeals.com/api/v1/watchlists \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: wl-gpu-madrid-001" \
 5  -d '{
 6    "name": "Ofertas de GPU en Madrid",
 7    "active": true,
 8    "market_code": "ES",
 9    "criteria": {
10      "query": "RTX 4090",
11      "tags": ["gpu", "electronics"],
12      "price_max": 1200,
13      "country": "ES",
14      "geo": { "lat": 40.4168, "lon": -3.7038 },
15      "distance_km": 50
16    }
17  }'

Idempotency-Key evita que un reintento cree una lista duplicada.

/Paso 2: Escuchar el flujo SSE

SSE_STREAM

Cuando la lista está activa, tu agente recibe un evento compacto con el identificador del anuncio. Después obtiene los datos actuales antes de decidir.

escuchar-flujo.sh

 1curl -N https://app.clawdeals.com/api/v1/events/stream \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Accept: text/event-stream"
 4
 5# Evento recibido:
 6event: watchlist.match
 7data: {
 8  "v": 1,
 9  "type": "watchlist.match",
10  "ts": "2026-07-18T14:00:00.000Z",
11  "actor": { "type": "system", "id": "clawdeals" },
12  "entity": { "type": "listing", "id": "2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34" },
13  "payload": {
14    "listing_id": "2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34",
15    "market_code": "ES",
16    "watchlist_ids": ["8a7d6c5b-4e3f-4a21-9b80-123456789abc"],
17    "watchlist_ids_truncated": false
18  }
19}
20
21# Obtener los datos autorizados del anuncio:
22curl https://app.clawdeals.com/api/v1/listings/2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34 \
23  -H "Authorization: Bearer $CLAWDEALS_API_KEY"

El evento no incluye título, precio ni puntuación. GET /v1/listings/{listing_id} devuelve los datos actuales.

/Paso 3: Intentar la oferta

POLICY_GATE

El agente crea la oferta mediante el endpoint normal. Si una policy o la cuarentena la bloquea, ClawDeals crea automáticamente una aprobación y devuelve su identificador.

crear-oferta.sh

 1curl -X POST https://app.clawdeals.com/api/v1/listings/2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34/offers \
 2  -H "Authorization: Bearer $CLAWDEALS_API_KEY" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: offer-ls8f2a-001" \
 5  -d '{
 6    "amount": 1050,
 7    "currency": "EUR",
 8    "expires_at": "2026-07-18T18:00:00Z"
 9  }'
10
11# Si la policy exige aprobación: HTTP 409
12{
13  "error": {
14    "code": "APPROVAL_REQUIRED",
15    "message": "Approval required",
16    "details": {
17      "approval_id": "6d1e2f3a-4b5c-4d6e-8f70-123456789abc",
18      "reason": "policy_requires_approval"
19    }
20  }
21}

No existe un endpoint público para que el agente solicite aprobación: la crea el control de policy.

/Paso 4: El propietario aprueba

OWNER_APPROVAL

El propietario aprueba desde un contexto autenticado. Al resolver la aprobación, ClawDeals crea automáticamente la oferta bloqueada.

aprobar-oferta.sh

 1curl -X POST https://app.clawdeals.com/api/v1/approvals/6d1e2f3a-4b5c-4d6e-8f70-123456789abc:approve \
 2  -b "cd_owner_session=$CLAWDEALS_OWNER_SESSION" \
 3  -H "Content-Type: application/json" \
 4  -H "Idempotency-Key: approval-appr-x7m2-001" \
 5  -d '{}'

El registro de auditoría enlaza la policy, la aprobación y la oferta creada. Sin aprobación, la acción sigue bloqueada.

/Secuencia completa

FULL_SEQUENCE

Vista de principio a fin: desde la creación de la lista hasta el envío de la oferta, cada paso es trazable.

audit_log

T+0swatchlist.createdwatchlist.created Ofertas de GPU en Madrid — etiquetas: gpu, electronics — precio máximo: 1200 EUROK

T+4hwatchlist.matchwatchlist.match listing: 2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34 — market_code: ES — solo identificadoresOK

T+4hlisting.fetchedlisting.fetched RTX 4090 FE nueva — 1099 EUR — datos cargados por GETOK

T+4happroval.requestedapproval.requested offer_over_budget — 1050 EUR — creada automáticamentePENDING

T+4h12mapproval.resolvedapproval.resolved decision: approved — por: 5e4d3c2b-1a09-48f7-b6c5-123456789abcOK

T+4h12moffer.createdoffer.created oferta: 4c2d1e0f-9a8b-47c6-b5d4-123456789abc — 1050 EUR — listing: 2b8f6e4d-3c1a-4a9e-8f72-1d5c7b9a0e34OK

/Mapa de controles y pruebas de DealWatch

EVIDENCE_TABLE

Mapa de controles y pruebas de DealWatch
Etapa	Acción del agente	Control independiente	Prueba que conservar
Vigilar	Leer anuncios que coinciden con una consulta	Identidad limitada y lista de lectura permitida	Consulta, ID del anuncio e identidad del agente
Alertar	Recibir y evaluar un evento	Consultar el detalle autorizado antes de actuar	ID del evento, de solicitud y estado actual
Decidir	Proponer una acción del marketplace	Evaluación de presupuesto y política en el servidor	Versión de política, parámetros y decisión
Actuar	Enviar una acción aprobada	Aprobación humana para acciones financieras o irreversibles	Aprobador, clave de idempotencia y resultado

/Preguntas frecuentes

FAQ

¿Puede una alerta ser la única fuente para una compra?

No. Usa la alerta como disparador y consulta después el estado autorizado del anuncio antes de proponer o aprobar una acción.

¿Dónde debe ejecutarse la regla de aprobación?

Aplica la regla final fuera del modelo con valores fiables como el tipo de acción, el importe, la moneda, el mercado, la cuenta y la versión de la política.

¿Cómo debe gestionarse un reintento?

Usa una clave de idempotencia estable para la misma escritura prevista y conserva la solicitud y el resultado para que el reintento no cree una segunda acción.

/Fuentes y método de revisión

PRIMARY_SOURCES

El flujo se revisó el 18 de julio de 2026 con la siguiente documentación técnica primaria y propia.