BN

bartholomej/node-csfd-api

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

66 stars 14 forks 质量 88 趋势 28MIT

JavaScript中的ČSFD API。令人惊叹的NPM库,用于抓取 csfd.cz。现在有了MCP服务器

概览

- 🎯 - 支持完整的TypeScript及类型定义 - 🧪 - ~100%代码覆盖率 - 🚀 - 支持Node.js、浏览器和无服务器环境 - 🐳 - 提供预构建的Docker镜像 - 🍺 - 通过Homebrew tap轻松全局安装CLI - 🤖 - 直接在如Claude Desktop等LLM中使用CSFD数据 - 🔄 - 基于承诺,支持异步/等待 - 📦 - 轻量级且高效 - Node.js(ESM 和 CommonJS)- 浏览器(考虑 CORS 因素)- Docker 容器 - macOS/Linux CLI(通过 Homebrew)- MCP 服务器(Claude Desktop 等)- 无服务器(Firebase Functions、AWS Lambda、CloudFlare Workers 等)- Chrome 扩展 - React Native(是的,也支持 Expo!) 通过ČSFD ID获取电影或电视剧的全面信息。 🔎 点击此处查看完整结果示例 在ČSFD数据库中搜索电影、电视剧和用户。 🔎 点击此处查看完整结果示例 获取创作者的详细信息,包括他们的传记和电影作品。

概述(AI 翻译)

现代 TypeScript NPM 抓取库 CSFD。CZ。抓取器、API Rest Server、导出器和 MCP 服务器合一包。(非官方)

功能 • 安装 • 快速启动 • API 参考 • CLI • MCP 服务器 • Docker


✨ 特色

  • 🎯 类型安全 - 完整支持 TypeScript 及类型定义
  • 🧪 经过充分测试 - ~100%代码覆盖率
  • 🚀 通用 - 适用于Node.js、浏览器和无服务器环境
  • 🐳 Docker ready - 可用预构建的 Docker 镜像
  • 🍺 Homebrew 支持 - 通过 Homebrew tap 轻松全局安装 CLI
  • 🤖 MCP 服务器 - 直接在 LLM 中使用 CSFD 数据,如 Claude Desktop
  • 🔄 现代API - 基于承诺,支持异步/等待
  • 📦 依赖较少 - 轻量级且高效

支持的平台

  • Node.js(ESM 和 CommonJS)
  • 浏览器(考虑CORS)
  • Docker 容器
  • macOS/Linux CLI(通过 Homebrew)
  • MCP 服务器(Claude Desktop 等)
  • 无服务器(Firebase Functions、AWS Lambda、CloudFlare Workers 等)
  • Chrome 扩展
  • React Native(是的,也支持Expo!)

📦 安装

🚀 快速启动

📖 目录

  • 电影详情
  • 搜索
  • 创作者
  • 用户评分
  • 用户评价

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。


✨ 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

在 GitHub 查看完整 README

安装

npx -y node-csfd-api mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "csfd": { "command": "npx", "args": ["-y", "node-csfd-api", "mcp"] } } }