Installation
You can use the CLI tools in two ways:NPX (No Installation)
Run commands instantly without installing anything:
Homebrew (Global Install)
Install globally on macOS/Linux:
All examples below use
npx node-csfd-api, but if you installed via Homebrew, simply replace it with csfd (e.g., csfd export ratings 912).Available Commands
Export Ratings
Backup your ČSFD ratings to CSV, JSON, or Letterboxd format
REST Server
Run a standalone REST API server for the ČSFD API
MCP Server
Run a Model Context Protocol server for AI integrations
Help
Display help information:
Quick Start Examples
When to Use Each Tool
Export Ratings
Use this when you want to:- Create a backup of your ČSFD ratings
- Migrate your ratings to Letterboxd
- Analyze your viewing history with custom tools
- Generate reports from your rating data
REST Server
Use this when you want to:- Build a web application using ČSFD data
- Create a public API service
- Integrate ČSFD data into existing systems
- Cache and optimize ČSFD requests
MCP Server
Use this when you want to:- Query ČSFD data through AI assistants like Claude
- Build AI-powered movie recommendation systems
- Enable natural language queries to ČSFD
- Integrate ČSFD into LLM workflows
Command Reference
| Command | Description |
|---|---|
server, api | Start the REST API server |
mcp | Start the MCP server for AI agents |
export ratings <userId> | Export user ratings |
help, --help, -h | Show help message |
Next Steps
Export Ratings
Learn about all export formats and options
REST Server
Set up and configure the REST API server
MCP Server
Integrate ČSFD with AI tools