Utiliser l’API PkmnPrices avec Claude Code, Cursor et Codex

Les assistants de code IA écrivent vite une intégration quand ils peuvent lire votre API. Donnez à Claude Code, Cursor ou Codex les URL de la documentation PkmnPrices, et ils sauront brancher la recherche de cartes et les prix du marché en direct sans que vous ayez à les guider endpoint par endpoint.

Ce guide présente les deux formats lisibles par une IA que nous publions, la manière de les fournir à chaque outil, et la même recherche dans les deux SDK officiels : Python (pkmnprices) et TypeScript (@pkmnprices/sdk).

Ce que vous allez apprendre

• Quand utiliser /llm.md plutôt que /openapi.json
• Comment donner le contexte de l’API à Claude Code, Cursor et Codex
• Le schéma « lister puis récupérer » pour les prix, commun aux deux SDK
• Comment garder vos clés API hors du client et respecter vos crédits

Une documentation lisible par l’IA

Référence rapide : /llm.md

https://pkmnprices.com/llm.md

Également disponible sur l’hôte de l’API à l’adresse https://api.pkmnprices.com/llm.md. Du markdown concis, pensé pour la fenêtre de contexte d’un LLM : authentification, offres, endpoints et format des réponses.

Schéma complet : OpenAPI

https://pkmnprices.com/openapi.json

Le même document se trouve à https://api.pkmnprices.com/openapi.json. Il est généré automatiquement à partir de l’API : chemins, paramètres, schémas et le schéma de sécurité x-api-key.

Lire l’une ou l’autre de ces URL ne demande aucune clé API. Appeler /v1/cards (et le reste de l’API de données), si :

x-api-key: pk_your_key_here

Créez une clé gratuite depuis le tableau de bord.

Claude Code

Collez une URL de la documentation dans le prompt, ou épinglez-la dans 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)

Exemple de prompt :

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

Récupérez la référence rapide avec @web, ou ajoutez une règle de projet :

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.

Exemple :

@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

Placez les mêmes indications dans AGENTS.md (ou dans les instructions de votre projet) pour que Codex les charge à chaque session :

## 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

Exemple complet : rechercher, puis obtenir le prix

Les appels de liste renvoient des résumés sans prix. Pour obtenir prices, récupérez une carte (ou un produit scellé) par son id. Cette séparation surprend souvent : précisez-la dans le 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}`);
}

Pour aller plus loin

Besoin d’une commande Discord /price ? Nous l’avons déjà construite pas à pas avec le SDK Python : Créer un bot Discord de prix Pokémon.

Le même schéma « lister puis récupérer » s’applique aux produits scellés, à l’historique des prix et aux annonces eBay et TCGplayer : voir la documentation de l’API et la section Intégration LLM.

Conseils pour de meilleures générations

Soyez précis. « Fais une appli de prix Pokémon », c’est vague. Indiquez l’URL de la documentation, le SDK, la variable d’environnement, la gestion des devises et les étapes « lister puis récupérer ».

Gardez les clés côté serveur. Le code du navigateur doit appeler votre backend, et c’est votre backend qui appelle PkmnPrices avec x-api-key.

Attendez-vous à des 429. L’offre gratuite donne 100 crédits par jour et 60 requêtes par minute. Les SDK relancent les 429 dus à la limite de requêtes ; les 429 dus à la limite de crédits, eux, durent jusqu’au lendemain : prévoyez-les dans votre interface.

Lisez currency sur chaque prix. Affichez $ ou € d’après ce champ ; ne convertissez pas entre USD et EUR.

Questions fréquentes

Faut-il donner au modèle /llm.md ou OpenAPI ?

Utilisez /llm.md pour les tâches rapides et les petites fenêtres de contexte. Utilisez /openapi.json quand l’agent a besoin des schémas exacts, de chaque paramètre de requête, ou doit générer un client typé. Beaucoup de workflows chargent d’abord /llm.md, et OpenAPI seulement en cas d’ambiguïté.

Pourquoi utiliser un SDK plutôt qu’un simple fetch ?

Les SDK officiels envoient x-api-key à votre place, typent les réponses, gèrent la pagination et relancent les 429 dus à la limite de requêtes. Vos tokens servent à la logique métier, pas à la plomberie HTTP.

Faut-il une clé API pour lire la documentation ?

Non. /llm.md et /openapi.json sont publics. Une clé n’est nécessaire (tableau de bord → l’offre gratuite suffit) que pour appeler les endpoints de données /v1.

Pourquoi cards.list ne renvoie-t-il pas de prix ?

Les réponses de liste restent légères pour les interfaces de recherche. Appelez cards.get(id) (ou sealed.get) pour obtenir le tableau prices. Dites-le explicitement dans votre prompt pour que le modèle n’invente pas de champ prices sur les éléments de la liste.

Pour commencer

1. Créez une clé gratuite dans le tableau de bord
2. Parcourez la section Intégration LLM et copiez le prompt système
3. Donnez /llm.md à votre agent de code (et OpenAPI quand il lui faut le schéma complet)

Cela suffit à Claude Code, Cursor ou Codex pour livrer une intégration fonctionnelle en une seule séance.