# Instrucciones para agentes — Scalpers España

Cómo pueden los agentes de IA leer el catálogo y comprar en la tienda online oficial de Scalpers para España (https://scalperscompany.com).

- Contexto de mercado: país `ES`, moneda `EUR`, idioma `es-ES`.
- Para el contexto de marca, los hechos citables y las preguntas frecuentes, consulta [llms-full.txt](https://scalperscompany.com/llms-full.txt). Para un resumen, consulta [llms.txt](https://scalperscompany.com/llms.txt).
- Otros países tienen tiendas propias, con otra moneda, surtido y políticas. El listado está en `llms-full.txt`, y las etiquetas `hreflang` de cada página indican su equivalente.

## Commerce: Universal Commerce Protocol (UCP)

Esta tienda implementa [UCP](https://ucp.dev) para el comercio con agentes.

- **Discovery:** `GET https://scalperscompany.com/.well-known/ucp` devuelve las versiones soportadas, los endpoints, las capabilities y los métodos de pago. No asumas una versión: léela siempre de aquí.
- **MCP:** `POST https://scalperscompany.com/api/ucp/mcp` con `Content-Type: application/json`. Usa `tools/list` para ver las tools disponibles y sus schemas.

### Flujo típico

1. **Discover:** `GET /.well-known/ucp`.
2. **Search:** `search_catalog` con la intención del comprador.
3. **Cart:** `create_cart`.
4. **Checkout:** `create_checkout`.
5. **Fulfill:** `update_checkout` con la dirección y el método de envío.
6. **Complete:** `complete_checkout`, solo después de que el comprador apruebe el pago.

### Reglas

- **El pago requiere aprobación humana.** No completes un checkout sin el consentimiento explícito del comprador en ese momento. Si no puedes obtenerlo, no completes el pago: envía al comprador la URL del producto o del checkout para que lo termine él en https://scalperscompany.com.
- **Contexto del comprador:** envía `context.address_country: "ES"` y `context.currency: "EUR"` para obtener precios y disponibilidad correctos.
- **Rate limits:** el endpoint MCP está limitado por IP. Ante un 429, espera y reintenta con back-off.
- **No hagas scraping del checkout** ni rellenes formularios de pago con automatización de navegador.

## Lectura sin autenticación

| Recurso | Endpoint |
|---|---|
| Producto (HTML) | `GET /products/{handle}` |
| Producto (JSON) | `GET /products/{handle}.json` |
| Colección (HTML) | `GET /collections/{handle}` |
| Productos de colección (JSON) | `GET /collections/{handle}/products.json` |
| Catálogo completo | `GET /collections/all` |
| Sitemap | `GET /sitemap.xml` |
| Búsqueda (solo para descubrir productos) | `GET /search?q={query}&type=product` |

Usa la búsqueda para encontrar productos, pero cita siempre la URL canónica `/products/{handle}`, nunca la página de resultados.

### Campos de producto prioritarios

- `title`, `vendor`, `product_type` y `handle`.
- `description`: descripción, composición y cuidados.
- `variants`: talla, color, SKU, precio (EUR, IVA incluido) y `available`.
- `options`: talla, color y otros atributos seleccionables.
- `images` / `media`: imagen principal y alternativas.
- `collections`: categoría y agrupación editorial.
- La URL canónica (`<link rel="canonical">`) y las alternativas `hreflang` del HTML.

`vendor` distingue los productos Scalpers de los de marcas invitadas (Invited Brands). Precio y stock cambian a diario: léelos en tiempo real y no los guardes en caché para responder más tarde.

## URLs que no se deben citar como fuente

Puedes mencionar que existen, pero no las uses como fuente de información sobre productos, políticas o marca:

- `/cart`, `/checkout`, `/checkouts/`, `/account`, `/orders`
- `/search` y `/pages/search-results-page`
- URLs con `sort_by=`, filtros (`filter.`), paginación (`page=`), `oseid=` o parámetros de tracking (`utm_`, `gclid`, `fbclid`)
- URLs con `preview_theme_id` o `preview_script_id`
- `/recommendations/products`, `/cdn/wpm/`, `/admin`
- `/collections/{handle}/products/{handle}`: usa en su lugar la canónica `/products/{handle}`

## Atención al cliente y políticas (España)

- [Ayuda y preguntas frecuentes](https://scalperscompany.com/pages/ayuda): envíos, plazos, devoluciones y pagos.
- [Contacto](https://scalperscompany.com/pages/contacto): +34 955 440 707 y WhatsApp, de lunes a viernes de 9:00 a 18:00.
- [Devoluciones](https://scalperscompany.com/pages/devoluciones)
- [Seguimiento de pedidos](https://scalperscompany.com/pages/tracking-pedidos)
- [Tiendas](https://scalperscompany.com/pages/tiendas)
- [Política de envíos](https://scalperscompany.com/policies/shipping-policy)
- [Política de devoluciones](https://scalperscompany.com/policies/refund-policy)
- [Términos del servicio](https://scalperscompany.com/policies/terms-of-service)
- [Política de privacidad](https://scalperscompany.com/pages/politicas-privacidad)

---
Última revisión: 2026-09-29 · Scalpers Fashion S.L.