https://github.com/bartin69/telegram-bot-for-match-films
Telegram-бот для поиска фильмов и мэтчей их с другими людьми
https://github.com/bartin69/telegram-bot-for-match-films
api bot films postgresql postgresql-database telegram telegram-bot
Last synced: 9 months ago
JSON representation
Telegram-бот для поиска фильмов и мэтчей их с другими людьми
- Host: GitHub
- URL: https://github.com/bartin69/telegram-bot-for-match-films
- Owner: Bartin69
- Created: 2025-03-08T21:11:12.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-11T18:36:59.000Z (over 1 year ago)
- Last Synced: 2025-03-14T10:17:29.542Z (over 1 year ago)
- Topics: api, bot, films, postgresql, postgresql-database, telegram, telegram-bot
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Telegram-бот, который помогает пользователям находить фильмы, добавлять их в избранное, а также находить общие фильмы с другими пользователями. Бот использует API Кинопоиска для получения информации о фильмах и PostgreSQL для хранения данных пользователей.
# 📋 Описание функционала
Основные функции бота:
1) Поиск фильмов:
- Бот случайным образом выбирает фильм из базы данных Кинопоиска и показывает его пользователю.
- Пользователь может поставить лайк фильму или пропустить его.
2) Лайки фильмов:
- Пользователь может добавлять понравившиеся фильмы в список избранного.
- Все лайки сохраняются в базе данных.
3) Привязка к другим пользователям:
- Пользователь может добавить другого пользователя в список привязок, указав его username.
- После добавления привязки можно искать общие фильмы с этим пользователем.
4) Поиск общих фильмов:
- Бот показывает список фильмов, которые понравились обоим пользователям (на основе лайков).
5) Управление привязками:
- Пользователь может просматривать, добавлять и удалять привязки к другим пользователям.
# 🛠️ Требования для запуска
Для запуска бота вам потребуется:
1) Python 3.8 или выше.
2) Установленные библиотеки:
- **python-telegram-bot** (для работы с Telegram API).
- **psycopg2** (для работы с PostgreSQL).
- **requests** (для запросов к API Кинопоиска).
3) База данных PostgreSQL.
4) API-ключ Кинопоиска (можно получить на [официальном сайте](https://kinopoiskapiunofficial.tech/).
# ⚙️ Установка и настройка
1) Клонируйте репозиторий:
```sh
git clone https://github.com/ваш-username/TG-Bot-for-match-films.git
cd название-репозитория
2) Установите зависимости:
```sh
pip install -r requirements.txt
3) Настройте конфигурацию:
- Отредактируйте файл config.py в корневой директории проекта.
- Добавьте в него свои данные
4) Инициализируйте базу данных:
- Запустите скрипт для создания необходимых таблиц в PostgreSQL:
```sh
python bot.py
- Убедитесь, что таблицы users_tg, likes и connections созданы.
5) Запустите бота:
```sh
python bot.py
# 🚀 Использование бота
1) Запустите бота в Telegram, отправив команду /start.
2) Используйте кнопки меню для взаимодействия с ботом:
- 🔗 Добавить привязку: Добавьте другого пользователя по его username.
- 📋 Показать привязки: Просмотрите список привязанных пользователей.
- ❌ Удалить привязку: Удалите привязку к другому пользователю.
- 🎬 Показать фильм: Получите случайный фильм из базы Кинопоиска.
- ❤️ Лайк: Добавьте фильм в избранное.
- ➡️ Скип: Пропустите текущий фильм и получите следующий.
- 🔙 Назад: Вернитесь в главное меню.
# 📂 Структура проекта
.
├── bot.py # Основной файл с логикой бота
├── config.py # Файл с конфигурационными данными
├── README.md # Документация проекта
├── requirements.txt # Список зависимостей
# 📧 Контакты
Если у вас есть вопросы или предложения, свяжитесь со мной:
- Telegram: @lookatheart