🤖 Threads Bot - Автоматична публікація з Telegram у Threads

🚀 Швидкий старт

Запуск/зупинка бота:

./bot_manager.sh start      # Запустити бота
./bot_manager.sh stop       # Зупинити бота
./bot_manager.sh restart    # Перезапустити бота
./bot_manager.sh status     # Перевірити статус

Перегляд логів:

tail -f threads_bot.log     # Дивитись логи в реальному часі
tail -100 threads_bot.log   # Останні 100 рядків

📱 Адмін-панель (Telegram)

Надішли боту (@threadskgnvsk_bot) у особисті повідомлення:

Основні команди:

• /start - Відкрити адмін-панель з кнопками
• 📊 Статус - Поточний стан бота
• 📈 Статистика - Звіт по постах
• 📝 Логи - Останні операції
• ❌ Помилки - Тільки помилки
• ▶️ Запустити / ⏸️ Зупинити - Увімкнути/вимкнути автопублікацію
• 🔧 API Статус - Перевірка всіх API
• 💬 Промо текст - Налаштування рекламного тексту
• ❓ Допомога - Список всіх команд

⚙️ Що робить бот?

1. Слухає канал: @kagreservai
2. Автоматично публікує у Threads:
   • 📝 Текстові пости (з розбиттям через GPT-4.1)
   • 📸 Фото з описом
   • 🎥 Відео з описом
   • 📦 Медіа групи (карусель)
3. Обробляє текст:
   • Видаляє "Джерело" в кінці
   • Розбиває довгі тексти через GPT
   • Додає рекламний пост в кінець гілки
4. Завантажує медіа:
   • Фото → Telegraph / Catbox
   • Відео → Imgur

☁️ Розгортання на сервері 24/7

⚠️ ВАЖЛИВО: Якщо твій комп'ютер засне/вимкнеться - бот зупиниться!
Для роботи 24/7 потрібен хмарний сервер.

🚀 Швидке розгортання:

# Створи сервер (AWS/Hetzner/DigitalOcean)
# Потім запусти:
./deploy_to_server.sh user@your-server-ip

📖 Детальні інструкції:

• ⚡ QUICKSTART_SERVER.md - швидкий старт
• 🌐 DEPLOY_SERVER.md - повні інструкції всіх платформ
• 🏠 SETUP_24_7.md - налаштування локально (macOS/Linux)

💰 Рекомендовані хостинги:

• AWS EC2 - безкоштовно 12 місяців
• Hetzner - €4.15/міс (найдешевше)
• Google Cloud - безкоштовно назавжди (e2-micro)

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

Threads/
├── bot.py                    # Основний файл бота
├── bot_manager.sh           # Скрипт управління (використовуй це!)
├── config.py                # Налаштування (токени, API ключі)
├── database.py              # База даних (статистика)
├── threads_api.py           # Threads API клієнт
├── text_splitter.py         # GPT-4.1 розбиття текстів
├── media_uploader.py        # Завантаження медіа
├── bot.pid                  # PID файл (автоматичний)
├── bot_data.db              # SQLite база даних (автоматична)
├── threads_bot.log          # Логи
├── threads-bot.service      # Systemd service (Linux)
├── com.threads.bot.plist    # Launchd service (macOS)
├── README.md                # Ця інструкція
└── SETUP_24_7.md            # Детальні інструкції 24/7

⚠️ ВАЖЛИВО

✅ ЗАВЖДИ використовуй:

• ./bot_manager.sh start - запуск
• ./bot_manager.sh stop - зупинка
• ./bot_manager.sh status - перевірка

❌ НІКОЛИ НЕ запускай вручну:

• ❌ python3 bot.py - може створити дублікати
• ❌ nohup python3 bot.py & - немає контролю
• ❌ Кілька запусків підряд

🐛 Діагностика

Бот не відповідає?

./bot_manager.sh restart

Помилки в логах?

tail -50 threads_bot.log | grep ERROR

Кілька процесів?

killall -9 python3
rm -f bot.pid
./bot_manager.sh start

Telegram конфлікт?

./bot_manager.sh stop
sleep 60  # Чекаємо 1 хвилину
./bot_manager.sh start

📞 Підтримка

• Логи: threads_bot.log
• Статистика: База даних bot_data.db
• Telegram: @kgnvsk

🔐 Безпека

Не коммить в Git:

• config.py (токени!)
• bot.pid
• bot_data.db
• threads_bot.log
• .env

Використовуй .gitignore:

bot.pid
bot_data.db
threads_bot.log
*.pyc
__pycache__/
.env
config.py