Introduction to ČSFD API
A modern TypeScript NPM library for scraping ČSFD.CZ. Scraper, API REST Server, Exporter and MCP Server in one package.Installation
Get started by installing the library via npm, yarn, or pnpm
Quickstart
Build your first integration in under 3 minutes
API Reference
Explore all available methods and types
Examples
Real-world usage examples and use cases
What is ČSFD?
ČSFD.cz (Česko-Slovenská Filmová Databáze) is the Czech-Slovak Film Database - the most popular movie database and rating platform in the Czech Republic and Slovakia. Think of it as the local equivalent of IMDb, with a passionate community of film enthusiasts. This library provides programmatic access to ČSFD data through web scraping, enabling you to:- Fetch comprehensive movie and TV series information
- Search across movies, series, and creators
- Access user ratings and reviews
- Get detailed creator filmographies and biographies
- Integrate ČSFD data into your applications
Key features
Type-safe
Full TypeScript support with comprehensive type definitions for all API responses
Well-tested
Approximately 100% code coverage with comprehensive test suite
Universal
Works in Node.js, browsers, and serverless environments like AWS Lambda and CloudFlare Workers
Docker ready
Pre-built Docker images available for easy deployment
Homebrew support
Easy globally installed CLI via Homebrew tap for macOS and Linux
MCP Server
Use ČSFD data directly within LLMs like Claude Desktop via Model Context Protocol
Modern API
Promise-based with async/await support for clean, readable code
Few dependencies
Lightweight and efficient with minimal external dependencies
Supported platforms
The library is designed to work across a wide range of JavaScript environments:- Node.js - Both ESM and CommonJS module systems (Node 18+)
- Browsers - Client-side usage (with CORS considerations)
- Docker - Pre-built container images
- CLI - macOS and Linux command-line tools via Homebrew
- MCP Server - Integration with Claude Desktop and other AI tools
- Serverless - Firebase Functions, AWS Lambda, CloudFlare Workers
- Browser Extensions - Chrome, Firefox, Edge extensions
- React Native - Mobile apps (including Expo)
Real-world usage
This library powers several production applications:Browser extensions
- Netflix ČSFD Extension - Shows ČSFD ratings directly on Netflix
- Dafilms Extension - ČSFD integration for Dafilms streaming platform
- Kviff.tv Extension - ČSFD ratings for Kviff.tv festival streaming
Web applications
- bartweb.cz - Personal website using Firebase Functions for “Last Seen” movie tracking
Mobile applications
- KinoKlub - React Native app for AeroFilms cinema chain (available on Android & iOS)
This is an unofficial library and is not affiliated with ČSFD.cz. Please use it responsibly and respect ČSFD’s terms of service.
Privacy and security
This library does not collect, store, or transmit any user data. All requests are made directly from your application to ČSFD.cz. No intermediary servers are involved, and no data is logged or stored by this library.The library has nowhere to store data - there are no backend servers or databases. Even if requested, there would be nothing to show.
Next steps
Install the library
Get node-csfd-api installed in your project
Start building
Follow the quickstart guide to make your first API call