kinopoisk-rating/README.md

API-клиент для получения рейтингов с Кинопоиска и IMDb

# Kinopoisk Rating

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

## Установка

```bash
npm install kinopoisk-rating
```

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

```typescript
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);
        }
    }
}
```

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

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

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

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

### Rating

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

### KinopoiskError

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

## Разработка

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

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

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

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

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