casecomp.xyz | API Docs | Dashboard | Admin | Changelog
Search any Pokemon card across four marketplaces in one query. Get live prices, AI condition estimates, and PSA grading signals — instead of manually checking eBay, magi.camp, Yahoo Auctions, and SNKRDUNK separately.
- Multi-source search — eBay, magi.camp, Yahoo Auctions JP, SNKRDUNK in one query
- Cross-source arbitrage — compares lowest prices across sources, highlights spread
- Condition detection — auto-detects card condition across sources (EN: NM/LP/MP, JP: 状態A/美品)
- AI pre-grading — per-subgrade analysis (centering, corners, edges, surface) from listing photos
- Price history — sold comp tracking over time with line charts and stats
- PSA grading signals — population data, difficulty, gem 10%, recommended submission tier with reasoning
- Slab comparison — compare PSA 10 / BGS 9.5 / TAG 10 prices across sources with filter pills
- Dashboard — search, arbitrage, price history, grade breakdown at
/dashboard - Admin — API key management, stats KPIs, error log at
/admin - REST API — authenticated endpoints with rate limiting, per-key caching, OpenAPI spec
- Claude Code skill —
/casecompfor plain-English card search - Chrome extension — queue auto-join for Pokemon Center, Walmart, Costco, Target drops
yarn install
yarn playwright-install
cp .env.example .env # add keys (see Environment below)
yarn api # dashboard on localhost:3000| Command | What |
|---|---|
yarn api |
Start API + dashboard on :3000 |
yarn start |
CLI search (node index.js) |
yarn test |
Full suite: syntax, unit, secrets, API |
yarn test:unit |
Unit tests only (no server) |
yarn test:api |
API tests against localhost |
yarn test:live |
API tests against api.casecomp.xyz |
yarn deploy |
Build + deploy to Cloud Run |
yarn scan |
Event & release scanner |
api.js Express API + static dashboard (public/)
index.js CLI entry point
lib/
sources/
ebay.js eBay Browse API, OAuth, ship-to filtering
magi.js magi.camp scraper (fetch + cheerio)
snkrdunk.js SNKRDUNK JSON API
yahooauctions.js Yahoo Auctions JP scraper
tcgplayer.js TCGPlayer price seeding
grading/
grading.js AI pre-grading (per-subgrade, Claude/OpenAI)
preprocessing.js Corner crop extraction via sharp
psa.js PSA pop reports, cert lookup, grading signal
psaTiers.js PSA submission tier data
data/
firestore.js Firestore: grade logs, drops, webhooks, cache
api-keys.js Developer key management
card-identity.js Card identity: canonical IDs, set resolution
price-history.js Sold comp price tracking
demo.js Sample data (3 multi-source cards)
cache.js File-based cache (legacy)
redis-cache.js Redis cache (optional)
search/
filters.js Language, relevance, condition detection, outlier flagging
listingQuery.js eBay search query builder
ebayCategories.js eBay category IDs
output.js Markdown/JSON formatters (CLI)
swagger.js OpenAPI 3.0.3 spec
public/ Root dashboard (search, grade, arbitrage, price history)
public/admin/ Admin dashboard (keys, stats, errors)
extension/ Chrome extension: queue auto-join, drop intel
terraform/ GCP infra: Cloud Run ×2, Firestore, LB + CDN, Secret Manager
test/
unit-test.js 118 unit tests
api-test.js 76 API integration tests
smoke-test.js 40 Playwright smoke tests (dashboard UI)
api.casecomp.xyz — interactive search with detail panel, AI grade breakdown, PSA signal bar, source filters.
Three sample cards work without API keys (?demo=true):
- Pikachu ex SAR PSA 10 (multi-source slab: eBay + magi + Yahoo)
- Mega Greninja ex SAR (SNKRDUNK + AI grade)
- Umbreon ex SAR 217/187 (eBay + magi + Yahoo + AI grade)
All endpoints except health and sample data require a CC_LIVE_ API key.
# Auth: header or query param
-H "Authorization: Bearer CC_LIVE_xxxxx"
# or
?key=CC_LIVE_xxxxxFull reference: api.casecomp.xyz/docs
# Sample data (no key needed)
curl "https://api.casecomp.xyz/api/search?q=Umbreon+ex+SAR+217/187&demo=true"
# Arbitrage — cross-source price comparison
curl "https://api.casecomp.xyz/api/arbitrage?q=Pikachu+ex+SAR+234/193+PSA+10&demo=true"
# Price history
curl "https://api.casecomp.xyz/api/price-history?q=Umbreon+ex+SAR+217/187&days=90&demo=true"
# Live search (key required)
curl -H "Authorization: Bearer $CASECOMP_KEY" \
"https://api.casecomp.xyz/api/search?q=Pikachu+ex+SAR&source=magi&format=slab&slab_provider=PSA&slab_grade=10"
# Drop intelligence
curl -H "Authorization: Bearer $CASECOMP_KEY" \
"https://api.casecomp.xyz/v1/drops"
# Error monitoring
curl -H "Authorization: Bearer $CASECOMP_KEY" \
"https://api.casecomp.xyz/api/errors"
# Set an arbitrage alert (notify when spread > 10%)
curl -X POST -H "Authorization: Bearer $CASECOMP_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"you@email.com","query":"Umbreon ex SAR 217/187","type":"arbitrage","spreadThreshold":10}' \
"https://api.casecomp.xyz/api/alerts"
# Portfolio (sample data)
curl "https://api.casecomp.xyz/api/portfolio?demo=true"
curl "https://api.casecomp.xyz/api/portfolio/summary?demo=true"
curl "https://api.casecomp.xyz/api/portfolio/history?days=30&demo=true"
curl "https://api.casecomp.xyz/api/portfolio/export?format=csv&demo=true"
curl "https://api.casecomp.xyz/api/portfolio/grading-opportunities?demo=true"| Endpoint | Limit |
|---|---|
Authenticated (CC_LIVE_ key) |
60 req/min |
Sample data (?demo=true) |
360 req/min |
| Health, docs, static | No limit |
GET /api/health | GET /api/demo | GET /docs | GET /docs/spec.json | ?demo=true (sample data) on search/sold/arbitrage/price-history
/casecomp — search for cards in plain English. Claude parses intent and runs the CLI with the right flags.
/casecomp Umbreon ex 217/187 PSA 10 japanese
/casecomp compare Pikachu VMAX alt art and Espeon VMAX alt art
/casecomp should I grade Mega Greninja ex SAR?
/casecomp Charizard ex on magi, condition A, 10 results
node index.js "Charizard ex" # raw eBay search
node index.js --format slab --slab-provider PSA "Pikachu VMAX" # PSA 10 slabs
node index.js --source magi --lang jp "Umbreon ex 217/187" # magi.camp JP
node index.js --grade "Mega Greninja ex SAR" # AI pre-grading
node index.js --grade-decision "Umbreon ex 217/187" # PSA break-even table| Flag | Example | What |
|---|---|---|
--format |
slab / raw |
Slab vs raw (default: raw) |
--slab-provider |
PSA, BGS, CGC, TAG |
Grading company |
--slab-grade |
10, 9.5 |
Grade number |
--lang |
eng, jp, eng,jp |
Card language filter |
--source |
magi, yahoo, snkrdunk |
Listing source |
--countries |
US,IN |
Ship-to countries |
--results |
10 |
Active listings count |
--sold |
10 |
Sold comps count |
--grade |
AI pre-grading | |
--grade-decision |
PSA break-even table | |
--condition |
A, nm, lp, mp |
Condition filter (SNKRDUNK A/B/C/D, eBay NM/LP, magi 状態A/美品) |
--refresh |
Clear cache | |
--parallel |
Concurrent card search |
EBAY_CLIENT_ID= # required — developer.ebay.com
EBAY_CLIENT_SECRET= # required
ANTHROPIC_API_KEY= # AI grading + magi translation
PSA_AUTH_TOKEN= # PSA pop reports
CASECOMP_API_KEY= # API auth (CC_LIVE_ prefix)
CASECOMP_SANDBOX_KEY= # public sandbox key (CC_LIVE_SANDBOX_ prefix, 5/min)
In production, secrets are stored in GCP Secret Manager and referenced by Cloud Run.
All caches use Firestore (shared across Cloud Run instances, persists across deploys). Owner key gets stale-while-revalidate; third-party keys get isolated per-key caches.
| Collection | TTL | Content |
|---|---|---|
cache-grades |
30 days | AI grade results by image hash |
cache-psa-pop |
24 hours | PSA population data |
cache-psa-spec |
permanent | PSA spec ID lookups |
cache-translations |
permanent | EN-to-JP card name translations |
cache-ebay-active |
6 hours | eBay active listing results |
cache-ebay-sold |
24 hours | eBay sold comp results |
price-history |
permanent | Sold comp prices over time |
api-keys |
permanent | Developer API keys (hashed) |
error-logs |
permanent | API errors with request IDs |
GCP (Terraform managed): Cloud Run casecomp-api (API) + casecomp-site (frontend SSR with Cloud CDN), Firestore, HTTPS LB, Secret Manager, Cloud Monitoring, Cloud Scheduler. Cloudflare handles SSL + edge caching for casecomp.xyz (~85ms TTFB). GCP managed SSL for api.casecomp.xyz. Same LB IP routes by host. Cloud Scheduler runs track-prices and check-alerts every 6 hours. See terraform/.
Queue auto-join for Pokemon Center, Walmart, Costco, Target drops. News monitoring from Discord, X, Reddit. Dashboard with KPI tracking.
Load unpacked from extension/ in chrome://extensions.
238 tests: 118 unit (filters, grading, query builder, card identity, condition detection, demo data, image preprocessing, email alerts, portfolio ROI, CSV, gainers/losers, grading opportunities) + 80 API (health, drops, webhooks, search, sold, PSA, grade, auth, admin keys, arbitrage, price-history, condition, alerts, share pages, demo validation, portfolio CRUD, portfolio history/export/grading) + 40 Playwright smoke (dashboard UI, detail panel, tabs, PSA stats, arbitrage, mobile viewport).
Contributions welcome. Fork the repo, create a branch, and open a PR against dev. Run yarn test before submitting — all tests must pass.
For bug reports or feature requests, open an issue.
Personal, non-commercial use only. Not for scalping, cook groups, or bulk purchasing. Full terms in LICENSE.
AI grades are estimates from photos, not official PSA/CGC grades. Use as screening hints only.