https://github.com/megamen32/autopost_telegram_vk_max
Automatic post synchronization(cross-posting) between social platforms
https://github.com/megamen32/autopost_telegram_vk_max
crossposting max self-hosted telegram vk
Last synced: about 1 month ago
JSON representation
Automatic post synchronization(cross-posting) between social platforms
- Host: GitHub
- URL: https://github.com/megamen32/autopost_telegram_vk_max
- Owner: megamen32
- Created: 2026-04-01T13:06:22.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-12T13:47:18.000Z (3 months ago)
- Last Synced: 2026-04-12T14:12:19.952Z (3 months ago)
- Topics: crossposting, max, self-hosted, telegram, vk
- Language: Python
- Homepage: https://autopost.bezrabotnyi.com
- Size: 410 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AutoPost Sync
> **Автоматически копируй посты между Telegram, VK и MAX через удобный интерфейс**
[🇷🇺 Русский](#русский) | [🇬🇧 English](#english)
---
## 🇷🇺 Русский
### 💡 Что это?
**AutoPost Sync** — это приложение для автоматической синхронизации постов между социальными платформами.
**Примеры использования:**
📱 **Для контент-мейкеров:**
- Опубликовал пост в Telegram → он сам появится в VK и MAX
- Экономишь время на ручное копирование постов
- Один контент — все платформы сразу
📊 **Для сообществ:**
- Синхронизируй новости с основного канала на все соцсети
- Управляй всеми платформами с одного места
- Не пропусти ничего
🤖 **Для ботов:**
- Настрой бота один раз
- Он будет автоматически публиковать везде
- Никакого кода не нужно писать
### 🎯 Как это работает?
```
┌─────────────────┐
│ Твой пост в │
│ Telegram │
└────────┬────────┘
│
↓ (автоматически)
│
┌────▼────────────────────┐
│ AutoPost настроил │
│ "Копировать в VK, MAX" │
└────┬────────────────────┘
│
├─→ VK группа
├─→ MAX чат
└─→ Другие платформы
```
### ✨ Основные преимущества
✅ **Просто в использовании** — интуитивный веб-интерфейс, без команд
✅ **Все платформы** — Telegram, VK, MAX в одном месте
✅ **Автоматизация** — один раз настроил, потом работает само
✅ **Медиа поддержка** — фото, видео, документы копируются автоматически
✅ **Умная защита** — не создаёт дубли, блокирует циклы
✅ **Безопасно** — все токены зашифрованы в базе
### 🚀 Быстрый старт (2 команды)
```bash
# 1. Скачай проект
git clone https://github.com/megamen32/autopost_telegram_vk_max.git && cd autopost_telegram_vk_max
# 2. Запусти (Docker автоматически скачает всё нужное)
docker compose up
```
Готово! Открой в браузере: **http://localhost:8000**
### 📋 Настройка (3 шага в интерфейсе)
#### Шаг 1️⃣ Добавь Telegram
Открой http://localhost:8000 → кнопка "➕ Добавить адаптер" → выбери "Telegram"
В форме заполни:
- **Display Name:** "Мой Telegram" (просто имя для себя)
- **API ID:** твой номер
- **API Hash:** скопируй из кабинета
- **Bot Token:** (опционально) если хочешь бота
Где взять данные:
1. Перейди https://my.telegram.org/apps
2. Создай приложение
3. Скопируй **API ID** и **API Hash** в поле
4. (Опционально) Для бота добавь токен от @BotFather
#### Шаг 2️⃣ Добавь VK
Открой http://localhost:8000 → кнопка "➕ Добавить адаптер" → выбери "VK"
В форме заполни:
- **Display Name:** "Моя VK" (имя для себя)
- **VK Group ID:** ID твоей группы (можно вставить ссылку — число извлечётся автоматически)
- **VK ID Client ID:** ID приложения из кабинета VK ID
Где взять данные:
1. Перейди в [кабинет VK ID](https://id.vk.ru/business)
2. Создай приложение типа **Web**
3. Укажи базовый домен и redirect URL: `https://autopost.bezrabotnyi.com/auth/vk/callback`
4. Скопируй **ID приложения (client_id)**
5. В разделе **Доступы** включи нужные права (`photos`, `video`, `wall`, `groups` для публикации медиа)
**Важно:** Для публикации фото/видео требуется подтвердить профиль бизнеса в VK ID. Без верификации доступны только базовые права (`vkid.personal_info`).
**Авторизация в сообщество:**
После добавления VK адаптера нажми кнопку **"Установить в сообщество"** — это установит приложение в твою группу VK и даст права на публикацию медиа (`manage,photos`).
#### Шаг 3️⃣ Создай синхронизацию
Открой http://localhost:8000 → кнопка "➕ Новое правило синхронизации"
Выбери:
- **Откуда:** Telegram (выбери инстанс "Мой Telegram")
- **Куда:** VK (выбери инстанс "Моя VK")
- **Контент:** поставь галочки что нужно:
- ✅ Текст (всегда копируется)
- ✅ Фото (загружаются в VK)
- ✅ Видео (загружаются в VK)
Нажми **"Сохранить"** → готово!
Теперь все посты из Telegram будут автоматически публиковаться в VK! 🎉
### ⚠️ Важные ограничения платформ
**Telegram:**
- ✅ Полная поддержка
- Нужно API ID и API Hash (берётся в кабинете разработчика)
**VK:**
- ✅ Полная поддержка
- Можно вставить ссылку на группу — ID извлечётся автоматически
- Требуется приложение в [кабинете VK ID](https://id.vk.ru/business)
- Для публикации фото/видео нужен подтверждённый профиль бизнеса
- Кнопка **"Установить в сообщество"** даёт права на публикацию медиа
**MAX:**
- ⚠️ **Важно:** Доступно только для юридических лиц (ИП, ООО и т.д.)
- Требуется быть резидентом РФ
- Нужно пройти верификацию в [dev.max.ru](https://dev.max.ru/docs/chatbots/bots-coding/prepare)
- Подробнее: https://dev.max.ru/docs/chatbots/bots-coding/prepare
### ❓ Частые вопросы
**Нужно ли мне быть программистом?**
Нет! Весь интерфейс — веб-приложение с кнопками и формами. Никакого кода писать не нужно.
**Что если я что-то неправильно настроил?**
Можешь всегда переделать в интерфейсе. Все настройки хранятся в базе и легко редактируются.
**Где мои токены и пароли?**
Все токены зашифрованы в базе данных. Никто их не видит и не сохраняет.
**Что будет если выключить сервер?**
Когда ты его снова включишь, он продолжит с того же места. Никакие посты не потеряются.
**Это бесплатно?**
Да, это Open Source проект под лицензией MIT.
### 📚 Полная документация
Нужна помощь? Смотри подробные гайды:
- 🚀 [Детальный гайд по установке](docs/INSTALLATION.md) — для разных ОС и серверов
- 🔌 [Гайд для каждой платформы](docs/README.md) — специфика Telegram, VK, MAX
- ❓ [FAQ и примеры](docs/README.md) — ответы на частые вопросы
- 👨💻 [Для разработчиков](docs/ARCHITECTURE.md) — как работает изнутри
Для расширенной настройки каждой платформы:
- [Telegram](app/adapters/telegram/README.md)
- [VK](app/adapters/vk/README.md)
- [MAX](app/adapters/max/README.md)
### 💻 Требования к серверу
- **Минимум:** 2GB RAM, 10GB дискового пространства
- **ОС:** Linux, macOS или Windows с Docker
- **Браузер:** Chrome, Firefox, Safari, Edge (любой современный)
### 📄 Лицензия
MIT License — используй как хочешь, даже в коммерческих целях.
---
## 🇬🇧 English
### 💡 What is this?
**AutoPost Sync** is an app for automatic synchronization of posts between social media platforms.
**Use cases:**
📱 **For content creators:**
- Post once in Telegram → it appears automatically in VK and MAX
- Save time on manual copying
- One content → all platforms at once
📊 **For communities:**
- Sync news from main channel to all social media
- Manage all platforms from one place
- Never miss anything
🤖 **For bots:**
- Set up bot once
- It will automatically publish everywhere
- No coding needed
### 🎯 How it works?
```
┌─────────────────┐
│ Your post in │
│ Telegram │
└────────┬────────┘
│
↓ (automatically)
│
┌────▼────────────────────┐
│ AutoPost configured │
│ "Copy to VK, MAX" │
└────┬────────────────────┘
│
├─→ VK group
├─→ MAX chat
└─→ Other platforms
```
### ✨ Key Features
✅ **Easy to use** — web interface with buttons and forms, no commands
✅ **All platforms** — Telegram, VK, MAX in one place
✅ **Automation** — set once, it works by itself
✅ **Media support** — photos, videos, documents copy automatically
✅ **Smart protection** — no duplicates, blocks loops
✅ **Secure** — all tokens encrypted in database
### 🚀 Quick Start (2 commands)
```bash
# 1. Download the project
git clone https://github.com/yourusername/autopost_sync.git && cd autopost_sync
# 2. Run (Docker automatically downloads everything needed)
docker compose up
```
Done! Open in browser: **http://localhost:8000**
### 📋 Setup (3 steps in interface)
#### Step 1️⃣ Add Telegram
Open http://localhost:8000 → click "➕ Add adapter" → select "Telegram"
Fill in the form:
- **Display Name:** "My Telegram" (name for yourself)
- **API ID:** your number
- **API Hash:** copy from developer cabinet
- **Bot Token:** (optional) if you want a bot
Get credentials:
1. Go to https://my.telegram.org/apps
2. Create an app
3. Copy **API ID** and **API Hash**
4. (Optional) Add bot token from @BotFather
#### Step 2️⃣ Add VK
Open http://localhost:8000 → click "➕ Add adapter" → select "VK"
Fill in the form:
- **Display Name:** "My VK" (name for yourself)
- **VK Group ID:** your group ID (you can paste a URL — the number will be extracted automatically)
- **VK ID Client ID:** App ID from VK ID cabinet
Get credentials:
1. Go to [VK ID cabinet](https://id.vk.ru/business)
2. Create a **Web** application
3. Specify base domain and redirect URL: `https://autopost.bezrabotnyi.com/auth/vk/callback`
4. Copy **App ID (client_id)**
5. In **Access** section enable required permissions (`photos`, `video`, `wall`, `groups` for media publishing)
**Important:** For photo/video publishing you must verify your business profile in VK ID. Without verification only basic permissions are available (`vkid.personal_info`).
**Community Authorization:**
After adding the VK adapter, click **"Install to community"** button — this installs the app to your VK group and grants media publishing rights (`manage,photos`).
#### Step 3️⃣ Create Sync Rule
Open http://localhost:8000 → click "➕ New sync rule"
Select:
- **From:** Telegram (select "My Telegram")
- **To:** VK (select "My VK")
- **Content:** check what you need:
- ✅ Text (always copied)
- ✅ Photos (uploaded to VK)
- ✅ Videos (uploaded to VK)
Click **"Save"** → done!
Now all posts from Telegram automatically publish to VK! 🎉
### ⚠️ Platform Limitations
**Telegram:**
- ✅ Full support
- Need API ID and API Hash (from developer cabinet)
**VK:**
- ✅ Full support
- You can paste a group URL — ID will be extracted automatically
- Requires app in [VK ID cabinet](https://id.vk.ru/business)
- Business profile verification required for photo/video publishing
- **"Install to community"** button grants media publishing rights
**MAX:**
- ⚠️ **Important:** Available only for legal entities (LLC, self-employed, etc.)
- Must be a resident of Russia
- Verification required at [dev.max.ru](https://dev.max.ru/docs/chatbots/bots-coding/prepare)
- Details: https://dev.max.ru/docs/chatbots/bots-coding/prepare
### ❓ FAQ
**Do I need to be a programmer?**
No! The entire interface is a web app with buttons and forms. No coding required.
**What if I configure something wrong?**
You can always change it in the interface. All settings are stored in database and easily editable.
**Where are my tokens and passwords?**
All tokens are encrypted in the database. No one sees or stores them.
**What happens if I turn off the server?**
When you turn it back on, it continues from where it left off. No posts are lost.
**Is this free?**
Yes, it's an Open Source project under MIT license.
### 📚 Full Documentation
Need help? Check detailed guides:
- 🚀 [Detailed installation guide](docs/INSTALLATION.md) — for different OS and servers
- 🔌 [Guide for each platform](docs/README.md) — specifics for Telegram, VK, MAX
- ❓ [FAQ and examples](docs/README.md) — answers to common questions
- 👨💻 [For developers](docs/ARCHITECTURE.md) — how it works inside
For platform-specific setup:
- [Telegram](app/adapters/telegram/README.md)
- [VK](app/adapters/vk/README.md)
- [MAX](app/adapters/max/README.md)
### 💻 Server Requirements
- **Minimum:** 2GB RAM, 10GB disk space
- **OS:** Linux, macOS or Windows with Docker
- **Browser:** Chrome, Firefox, Safari, Edge (any modern)
### 📄 License
CC BY-NC-SA
-BY (Attribution): Вы должны указать автора, ссылку на лицензию и отметить, если вы внесли изменения.
-NC (Non-Commercial): Вы не имеете права использовать этот материал в коммерческих целях (для получения прибыли). Это касается как самого оригинала, так и любых производных работ на его основе.
-SA (ShareAlike): Если вы перерабатываете, изменяете или развиваете этот материал, вы обязаны распространять свой результат только под этой же лицензией (CC BY-NC-SA).