VKover
Telegram-стильная библиотека-юзербот для ВКонтакте на веб-токенах (api.vk.ru, Long Poll v3).
VK API после сентября 2026 закрыл сторонние приложения и токены Kate/Маруся. VKover работает как настоящий веб-клиент: логин через браузер один раз, дальше — REST API + Long Poll.
Установка
pip install .
Первый запуск (получение токена)
vkover-login --profile ./vk_profile --token-file ./web_token.json
Откроется Chromium (нужен Xvfb на сервере). Войдите в аккаунт VK. Токен появится в web_token.json.
Использование
from vkover import VKover, NewMessage
vk = VKover.from_files("web_token.json", profile_dir="./vk_profile")
@vk.on(NewMessage)
async def handler(event):
print(event.peer_id, event.text)
vk.run()
Отправка и запросы:
vk.send(peer_id=100, text="привет")
vk.send_message_request(100, "сообщение", reply_to_cmid=5)
vk.send_reaction_request(100, cmid=5, reaction_id=3)
vk.delete_reaction_request(100, cmid=5)
vk.edit_message_request(100, message_id=6692, text="исправлено")
vk.delete_message_request([6692, 6693])
vk.forward_request(100, [11, 12], "пересылка")
vk.set_typing_request(100)
vk.request("messages.getConversations", count=20)
Токены и продление
Веб-токен живёт ~сутки. При передаче profile_dir в VKover.from_files библиотека автоматически открывает headless-Chromium и обновляет токен из localStorage профиля.
Тесты и бенчмарки
pip install pytest pytest-benchmark
pytest tests/ -q
Metadata
Release files for vkover 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vkover-0.1.0.tar.gz | 22.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vkover-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.9 kB
Release files / vkover-0.1.0.tar.gz
| Download URL | vkover-0.1.0.tar.gz |
|---|---|
| Size | 22.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
311c4f25053fd1301e8158f29ef97b5c6dc9fca216c6d993e1e4fe0e64e7056c
|
|
BLAKE2b-256 checksum How to use checksums |
f8c28c63236d9199bb5f70edbaf8c4d63f9a28cd2bd07412cd9c84cac2ae2adf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / vkover-0.1.0-py3-none-any.whl
| Download URL | vkover-0.1.0-py3-none-any.whl |
|---|---|
| Size | 24.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
98195f53350804cf890e095d86d7821e5cea824e8ebf60e0950850dd08d5a33d
|
|
BLAKE2b-256 checksum How to use checksums |
27a392222304ed818d42dd529689fc1b30e374a03a63e3df30e19f7380453c40
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|