🌤️ Weather Telegram Bot

Telegram-бот для получения текущей погоды в любой точке мира. Напишите название города — бот вернёт температуру, влажность и скорость ветра.

Возможности

• Принимает название города текстом (на русском или английском)
• Возвращает: температуру (°C), влажность (%), ветер (км/ч)
• Показывает описание погоды с эмодзи (ясно, дождь, гроза и т.д.)
• Использует Open-Meteo API — бесплатно, без регистрации и API-ключей

Технологии

• Python 3.12+
• python-telegram-bot — фреймворк для Telegram Bot API
• Open-Meteo — бесплатное погодное API (геокодинг + прогноз)

Установка и запуск

1. Клонируйте репозиторий

git clone https://github.com/KsenyaSS/weather-telegram-bot.git
cd weather-telegram-bot

2. Установите зависимости

pip install -r requirements.txt

3. Настройте токен бота

Создайте файл .env в корне проекта:

BOT_TOKEN=ваш_токен_от_BotFather

Получить токен: @BotFather в Telegram.

4. Запустите бота

python bot.py

Использование

1. Найдите бота в Telegram: @your_bot_username
2. Отправьте /start — бот поприветствует вас
3. Напишите название города (например, Москва, London, 東京)
4. Бот пришлёт текущую погоду

Структура проекта

weather-telegram-bot/
├── bot.py           # Основной код бота
├── requirements.txt # Зависимости Python
├── .env             # Токен бота (не коммитится!)
└── README.md        # Документация

API

Бот использует два эндпоинта Open-Meteo:

Эндпоинт	Назначение
geocoding-api.open-meteo.com/v1/search	Поиск координат по названию города
api.open-meteo.com/v1/forecast	Текущая погода по координатам

Open-Meteo полностью бесплатен для некоммерческого использования и не требует API-ключа.

Лицензия

MIT