Upcoming Metal Concerts

Collect upcoming metal concerts and festivals worldwide via concerts-metal.com.

First run

On first run, skill-config.json is created with default settings. The default country is Spain (ES). Tell the user this and ask them which country they'd like to use. To see all supported country codes, run:

CODEBLOCK0

Then update country in {baseDir}/skill-config.json to the user's chosen code before collecting.

Usage

Run the collector to scrape and accumulate concert data into data/concerts.json:

CODEBLOCK1

The --country flag overrides the config for a single run without changing it:

CODEBLOCK2

Re-running merges new concerts without duplicates and flags previously-seen future concerts that disappear from the source as potentially cancelled. Each record contains date, artists, venue, city, url, discovered_at, and status ("active" or "cancelled").

Changing settings

All settings live in {baseDir}/skill-config.json:

CODEBLOCK3

When the user asks to change their country or lookahead window, edit the relevant key in {baseDir}/skill-config.json directly.

Data files

All data lives in data/ (gitignored):

• - concerts.json — accumulated concert records

Notes

• - No API key required. Data is sourced from concerts-metal.com broadcast pages.
• Coverage is excellent for metal, punk, hardcore, and adjacent genres across 50+ countries.