Usa la API de PkmnPrices con Claude Code, Cursor y Codex

Las herramientas de programación con IA escriben integraciones muy rápido cuando pueden leer tu API. Dale a Claude Code, Cursor o Codex las URL de la documentación de PkmnPrices y montarán la búsqueda de cartas y los precios de mercado en directo sin que tengas que guiarlas endpoint por endpoint.

Esta guía muestra las dos fuentes legibles por IA que publicamos, cómo conectarlas en cada herramienta y la misma consulta en los dos SDK oficiales: Python (pkmnprices) y TypeScript (@pkmnprices/sdk).

Qué vas a aprender

• Cuándo usar /llm.md y cuándo /openapi.json
• Cómo darles contexto de la API a Claude Code, Cursor y Codex
• El patrón de listar y luego obtener el precio que comparten los dos SDK
• Cómo mantener las claves de API fuera del cliente y respetar los créditos

Documentación legible por IA

Referencia rápida: /llm.md

https://pkmnprices.com/llm.md

También está en el host de la API como https://api.pkmnprices.com/llm.md. Es un markdown conciso pensado para la ventana de contexto de un LLM: autenticación, planes, endpoints y formato de las respuestas.

Esquema completo: OpenAPI

https://pkmnprices.com/openapi.json

El mismo documento está en https://api.pkmnprices.com/openapi.json. Se genera automáticamente a partir de la API: rutas, parámetros, esquemas y el esquema de seguridad x-api-key.

Para leer cualquiera de las dos URL no hace falta clave de API. Para llamar a /v1/cards (y al resto de la API de datos), sí:

x-api-key: pk_your_key_here

Consigue una clave gratis en el panel.

Claude Code

Pega una URL de la documentación en el prompt o déjala fija en CLAUDE.md:

## External APIs

PkmnPrices API:
- Quick ref: https://pkmnprices.com/llm.md
- OpenAPI: https://pkmnprices.com/openapi.json
- Auth: x-api-key header
- Prefer official SDKs: pkmnprices (Python), @pkmnprices/sdk (TypeScript)

Prompt de ejemplo:

Read https://pkmnprices.com/llm.md and use the pkmnprices Python SDK to
search for a card by name, then fetch its USD market prices.

Cursor

Carga la referencia rápida con @web o añade una regla al proyecto:

When working with Pokemon card prices, use the PkmnPrices API.
Quick ref: https://pkmnprices.com/llm.md
OpenAPI: https://pkmnprices.com/openapi.json
Auth: x-api-key. Prefer @pkmnprices/sdk in TypeScript.

Ejemplo:

@web https://pkmnprices.com/llm.md

Create a small TypeScript script with @pkmnprices/sdk that searches for
"charizard" and prints the first card's market prices.

Codex

Pon las mismas referencias en AGENTS.md (o en las instrucciones de tu proyecto) para que Codex las cargue en cada sesión:

## PkmnPrices

- https://pkmnprices.com/llm.md
- https://pkmnprices.com/openapi.json
- Auth header: x-api-key
- SDKs: pkmnprices (Python), @pkmnprices/sdk (JS/TS)
- List endpoints do not include prices — always GET by id for prices

Ejemplo completo: buscar y luego obtener el precio

Las llamadas de listado devuelven resúmenes sin precios. Para obtener prices, pide una sola carta (o un producto sellado) por su id. Esa separación confunde a mucha gente, así que dila en el prompt.

Prompt

Using https://pkmnprices.com/llm.md, write a short program that:
1. Searches cards named "charizard" (per_page 5)
2. Fetches the first result by id with currency=usd
3. Prints name, set, and each market_price with the right $ or € symbol
Use the official SDK. Store the key in an env var. Never hardcode it.

Python (pkmnprices)

pip install pkmnprices
export PKMNPRICES_API_KEY=pk_your_key_here

import os
from pkmnprices import PkmnPrices

client = PkmnPrices(os.environ["PKMNPRICES_API_KEY"])

page = client.cards.list(name="charizard", per_page=5)
card = client.cards.get(page.data[0].id, currency="usd")

print(f"{card.name} — {card.set.name}")
for price in card.prices:
    symbol = "€" if price.currency == "EUR" else "$"
    print(f"  {price.source}: {symbol}{price.market_price}")

client.close()

TypeScript (@pkmnprices/sdk)

npm install @pkmnprices/sdk
export PKMNPRICES_API_KEY=pk_your_key_here

import { PkmnPrices } from "@pkmnprices/sdk";

const client = new PkmnPrices({ apiKey: process.env.PKMNPRICES_API_KEY! });

const { data } = await client.cards.list({ name: "charizard", per_page: 5 });
const card = await client.cards.get(data[0].id, { currency: "usd" });

console.log(`${card.name} — ${card.set.name}`);
for (const price of card.prices) {
  const symbol = price.currency === "EUR" ? "€" : "$";
  console.log(`  ${price.source}: ${symbol}${price.market_price}`);
}

Para ir más allá

¿Necesitas un comando /price en Discord? Ya lo explicamos paso a paso con el SDK de Python: Cómo crear un bot de Discord con precios de Pokémon.

El mismo patrón de listar y luego obtener sirve para productos sellados, historial de precios y anuncios de eBay y TCGplayer. Consulta la documentación de la API y la sección Integración con LLM.

Consejos para obtener mejor código

Sé concreto. «Haz una app de precios de Pokémon» es demasiado vago. Indica la URL de la documentación, el SDK, la variable de entorno, cómo tratar la moneda y los pasos de listar y luego obtener.

Deja las claves en el servidor. El código del navegador debe llamar a tu backend, y es tu backend el que llama a PkmnPrices con x-api-key.

Cuenta con los 429. El plan gratis da 100 créditos al día y 60 solicitudes por minuto. Los SDK reintentan los 429 por límite de solicitudes; los 429 por límite de créditos esperan hasta el día siguiente, así que gestiónalos en la interfaz.

Lee currency en cada precio. Elige $ o € a partir de ese campo; no conviertas entre USD y EUR.

Preguntas frecuentes

¿Le doy al modelo /llm.md u OpenAPI?

Usa /llm.md para tareas rápidas y ventanas de contexto pequeñas. Usa /openapi.json cuando el agente necesite los esquemas exactos, todos los parámetros de consulta o generar un cliente tipado. En muchos flujos de trabajo se carga primero /llm.md y OpenAPI solo si algo no queda claro.

¿Por qué usar un SDK en lugar de fetch a pelo?

Los SDK oficiales envían x-api-key por ti, tipan las respuestas, paginan los resultados y reintentan los 429 por límite de solicitudes. Gastas tokens en la lógica de tu producto y no en la fontanería HTTP.

¿Necesito una clave de API para leer la documentación?

No. /llm.md y /openapi.json son públicos. Solo necesitas una clave (panel → el plan gratis basta) para llamar a los endpoints de datos /v1.

¿Por qué cards.list no devuelve precios?

Las respuestas de listado son ligeras a propósito, pensadas para interfaces de búsqueda. Llama a cards.get(id) (o a sealed.get) para obtener el array prices. Dilo de forma explícita en el prompt para que el modelo no se invente un campo prices en los elementos del listado.

Empieza

1. Crea una clave gratis en el panel
2. Échale un vistazo a Integración con LLM y copia el prompt de sistema
3. Apunta tu agente de programación a /llm.md (y a OpenAPI cuando necesites el esquema completo)

Con ese contexto, Claude Code, Cursor o Codex tienen suficiente para sacar una integración que funcione en una sola sesión.