# TCG Open Data Starter Map

A starter map of free/open/public resources for trading-card data collection, community tools, and agent retrieval.

## Obtain

- Human Markdown: `/commons/data/tcg-open-data-starter.md`
- Agent JSON: `/commons/data/tcg-open-data-starter.json`
- Agent JSONL: `/commons/data/tcg-open-data-starter.jsonl`
- YUTABASE JSONL: `/commons/data/tcg-open-data-starter.yutabase.jsonl`

## Metadata

- **Dataset ID:** tcg-open-data-starter
- **Generated:** 2026-06-24T13:33:43.835Z
- **Visibility:** public
- **License:** This curation is shared freely; upstream sources retain their own terms and attribution requirements.
- **Cadence:** ad hoc; refresh sources before production use
- **Raw SHA-256:** `b9b53b2c635d36f80cfeaccd17dd6faa4d9d2c718524a60da23d2d106c15b0b4`
- **Collector:** Cambridge TCG (commons steward)
- **Source health checked:** yes

## Sources

| ID | Source | Type | Access | Terms note | Health |
|---|---|---|---|---|---|
| cambridge-commons | [Cambridge TCG Commons API](https://cambridgetcg.com/api/commons/resources) | api | public | Public resource map. Do not crawl private account/admin routes. | reachable (HEAD 200, 2026-06-24T13:33:39.862Z) |
| pokemon-tcg-api | [Pokémon TCG API](https://pokemontcg.io/) | api | free | Respect upstream API rules, attribution expectations, and rate limits. | reachable (HEAD 200, 2026-06-24T13:33:40.692Z) |
| scryfall-api | [Scryfall API and bulk data](https://scryfall.com/docs/api) | api/bulk-data | free | Use bulk data for high-volume workflows; respect Scryfall rate guidance and terms. | reachable (HEAD 200, 2026-06-24T13:33:41.770Z) |
| ygoprodeck-api | [YGOPRODeck API](https://ygoprodeck.com/api-guide/) | api | free | Respect API etiquette, rate limits, and caching guidance. | reachable (HEAD 200, 2026-06-24T13:33:42.919Z) |

## Items

### Cambridge Commons resource map

A public map of free/open TCG resources, data, compute paths, and party needs.

- **Kind:** dataset
- **How:** declared
- **Confidence:** high
- **Sources:** cambridge-commons
- **Tags:** commons, resources, agents, humans
- **Agent hint:** Use this as dataset evidence; cite source_ids=cambridge-commons.

### Pokémon card metadata source

Public API useful for Pokémon card search, collection prototypes, and metadata normalization examples.

- **Kind:** source
- **How:** declared
- **Confidence:** medium
- **Sources:** pokemon-tcg-api
- **Tags:** pokemon, metadata, api
- **Agent hint:** Use this as source evidence; cite source_ids=pokemon-tcg-api.
- **Correction (annotate) by human:cambridgetcg:** Flag rate-limit etiquette for community builders. — Community note: the Pokémon TCG API rewards an API key and polite caching; do not hammer it from client apps.

### Bulk-data-first pattern

Scryfall demonstrates a friendly model for combining API access with bulk downloads for agent and human tooling.

- **Kind:** pattern
- **How:** inferred
- **Confidence:** high
- **Sources:** scryfall-api
- **Tags:** bulk-data, api-design, agent-friendly
- **Agent hint:** Use this as pattern evidence; cite source_ids=scryfall-api.
- **Notes:** Use as an architectural pattern. Magic data is not Cambridge inventory. Bulk files refresh daily; cache and attribute Scryfall.
- **Correction (update) by human:cambridgetcg:** Scryfall publishes daily bulk files and documents them clearly; the architectural pattern is well evidenced.

### Yu-Gi-Oh! metadata reference

YGOPRODeck offers a useful public schema reference for cross-game TCG metadata comparisons.

- **Kind:** source
- **How:** declared
- **Confidence:** medium
- **Sources:** ygoprodeck-api
- **Tags:** yugioh, metadata, schema
- **Agent hint:** Use this as source evidence; cite source_ids=ygoprodeck-api.


## Corrections

- **tcg-open-data-starter-correction-001** by human:cambridgetcg (2026-06-24T00:00:00.000Z): Example correction: clarify the Scryfall pattern note and raise its confidence. — 2 change(s) to scryfall-bulk-pattern, pokemon-card-metadata

## Human review checklist

- Verify upstream terms before operational use.
- Do not include private/customer data.
- Prefer source links and timestamps over vibes.
- If a record is inferred, explain why.

## Agent instructions

When using this dataset, cite `source_ids`, respect upstream terms, and preserve `how` + `confidence` fields.