node-csfd-api

Unofficial TypeScript/JavaScript library to scrape and expose CSFD.CZ data (movie/series details, creators, user ratings, user reviews), plus optional CLI, Docker support, and an MCP server interface for LLMs.

Evaluated Mar 30, 2026 (21d ago)
Repo ↗ Ai Ml ai-ml api mcp scraper javascript typescript movies ratings web cli docker
⚙ Agent Friendliness
65
/ 100
Can an agent use this?
🔒 Security
41
/ 100
Is it safe for agents?
⚡ Reliability
40
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
62
Documentation
78
Error Messages
0
Auth Simplicity
95
Rate Limits
70

🔒 Security

TLS Enforcement
80
Auth Strength
20
Scope Granularity
0
Dep. Hygiene
55
Secret Handling
60

Scraping tool; no auth/scopes documented. The library includes express/dotenv and MCP-related dependencies, but provided content does not show secure server configuration, TLS requirements, or structured error codes. Rate limiting guidance exists for multi-page fetches, which indirectly reduces blocking risk.

⚡ Reliability

Uptime/SLA
0
Version Stability
65
Breaking Changes
55
Error Recovery
40
AF Security Reliability

Best When

You need lightweight CSFD data ingestion in Node.js/TypeScript and can tolerate unofficial scraping, using built-in pagination/delays where available.

Avoid When

You require a formally supported API from CSFD, strict SLAs, or you cannot implement backoff/retry strategies when the target site changes or blocks traffic.

Use Cases

  • Fetch CSFD movie/TV details by ID
  • Search CSFD for movies/series/users by query
  • Retrieve creator profiles and filmographies
  • Extract user ratings and reviews with pagination and optional delays
  • Use via CLI (npx/Homebrew) for quick terminal workflows
  • Connect via MCP server to query CSFD data from LLM tooling

Not For

  • Official or guaranteed stable access to CSFD (scraping can break when site markup changes)
  • Use where CSFD data licensing/usage restrictions prohibit scraping
  • High-frequency automated scraping without respecting rate limits and potential blocking
  • Production-grade compliance requirements without legal review and monitoring

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
Yes
Webhooks
No

Authentication

Methods: None mentioned for direct library calls (Potentially none or local configuration for MCP/CLI; not documented in provided excerpt)
OAuth: No Scopes: No

No authentication mechanism is described in the provided content; usage appears to be public scraping of CSFD pages. MCP/REST server security/auth is not evidenced in the excerpt.

Pricing

Free tier: No
Requires CC: No

NPM library; no pricing model described in provided content.

Agent Metadata

Pagination
page-based (options page/allPages with delay)
Idempotent
False
Retry Guidance
Documented

Known Gotchas

  • Scraping-based API may break when CSFD HTML structure changes
  • Rate limiting/detection risk when fetching all pages; library suggests delays
  • MCP server behavior/security details are not visible in the provided excerpt; agents should validate available MCP tools and their schemas before relying on them

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for node-csfd-api.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered