ČSFD MCP server

CSFD API 🎬 + CSFD Export 💾 + CSFD MCP 🤖

Modern TypeScript NPM library for scraping CSFD.CZ. Scraper, API Rest Server, Exporter and MCP Server in one package. (unofficial)

Features • Installation • Quick Start • API Reference • CLI • MCP Server • Docker

✨ Features

• 🎯 Type-safe - Full TypeScript support with type definitions
• 🧪 Well-tested - ~100% code coverage
• 🚀 Universal - Works in Node.js, browsers, and serverless environments
• 🐳 Docker ready - Pre-built Docker images available
• 🍺 Homebrew support - Easy globally installed CLI via Homebrew tap
• 🤖 MCP Server - Use CSFD data directly within LLMs like Claude Desktop
• 🔄 Modern API - Promise-based with async/await support
• 📦 Few dependencies - Lightweight and efficient

Supported Platforms

• Node.js (ESM & CommonJS)
• Browsers (with CORS considerations)
• Docker containers
• macOS/Linux CLI (via Homebrew)
• MCP Server (Claude Desktop, etc.)
• Serverless (Firebase Functions, AWS Lambda, CloudFlare Workers, etc.)
• Chrome Extensions
• React Native (Yes, with Expo too!)

📦 Installation

npm install node-csfd-api
# yarn add node-csfd-api
# pnpm add node-csfd-api

🚀 Quick Start

import { csfd } from 'node-csfd-api';

// Fetch movie details
const movie = await csfd.movie(535121);
console.log(movie.title); // "Na špatné straně"

// Search for content
const results = await csfd.search('Tarantino');
console.log(results.movies, results.tvSeries, results.users);

// Get creator info
const creator = await csfd.creator(2120);
console.log(creator.name); // "Quentin Tarantino"

// Get user ratings
const ratings = await csfd.userRatings('912');
console.log(ratings);

// Get user reviews
const reviews = await csfd.userReviews('195357-verbal');
console.log(reviews);

📖 Table of Contents

• Movie Details
• Search
• Creators
• User Ratings
• User Reviews
• Language & Request Options
• Error Handling
• Browser Verification Cookie
• CLI Tools
• MCP Server
• Docker Support
• REST API

📚 API Reference

Movie

Retrieve comprehensive information about a movie or TV series by its ČSFD ID.

Method: csfd.movie(id: number | string, options?: CSFDOptions): Promise

The ID can be a number, a slug ('535121-na-spatne-strane') or a full ČSFD URL. The same works for creators and users.

import { csfd } from 'node-csfd-api';

// Using async/await
const movie = await csfd.movie(535121);

// Alternatively, using promises
csfd.movie(535121).then((movie) => console.log(movie));

🔎 Click here to see full result example

Shortened. The full README is on GitHub.