高达卡牌游戏元数据与只读 REST API
机器学习
0 下载
33 浏览
2026-09-14
数据集简介
gcg-api
gcg-api 为高达卡牌游戏(Gundam Card Game,Bandai GCG)提供免费、非官方、持续更新的数据与 REST API。项目每周一 06:00 UTC 从 Bandai 官方网站抓取卡牌元数据,并以可下载的 JSON/NDJSON 文件与免费只读 REST API 两种形式对外发布。
该项目只存储事实性元数据,从不托管卡牌图片:卡牌条目中的 image_url 字段指向 Bandai 自己的服务器。项目与 Bandai 无关联,属于社区维护的非官方数据源。
两种消费方式(均免费)
- 可下载数据文件:以 JSON/NDJSON 形式提供,文件同时存放在仓库的 data/ 目录下。
- 免费只读 REST API:API 基址为
https://api.gcgapi.com,无需密钥即可调用。
两种方式均免费开放,可按需选择离线文件或在线接口。
固定精确快照
项目支持固定(pinning)到精确的数据快照,便于在需要可复现结果的场景中锁定某一时点的数据版本,避免因每周更新导致结果漂移。
速率限制与 API 密钥
- 无密钥访问:约 60 请求/分钟/IP。
- 使用免费 API 密钥:约 300 请求/分钟。
API 参考
API 基址:https://api.gcgapi.com。项目提供只读接口,供查询卡牌、系列与规则相关数据。
卡牌 schema
卡牌条目包含以下字段:
| 字段 | 说明 |
|---|---|
| product_id | 产品标识 |
| card_number | 卡牌编号 |
| name | 卡牌名称 |
| set_code | 系列代码 |
| set_name | 系列名称 |
| rarity | 稀有度 |
| card_type | 卡牌类型 |
| color | 颜色 |
| level | 等级 |
| cost | 费用 |
| ap | AP |
| hp | HP |
| zone | 区域 |
| trait | 特性 |
| link | 链接 |
| source_title | 来源标题 |
| block_icon | 区块图标 |
| image_url | 图片地址(指向 Bandai 服务器) |
数据文件清单
仓库 data/ 目录下包含:
data/cards.ndjsondata/cards.jsondata/cards/en/*.json(按系列拆分的卡牌文件)data/sets/en/index.json(系列索引)data/rulings.jsondata/rules-faq.jsondata/errata.jsondata/products.jsondata/manifest.json
许可
项目免费开放,包含 LICENSE 与 LICENSE-DATA 文件。非官方项目,与 Bandai 无关联。
基本信息
记录数量未知
文件大小未知
文件格式JSON/NDJSON
数据来源yzRobo
API 基址https://api.gcgapi.com
更新频率每周一 06:00 UTC 从 Bandai 官网抓取
速率限制无密钥约 60 请求/分钟/IP;免费 API 密钥约 300 请求/分钟
许可免费;含 LICENSE 与 LICENSE-DATA
图片托管不托管卡牌图片,image_url 指向 Bandai 服务器
数据落地页https://github.com/yzRobo/gcg-api
发布日期2026-09-14
高达卡牌游戏卡牌元数据REST APIJSONNDJSON非官方数据
上架信息
数据集市运营
平台统一选品上架,经质量审核后公开
0 次下载