kinopoisk-rating v0.3.3

Kinopoisk Rating

Node.js библиотека для получения рейтингов фильмов с Кинопоиска и IMDb по id.

Установка

npm install kinopoisk-rating

Пример использование

import { KinopoiskRating, KinopoiskError } from 'kinopoisk-rating';

async function main() {
    try {
        const movieId = 326; // ID фильма "Побег из Шоушенка"
        const rating = await KinopoiskRating.getRating(movieId);
        
        console.log('Кинопоиск:');
        console.log(`  Рейтинг: ${rating.kp.rating.toFixed(1)}`);  // 9.1
        console.log(`  Голосов: ${rating.kp.votes.toLocaleString()}`);  // 1 069 898
        
        console.log('\nIMDb:');
        console.log(`  Рейтинг: ${rating.imdb.rating.toFixed(1)}`);  // 9.3
        console.log(`  Голосов: ${rating.imdb.votes.toLocaleString()}`);  // 3 011 510
    } catch (error) {
        if (error instanceof KinopoiskError) {
            console.error('Ошибка:', error.message);
        } else {
            console.error('Произошла ошибка:', error);
        }
    }
}

Через консоль

Вы можете использовать консольное приложение для быстрой проверки рейтингов:

# Получить рейтинг фильма "Побег из Шоушенка" (используется по умолчанию)
npm run example

Форматы данных

Rating

interface Rating {
    kp: {
        rating: number;    // Рейтинг на Кинопоиске
        votes: number;     // Количество голосов на Кинопоиске
    };
    imdb: {
        rating: number;    // Рейтинг на IMDb
        votes: number;     // Количество голосов на IMDb
    };
}

KinopoiskError

class KinopoiskError extends Error {
    constructor(message: string, public statusCode?: number) {
        super(message);
        this.name = 'KinopoiskError';
    }
}

Разработка

# Установка зависимостей
npm install --legacy-peer-deps

# Сборка проекта
npm run build

# Запуск тестов
npm test

# Запуск примера
npm run example

Лицензии

Этот проект лицензирован под лицензией MIT.