Die PkmnPrices API mit Claude Code, Cursor und Codex nutzen

KI-Coding-Tools schreiben Integrationen schnell, wenn sie deine API lesen können. Gib Claude Code, Cursor oder Codex die URLs der PkmnPrices-Dokumentation, und sie binden Kartensuche und aktuelle Marktpreise an, ohne dass du sie durch jeden Endpoint führen musst.

Diese Anleitung zeigt die beiden maschinenlesbaren Quellen, die wir veröffentlichen, wie du sie in jedem Tool einbindest, und dieselbe Abfrage in beiden offiziellen SDKs: Python (pkmnprices) und TypeScript (@pkmnprices/sdk).

Was du hier lernst

• Wann du /llm.md und wann /openapi.json nimmst
• Wie du Claude Code, Cursor und Codex den API-Kontext gibst
• Das Muster „erst auflisten, dann Preis abrufen“, das beide SDKs teilen
• Wie du API-Schlüssel vom Client fernhältst und deine Credits im Blick behältst

Dokumentation für KI-Tools

Kurzreferenz: /llm.md

https://pkmnprices.com/llm.md

Auch auf dem API-Host unter https://api.pkmnprices.com/llm.md erreichbar. Knappes Markdown, zugeschnitten auf die Kontextfenster von LLMs: Authentifizierung, Tarife, Endpoints und Antwortformate.

Vollständiges Schema: OpenAPI

https://pkmnprices.com/openapi.json

Dasselbe Dokument liegt unter https://api.pkmnprices.com/openapi.json. Es wird automatisch aus der API erzeugt: Pfade, Parameter, Schemas und das Sicherheitsschema x-api-key.

Zum Lesen der beiden URLs brauchst du keinen API-Schlüssel. Für Aufrufe von /v1/cards (und dem Rest der Daten-API) schon:

x-api-key: pk_your_key_here

Einen kostenlosen Schlüssel bekommst du im Dashboard.

Claude Code

Füg eine Docs-URL in den Prompt ein oder hinterleg sie in 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)

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

Hol dir die Kurzreferenz mit @web oder leg eine Projektregel an:

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.

Beispiel:

@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

Trag dieselben Verweise in AGENTS.md (oder deine Projektanweisungen) ein, dann lädt Codex sie in jeder Sitzung:

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

Durchgespieltes Beispiel: erst suchen, dann Preis abrufen

Listenaufrufe liefern Zusammenfassungen ohne Preise. Um prices zu bekommen, rufst du eine einzelne Karte (oder ein Sealed-Produkt) per ID ab. Über diese Trennung stolpern viele, also schreib sie in den 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}`);
}

Weiterführendes

Du brauchst einen /price-Befehl für Discord? Den haben wir schon mit dem Python-SDK durchgespielt: Einen Discord-Bot für Pokémon-Preise bauen.

Dasselbe Muster aus Auflisten und Abrufen steckt hinter Sealed-Produkten, Preisverlauf und den Angeboten von eBay und TCGplayer. Mehr dazu in der API-Dokumentation und im Abschnitt LLM-Integration.

Tipps für bessere Ergebnisse

Sei konkret. „Bau mir eine Pokémon-Preis-App“ ist zu vage. Nenn die Docs-URL, das SDK, die Umgebungsvariable, den Umgang mit Währungen und die Schritte „erst auflisten, dann abrufen“.

Lass Schlüssel auf dem Server. Browsercode ruft dein Backend auf, und dein Backend ruft PkmnPrices mit x-api-key auf.

Rechne mit 429ern. Der kostenlose Tarif bietet 100 Credits pro Tag und 60 Anfragen pro Minute. Die SDKs wiederholen 429er wegen des Rate Limits automatisch; bei 429ern wegen des Credit-Limits musst du bis zum nächsten Tag warten. Fang das in deiner Oberfläche ab.

Lies bei jedem Preis currency aus. Setz $ oder € anhand dieses Felds; rechne nicht zwischen USD und EUR um.

Häufige Fragen

Soll ich dem Modell /llm.md oder OpenAPI geben?

Nimm /llm.md für schnelle Aufgaben und kleine Kontextfenster. Nimm /openapi.json, wenn der Agent exakte Schemas oder jeden Query-Parameter braucht oder einen typisierten Client erzeugen soll. Viele Workflows laden zuerst /llm.md und OpenAPI nur dann, wenn etwas unklar ist.

Warum ein SDK statt reinem fetch?

Die offiziellen SDKs schicken x-api-key für dich mit, typisieren die Antworten, blättern durch die Ergebnisse und wiederholen 429er wegen des Rate Limits. Deine Tokens fließen in die Produktlogik statt in HTTP-Klempnerei.

Brauche ich einen API-Schlüssel, um die Dokumentation zu lesen?

Nein. /llm.md und /openapi.json sind öffentlich. Einen Schlüssel brauchst du nur für die Daten-Endpoints unter /v1 (Dashboard → der kostenlose Tarif reicht).

Warum liefert cards.list keine Preise?

Listenantworten bleiben schlank, damit Suchoberflächen schnell sind. Für das prices-Array rufst du cards.get(id) (oder sealed.get) auf. Schreib das ausdrücklich in deinen Prompt, damit das Modell kein prices-Feld in den Listeneinträgen erfindet.

Loslegen

1. Erstell einen kostenlosen Schlüssel im Dashboard
2. Überflieg LLM-Integration und kopier den System-Prompt
3. Gib deinem Coding-Agent /llm.md (und OpenAPI, wenn du das vollständige Schema brauchst)

Das reicht Claude Code, Cursor oder Codex als Kontext, um in einer Sitzung eine funktionierende Integration fertigzustellen.