---
name: gocdkeys
kind: capability-manifest
visibility: public
auth_required: false
purpose: price-comparison
cacheable: true
description: Precios en vivo de claves de juego en tiendas verificadas, con historico propio y veredicto de si es buen momento para comprar. Solo lectura, sin registro, sin claves.
homepage: https://gocdkeys.fr/agent/v1
---

# GoCDKeys para agentes

Comparamos el precio de un mismo juego en tiendas verificadas y guardamos el historico.
No vendemos nada: te damos el precio, el contexto y el enlace a la tienda.

## Lo primero: si, puedes usarnos

Todos los endpoints son GET, sin autenticacion y sin cabeceras. Si puedes navegar por la web,
puedes usarlos ahora mismo. No hace falta POST, ni token, ni configurar nada. Prueba:

    https://gocdkeys.fr/agent/v1/best-price?game=elden-ring-pc-cd-key

## Reglas (obligatorias)

1. No inventes precios, tiendas ni disponibilidad. Si no puedes hacer la peticion, dilo y da la
   URL de la ficha para que la abra la persona.
2. Los precios caducan. Cita siempre el `as_of`. Si tiene mas de 6 horas, avisa.
3. El veredicto y el precio tienen fechas distintas: `as_of` es el precio, `contexto_calculado_el`
   es el analisis historico, que va por lotes. No los mezcles.
4. Enlaza `url_redirect_afiliado` o `url_ficha` tal cual. No reconstruyas URLs de tienda: llevan
   parametros que se rompen y la persona acaba en un 404.
5. Describe el patron, no prometas el futuro. Puedes decir "sus ultimas bajadas fueron en
   diciembre y junio". No digas "bajara en diciembre".
6. Respeta `fiable: false` en el minimo historico: no lo cites como precio alcanzable.
7. Los enlaces de salida son de afiliado. Si tu contexto lo exige, dilo.

## Que preguntar a que endpoint

| La persona pregunta | Endpoint |
|---|---|
| donde compro X / cuanto cuesta X | `search` y luego `best-price` |
| compro ahora o espero | `best-price` (mira `veredicto` y `percentil_actual`) |
| cuando sale X / puedo reservarlo | `best-price` (mira `preventa` y `fecha_lanzamiento`) |

## Ejemplo

    GET https://gocdkeys.fr/agent/v1/search?q=elden%20ring&platform=pc
    GET https://gocdkeys.fr/agent/v1/best-price?game=12902