{"id":"bartholomej-node-csfd-api","name":"node-csfd-api","homepage":null,"repo_url":"https://github.com/bartholomej/node-csfd-api","category":"ai-ml","subcategories":[],"tags":["ai-ml","api","mcp","scraper","javascript","typescript","movies","ratings","web","cli","docker"],"what_it_does":"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.","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"],"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.","alternatives":["Other CSFD scraping libraries or browser-based/manual retrieval","If available, any official CSFD/partner APIs (not provided here)","General-purpose web scraping services or headless browser automation (heavier)"],"af_score":64.8,"security_score":41.2,"reliability_score":40.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:23:39.358694+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":true,"sdk_languages":["TypeScript","JavaScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["None mentioned for direct library calls","(Potentially none or local configuration for MCP/CLI; not documented in provided excerpt)"],"oauth":false,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"NPM library; no pricing model described in provided content."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":64.8,"security_score":41.2,"reliability_score":40.0,"mcp_server_quality":62.0,"documentation_accuracy":78.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":70.0,"tls_enforcement":80.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":65.0,"breaking_changes_history":55.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"page-based (options page/allPages with delay)","retry_guidance_documented":true,"known_agent_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"]}}