TG_AutoPoster

Бот, пересылающий записи из групп ВК в канал/чат/ЛС в Telegram.

Python Version

Установка (обновление)

pip3 install -U TG-AutoPoster

Настройка

Создайте файл config.yaml, скопируйте в него содержимое файла config.yaml.example и выполните настройку ключа vk

Параметр	Описание
login	Логин ВК
pass	Пароль ВК
token (необязательно)	Рекомендуется к использованию. Cервисный ключ доступа или ключ доступа пользователя (подробнее). Если он задан, то логин и пароль игнорируются. При его использовании не будут доступны аудиозаписи (при использовании сервисного ключа доступа также не будут доступны истории). Получить ключ доступа пользователя можно с помощью этого сервиса.

Получите ваши api_id и api_hash на https://my.telegram.org/apps и настройте ключ telegram (подробнее об Telegram API Keys здесь)

Параметр	Описание
api_id	App api_id
api_hash	App api_hash
bot_token	Токен Telegram бота, полученный у @BotFather

Если необходимо, настройте использование SOCKS5 прокси, добавив ключ proxy со следующим содержимым:

Параметр	Возможные значения	Описание
enabled	true, false	Использовать ли прокси
hostname		IP адрес (или домен) прокси сервера
port		Порт прокси сервера
username (необязательно)		Имя пользователя
password (необязательно)		Пароль

Запуск

Для запуска используйте консольную команду python3 -m TG_AutoPoster
Активируйте бота в чате командой /start

Автопостинг рекомендуется настраивать через чат с ботом. Подробнее можно узнать, отправив боту команду /help

Для доступных параметров командой строки используйте python3 -m TG_AutoPoster --help

По умолчанию бот проверяет группы на наличие новых постов раз в час. Если необходимо изменить период проверки постов запустите бота с параметром командной строки --sleep N, где N — значение в секундах. Не рекомендуется устанавливать малое значение, так как это может привести к заморозке страницы ВК (подробнее).

Описание настроек группы

Параметр	Описание
channel	Один или несколько ID каналов/чатов в Telegram, в которые отправлять посты из групп ВК
last_id (необязательно)	ID последнего отправленного поста. Если параметр отсутствует, он будет добавлен автоматически со значением 0
pinned_id (необязательно)	ID закреплённого поста.
last_story_id (необязательно)	ID последней отправленной истории.
use_long_poll (необязательно)	Использовать Long Poll API для получения постов из своей группы (или в которой вы являетесь администратором) в режиме реального времени. Чтобы использовать Long Poll API, откройте раздел «Управление сообществом», на вкладке «Работа с API»→«Long Poll API» выберите «Включено», «Версия API»: 5.131. Также необходимо включить тип события «Записи на стене»: «Добавление» на вкладке «Типы событий». Значение параметра по умолчанию: `false`

Описание настроек автопостинга (ключ `settings`)

Параметр	Возможные значения	Описание
sign_posts	true, false	Указывать ли автора поста (если это возможно) и ссылку на оригинальный пост. По умолчанию: `true`
send_reposts	false, post_only, true	Отправлять ли репосты? Подробнее в config.yaml.example. По умолчанию отправка репостов отключена.
send_stories	false, true	Отправлять ли истории? По умолчанию: `false`
what_to_send	all, text, link, photo, doc, video, music, polls	Какие типы вложений отправлять. Подробнее в config.yaml.example. По умолчанию отправляются все вложения.
stop_list		Абсолютный путь к файлу, содержащий стоп-слова (по одному слову на каждой строке). Если вы не хотите использовать стоп-слова удалите этот параметр из файла конфигурации
invert_stop_list	true, false	Инвертировать список стоп-слов (по умолчанию отключено). Будут отправляться посты, в которых содержатся указанные в списке слова или регулярные выражения
blacklist		Абсолютный путь к файлу, содержащий слова, которые будут удалены из текста отправляемого поста. Поддерживаются регулярные выражения.
disable_notification	true, false	Отправляет сообщения молча. Пользователи получат уведомление без звука. По умолчанию: `false`
disable_web_page_preview	true, false	Отключить предпросмотр ссылок в сообщениях. По умолчанию: `true`
posts_count		Количество отправляемых ботом новых постов за раз. По умолчанию 11.
header	Текст с форматированием Markdown	Текст, который будет добавлен в начало сообщения
footer	Текст с форматированием Markdown	Текст, который будет добавлен в конец сообщения

Все параметры ключа settings могут быть заданы индивидуально для каждой группы

Дополнительно: Использование Docker контейнера

Отчеты об ошибках и предложения отправлять в:

GitHub Issues
Telegram: @QwertyAdrian

Для пожертвований на развитие проекта:

Bitcoin: 1H1UVnXgvcLo3RWmxuYmi7b16ADo6XBWw5
TON: EQD42Z5d8d1gT1uSpKTAaLYHlQ95vdMXrlNlYMpSFpQawwuY

Metadata

Release files for TG-AutoPoster 3.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for TG-AutoPoster 3.6.1
File	Size	Uploaded
tg_autoposter-3.6.1.tar.gz	70.1 kB	Oct 14, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for TG-AutoPoster 3.6.1
File	Interpreter	ABI	Platform	Reset
tg_autoposter-3.6.1-py3-none-any.whl 82.4 kB Oct 14, 2025	Python 3	none	any	Details

Total release size: 152.5 kB

Release files / tg_autoposter-3.6.1.tar.gz

Download URL	tg_autoposter-3.6.1.tar.gz
Size	70.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`a41e418e3bfa9e0beaa5424ded79dc13d35ea9d7858da740d699d3259b9394ff`
BLAKE2b-256 checksum How to use checksums	`9a9a8b2b58514fda82e1da9c887e92c2adc95ad24510afc0cfc3a671aec847dc`
Upload date	Oct 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / tg_autoposter-3.6.1-py3-none-any.whl

Download URL	tg_autoposter-3.6.1-py3-none-any.whl
Size	82.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ffc8a0584827008add554d92e466d084280fbca98b9b26a3829e5e07f55f4244`
BLAKE2b-256 checksum How to use checksums	`b0e040434b6f95718cae93f5aaf286f9799c9967a6fc30ee3b0a45c648d35ce5`
Upload date	Oct 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`