2026 World Cup license-clean image scraper

Collects reusable-licensed images (goals, celebrations, dejected players) for 2026 World Cup key matches, organized by match/keyword, with a credits.csv attribution manifest — for editing into social-media videos without copyright infringement.

⚠️ Only images whose license allows commercial use AND edits are saved. Professional agency shots (Getty/Reuters/AP) are copyrighted and are NOT collected. For those, buy a license. Always keep the attribution from credits.csv in your video.

Install

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

Use

cp config.example.yaml config.yaml   # edit matches / keys
python -m wcscraper.cli --config config.yaml -v

Output:

output/
  France-vs-Spain-Semi-final/
    goal/  celebration/  dejected/
  credits.csv

Test

pytest -v