.env.example

# Required for eBay Browse API (client credentials)
# Create keys at https://developer.ebay.com/
EBAY_CLIENT_ID=
EBAY_CLIENT_SECRET=

# API host (default production). Sandbox only: https://api.sandbox.ebay.com
# EBAY_API_BASE=https://api.ebay.com

# Optional: space-separated OAuth scopes (default = Browse only).
# Standard keysets often cannot use Marketplace Insights; omit this unless eBay approved it.
# EBAY_OAUTH_SCOPE=https://api.ebay.com/oauth/api_scope https://api.ebay.com/oauth/api_scope/buy.marketplace.insights

# Optional: set to 1 to request Insights scope on the token (auto-falls back to Browse-only if invalid_scope).
# EBAY_TRY_INSIGHTS_SCOPE=1

# Optional: never call Marketplace Insights (HTML sold comps only), even if Insights is in EBAY_OAUTH_SCOPE.
# EBAY_SKIP_MARKETPLACE_INSIGHTS=1

# Optional: sold HTML via Playwright when Insights is unavailable (install browsers once: npx playwright install chromium).
# EBAY_SOLD_BROWSER=1

# Browse category (TCG singles; default): Toys & Hobbies › Collectible Card Games › Single Cards (183454)

# Optional: Browse contextual marketplace country (pricing/sort UX), not buyer ship-to. Default US.
# EBAY_BROWSE_CONTEXT_COUNTRY=US

# Optional: active listing ship refinement — enlarge pool vs cap Browse getItem calls.
# EBAY_SHIP_LOOKUP_MAX_POOL=96
# EBAY_ACTIVE_SHIP_GETITEM_CAP=64
# EBAY_ACTIVE_ITEM_FIELDGROUPS=EXTENDED

# LLM grading — use one or the other when --grade-mode llm
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
TOGETHER_API_KEY=

# PSA pop report — no key needed. Uses api.psacard.com/publicapi (100 req/day anonymous, cached 24h).
# For a higher-quota key email collectors-apis@collectors.com and set PSA_AUTH_TOKEN here.
# PSA_AUTH_TOKEN=

# Site grading — provider-specific (most are placeholders for self-hosted / partner APIs)
TCGRADER_API_URL=
TCGRADER_API_KEY=
POKEGRADE_API_URL=
POKEGRADE_API_KEY=
SNAPGRADE_API_URL=
SNAPGRADE_API_KEY=

# Self-hosted grader URL only, e.g. http://127.0.0.1:8080/grade — do not paste npm/shell commands on this line.
LOCAL_GRADER_URL=

# Optional: only if eBay documents a valid item_sales `sort` value for your program (default: no sort).
# EBAY_INSIGHTS_SORT=

# ── Chrome Extension: Discord Monitoring ──────────────────────
# Comma-separated Discord channel names to watch for drop alerts.
# These are configured in the extension dashboard, but you can set defaults here.
# DISCORD_CHANNELS=pokemon-center,restocks
#
# Comma-separated keywords that trigger alerts when seen in watched channels.
# DISCORD_KEYWORDS=drop,available,stock,queue,restock,live,in stock,go go go,add to cart,up now,just dropped

# ── REST API ─────────────────────────────────────────────────
# Port for the API server (default 3000)
# API_PORT=3000
#
# Redis URL for caching (optional — falls back to file-based cache if unavailable)
# REDIS_URL=redis://127.0.0.1:6379
#
# API key for v1 endpoints (Bearer auth). If unset, v1 endpoints are open.
# Generate with: node -e "console.log('cc_live_' + require('crypto').randomBytes(24).toString('hex'))"
#CASECOMP_API_KEY=CC_LIVE_
#CASECOMP_SANDBOX_KEY=CC_LIVE_SANDBOX_
#
#
# Google OAuth
#GOOGLE_OAUTH_CLIENT_ID=
#GOOGLE_OAUTH_CLIENT_SECRET=

# JWT secret for signing auth tokens (generate with: openssl rand -hex 32)
#CASECOMP_JWT_SECRET=
#
# ── Email notifications (Resend) ─────────────────────────────
# API key from https://resend.com/api-keys
# Used by check-alerts to send price/arbitrage alert emails.
# If unset, alerts trigger but no email is sent.
#RESEND_API_KEY=re_
#
# Set to any value once casecomp.xyz is verified in Resend to send from alerts@casecomp.xyz
# Without this, emails come from onboarding@resend.dev
#RESEND_VERIFIED_DOMAIN=1

# Firestore for persistent storage (grades, drops, webhooks).
# On Cloud Run, auto-authenticates via the service account — no config needed.
# Locally, set this to your GCP project ID and run: gcloud auth application-default login
# GCLOUD_PROJECT=casecomp-495718