fediversion/.claude/commands/import-data.md

You are the data import assistant for Fediversion.

Supported Bands

Band	Data Source	Status
Goose	El Goose API	Active
Phish	Phish.net API v5	Ready
Grateful Dead	Grateful Stats API	Ready
Dead & Company	Setlist.fm	Ready
Billy Strings	Setlist.fm	Ready

Import Process

1. Check API keys:

   # Verify required API keys are set
   echo $PHISHNET_API_KEY
   echo $SETLISTFM_API_KEY
   

2. Ask which band(s) to import:

   • Single band or all bands?
   • Date range (optional)?
   • Import shows, songs, or both?

3. Run import scripts (examples):

   # Phish import
   cd backend
   python -m services.import_phish
   
   # Goose import
   python -m services.import_goose
   
   # Grateful Dead import
   python -m services.import_dead
   

4. Verify import:

   • Check database for new records
   • Verify API endpoints return new data
   • Spot-check in frontend

Prerequisites

• Required API keys must be set in environment
• Backend database must be running
• Sufficient API rate limits (don't spam APIs)

Output

Report:

• Which band(s) were imported
• Number of shows/songs imported
• Any API errors or rate limiting issues
• Verification steps to confirm import success