This repository contains the automated workflow for matching movie data with additional sources for the Clusterflick project.
The matching workflow enriches cinema data by cross-referencing movies with additional data sources beyond The Movie Database. This provides enhanced metadata, ratings, reviews, and other supplementary information to improve the user experience.
The workflow executes the match command to enhance movie data:
npm run matchThis command:
- Reads the combined cinema data
- Identifies movies that need additional metadata
- Queries additional data sources (e.g., IMDb, Rotten Tomatoes)
- Matches and merges supplementary information
- Generates enriched dataset with enhanced metadata
One job per source, each publishing matched-data/<source>.json keyed by TMDB
id: IMDb, Letterboxd, Metacritic, The Movie DB, Rotten Tomatoes and the Bechdel
Test.
The Bechdel Test list carries terms the others do not. Its ratings are
licensed under CC BY-NC 3.0, so the releases
published here redistribute them on the same terms: attribution is required
wherever they are shown, and neither the data nor anything built on it may be
put to commercial use. Every matched entry carries a url back to the film's
page on bechdeltest.com, which is how the site satisfies the attribution.
Coverage is partial — the list is crowd-sourced and lags on new releases, so a missing entry means "not rated", never "fails".
The workflow is automatically triggered when the data combining workflow completes successfully. It can also be triggered manually via workflow dispatch if needed.
The workflow may require API keys configured as GitHub secrets depending on the data sources being used:
- Additional API keys for third-party data sources (as needed)
PAT- Personal Access Token for publishing releases and triggering downstream workflows
The code in this repository is licensed under the MIT licence.
The releases are not licensed at all. They are an internal build artifact: they exist so clusterflick.com can show a film's ratings beside its screenings, with each score linked back to its source — which is how the site meets the attribution those sources require. Every rating in them belongs to someone else, and Clusterflick grants no rights over any of it. The Bechdel Test ratings additionally carry a CC BY-NC 3.0 non-commercial restriction, and IMDb material its own non-commercial terms.
For data you can use, see the data licence. The exact terms for this repository are in LICENSE-DATA.