Films Parser

Python-скрипт для подбора фильмов и сериалов в жанрах детектив/триллер с хорошими рейтингами и сохранением результата в Excel.

GitHub metadata

Repository description:

Python parser for detective and thriller movies/series recommendations with TMDb and Kinopoisk.dev export to Excel.

Topics / tags:

python
movies
series
parser
excel
tmdb-api
kinopoisk-api
film-recommendations
thriller
detective
openpyxl
data-export

Short project summary:

Films Parser собирает фильмы и сериалы за выбранные годы по жанрам детектив/триллер, фильтрует их по рейтингу и количеству оценок, а затем сохраняет русскоязычную подборку в Excel.

Meta description:

Films Parser is a Python tool that collects detective and thriller movies and TV series from TMDb and Kinopoisk.dev, filters by rating and votes, and exports Russian titles, descriptions, countries, years, ratings, and source links to Excel.

Возможности

Скрипт собирает фильмы и сериалы за 2020-2026 год в жанрах детектив/триллер, фильтрует по хорошему рейтингу и количеству оценок, затем сохраняет Excel-файл exports/detective_thriller_2020_2026.xlsx в папке проекта.

На выходе получается таблица с русским названием, описанием, источником, годом, страной, рейтингом, типом, количеством оценок и ссылкой на карточку.

Источники

• TMDb: русские названия, русские описания, рейтинг, количество оценок.
• Kinopoisk.dev: русские названия, русские описания, рейтинг, количество оценок.

Проект использует TMDb API, но не одобрен и не сертифицирован TMDb. Данные, полученные через TMDb и Kinopoisk.dev, принадлежат их правообладателям и используются только через официальные API.

Для стабильной работы нужны API-ключи. HTML-страницы онлайн-кинотеатров и рекомендательных сайтов часто меняют разметку, блокируют парсинг и не всегда разрешают автоматический сбор данных, поэтому скрипт использует API.

Быстрый запуск

cd /Users/katapios/Documents/PythonProjects/Films_Parser
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Откройте .env и вставьте хотя бы один ключ:

TMDB_API_KEY=...
KINOPOISK_API_KEY=...

Запуск:

python main.py

Настройки

Можно менять пороги рейтинга и количества оценок:

python main.py --min-rating 7.2 --min-votes 1000

Можно расширить или сузить годы:

python main.py --year-from 2020 --year-to 2026

По умолчанию в Excel попадают поля:

• название на русском
• описание на русском
• название ресурса
• год
• страна
• рейтинг

Также добавлены полезные поля: тип, количество оценок и ссылка.