Skip to content

AR4I-XD/short_link

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Short_Link

Telegram-бот для сокращения ссылок через VK API и получения статистики переходов.


Установка

  1. Склонируйте репозиторий или скопируйте файлы проекта:

    git clone https://github.com/AR4I-XD/short_link
    cd short_link
  2. Создайте и заполните файл .env в корне проекта:

    TELEGRAM_TOKEN=<ваш_токен_бота_от_BotFather>
    VK_TOKEN=<ваш_сервисный_токен_вк>
    
    • Получить VK-токен можно в кабинете разработчика ВКонтакте.
    • Укажите тип приложения “Web”, домен и Redirect URL по инструкции ВК.
  3. Установите зависимости:

    pip install -r requirements.txt
  4. Передайте файлы на сервер (например, через FileZilla) и запустите бота под PM2:

    pm2 start short_link.py

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

  1. Откройте чат с ботом и введите:

    /start
    

    Для вывода списка доступных команд.

  2. Сократить ссылку:

    /shorten
    

    Бот попросит отправить длинный URL. Введите его, и бот вернёт укороченную версию.

  3. Получить статистику переходов:

    /stats
    

    Бот попросит отправить короткий URL. Введите его, и бот покажет, сколько раз по нему переходили.

При некорректном вводе URL или сбое API вы увидите сообщение об ошибке (см. рисунок 4).


Примеры

# Сокращение
python short_link.py https://youtu.be/dQw4w9WgXcQ?si=RIyQg54bjmtJPOS
# → https://vk.cc/cDWVsZ

# Статистика
python short_link.py https://vk.cc/cDWVsZ
# → По ссылке переходили 12 раз

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

project_root/
├── short_link.py        # Главный скрипт бота
├── requirements.txt     # Зависимости проекта
├── .env                 # Конфиденциальные токены
└── README.md            # Инструкция по установке и использованию

About

Shortening links using the Vk API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages