Master Setter Pokémon TCG

14 种语言的 Pokémon TCG API：Master Setter Catalog API

以 JSON 格式提供 Pokémon Trading Card Game 卡牌数据，涵盖卡牌印刷过的所有语言。 199,314 张卡牌 · 276,657 种印刷版本 · 1,821 个系列 · 14 种语言，包括通过任何 API 都能获取的最完整的韩语、泰语、印度尼西亚语、繁体中文和简体中文目录。

• 文档和免费密钥：https://api.master-setter.com
• OpenAPI 3.1 规范：https://api.master-setter.com/openapi.json
• 面向 AI 助手：https://api.master-setter.com/llms.txt
• 远程 MCP 服务（Claude Code、Cursor、任何 MCP 客户端）：https://api.master-setter.com/mcp

为什么选择此 API

大多数 Pokémon 卡牌 API 覆盖英语，有时也覆盖日语，并以每张卡牌为单位建模。此 API 以每种印刷版本为单位建模：一张卡牌在某种语言、工艺和系列中的版本（第一版与无限版、全息与反向全息、带印章的宣传卡）。这才是扫描器识别、商店上架和收藏家持有的对象。

语言	代码	卡牌数	系列数
日语	ja	22,164	239
英语	en	21,795	216
法语	fr	19,942	178
意大利语	it	19,745	174
德语	de	19,285	135
韩语	ko	16,778	234
西班牙语	es	16,697	136
葡萄牙语	pt	15,701	105
繁体中文	zh-tw	13,127	134
印度尼西亚语	id	11,937	94
泰语	th	11,853	95
简体中文	zh-cn	6,946	55
拉丁美洲西班牙语	es-mx	1,758	10
俄语	ru	1,104	11

各语言页面：日语 · 韩语 · 繁体中文 · 简体中文 · 泰语 · 印度尼西亚语 · 所有语言

快速入门

# 1. Get a free key (English cards, 250 requests/month, personal use). Returned immediately.
curl -X POST https://api.master-setter.com/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","personal_use":true}'

# 2. Call it
curl -H "Authorization: Bearer $KEY" \
  "https://api.master-setter.com/v1/sets?lang=en&limit=5"

curl -H "Authorization: Bearer $KEY" \
  "https://api.master-setter.com/v1/cards?id=en-base1-4"

响应：

{
  "data": {
    "id": "en-base1-4",
    "name": "Charizard",
    "number": "4",
    "rarity": "Rare Holo",
    "hp": 120,
    "artist": "Mitsuhiro Arita",
    "variants": [
      { "variant_key": "1stEditionHolofoil" },
      { "variant_key": "shadowlessHolofoil" },
      { "variant_key": "unlimitedHolofoil" }
    ]
  },
  "retrieved_at": "2026-10-12T00:00:00.000Z"
}

更多示例：JavaScript · Python

端点

方法	路径	返回内容
POST	/v1/keys	立即获取免费密钥
GET	/v1/sets?lang=ko	指定语言的系列，按最新顺序排列，支持分页
GET	/v1/sets?id=ko-sv4a	单个系列，card_count 根据实际存在的卡牌计算
GET	/v1/cards?id=en-base1-4	单张卡牌及其所有印刷版本
GET	/v1/cards?set=ja-sv4a&include=variants	按编号获取整个系列，内含印刷版本（付费）
GET	/v1/cards?q=리자몽&lang=ko	名称搜索，使用每张卡牌自身的语言
POST	/v1/billing	升级现有密钥，或打开账单门户

系列 ID 格式为 <lang>-<set code>（en-base1、ko-sv4a），卡牌 ID 格式为 <set id>-<number>。

从 AI Agent 使用（MCP）

# Claude Code
claude mcp add --transport http master-setter https://api.master-setter.com/mcp \
  --header "Authorization: Bearer $KEY"

// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "master-setter": {
    "url": "https://api.master-setter.com/mcp",
    "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

工具：search_cards、get_card、list_cards_in_set、list_sets、get_set、get_api_key。也已作为 com.master-setter/pokemon-tcg 收录在官方 MCP 注册表中。

套餐

套餐	每月请求数	包含内容	用途	价格
Free	250	英语卡牌和系列	个人使用	$0
Indie	50,000	全部 14 种语言 + 所有印刷版本	可用于商业用途	$29/mo
Studio	500,000	Indie + 卡牌图片	可用于商业用途	$99/mo
Bulk	自定义	全部内容	可用于商业用途	电子邮件

升级后仍使用同一密钥。条款：https://api.master-setter.com/terms

与其他 Pokémon API 的比较

与 TCGdex、JustTCG、Scrydex 和 PokemonPriceTracker 进行坦诚的并排比较：https://api.master-setter.com/compare

---

本仓库中的示例采用 MIT 许可。API 及其数据依据API 条款提供。Master Setter 与 The Pokémon Company、Nintendo、Creatures 或 GAME FREAK 没有任何关联，也未获得其认可或赞助。Pokémon 及所有相关名称均为其所有者的商标。卡牌数据包含来自 TCGdex 的内容（MIT License）。