Перейти к содержанию

ScrapperAD

Telegram-бот для слежки за рекламой конкурентов. Собирает активные объявления из Meta Ad Library (Facebook/Instagram) через Apify, делает AI-разбор через Gemini, генерирует PDF/TXT отчёты. Сильнейший проект в портфолио.

  • Репозиторий: github.com/Moody-code365/ScrapperAD
  • Полная архитектура: ARCHITECTURE.md — подробный decision-log: почему polling, пул Apify-ключей, кэш на 24ч, Stars вместо карт, white-label PDF и т.д.

Стек

Python 3.12 · aiogram 3 (async) · Apify (парсинг Ad Library) · Google Gemini 2.5 Flash (AI) · fpdf2 + DejaVuSans (PDF с кириллицей) · SQLite + WAL · Docker + compose.

Ключевые решения (кратко)

  • Polling, не webhook — не нужен публичный HTTPS, проще деплой.
  • Пул Apify-ключей с автопереключением при исчерпании лимита — обход бюджета на старте.
  • Кэш результатов на 24ч — повторные просмотры бесплатны, не жрут лимит Apify.
  • Оплата Telegram Stars — без юрлица и эквайринга; реквизиты карт только в DM.
  • White-label PDF — название агентства и логотип в шапке отчёта для Pro/Enterprise.

Полное обоснование каждого решения — в ARCHITECTURE.md репозитория.

Деплой

git pull
docker compose up -d --build

data/ смонтирован как volume — SQLite-база и кэш переживают пересборку образа.