# feedwatch

Мониторинг чужих публичных Instagram-аккаунтов и Telegram-каналов для
Claude Code: еженедельный отчёт в Telegram (о чём писали, что залетело
по лайкам, комментам и просмотрам) + ежедневный пульс (пост резко
набирает выше медианы своего аккаунта/канала). В каждой строке отчёта —
ссылка на пост.

## Как это работает

- Instagram-данные собираются через **Apify** (любые публичные аккаунты,
  платно) или **Meta Graph API** (бесплатно, только бизнес/креатор-аккаунты)
  — выбор при настройке.
- Telegram-данные собираются через **web** (веб-превью t.me: бесплатно,
  без ключей, посты + просмотры + реакции + подписчики; комментарии
  недоступны) или **TGStat** (нужен платный токен, лимиты по тарифу;
  отдаёт только просмотры) — выбор при настройке.
- Всё хранится локально в SQLite. «Залетело» считается от **медианы**
  лайков/комментов/просмотров конкретного аккаунта или канала за последние
  30 дней — маленькие и большие аккаунты сравниваются честно, в кратных:
  «×2.4 от медианы».
- Отчёты приходят в Telegram через вашего собственного бота.
- Выжимку «о чём писали» пишет Claude (headless). Если вызов не сработал —
  отчёт приходит без неё, только метрики.

## Установка

1. Нужен [Claude Code](https://claude.com/claude-code) и Python 3.9+.
2. Склонируйте репо в папку скиллов:
   `git clone https://github.com/Natalyyyy/feedwatch ~/.claude/skills/feedwatch`
3. Откройте Claude Code и скажите: **«настрой мониторинг соцсетей»** —
   дальше он сам: спросит про платформы и источники, поможет получить ключи,
   создать Telegram-бота, соберёт первые данные и (по желанию) поставит
   расписание.

## Команды после настройки

Говорите Claude: «отчёт по инстаграму», «отчёт по каналам», «проверь
пульс», «добавь @X в мониторинг», «добавь канал @X», «выключи
автоматику», «обнови токен инстаграма».

## Стоимость

- **Apify**: ~$2.5–3 за 1000 постов. 10 аккаунтов + ежедневный пульс ≈
  $8–10/мес. Бесплатного кредита ($5/мес) хватит попробовать.
- **Meta Graph API**: бесплатно, но настройка сложнее (нужны свой
  IG-бизнес-аккаунт и приложение Facebook) и токен надо обновлять раз в 60 дней.
- **Telegram (web)**: бесплатно, без регистраций.
- **TGStat**: по тарифам tgstat.ru.
- **Claude**: автоматический еженедельный отчёт тратит лимиты вашей подписки.

## Дисклеймер

Скрейпинг Instagram через Apify нарушает условия использования Меты —
используете на свой риск. feedwatch следит только за постами ленты —
сторис не собираются ни на одном источнике, это вне возможностей
инструмента. Meta Graph API — легальный путь, но с дополнительными
ограничениями (только бизнес/креатор-аккаунты и не отдаёт просмотры
чужих рилсов — их показывает только Apify).
Веб-превью t.me — публичные данные, которые Telegram отдаёт без
авторизации; TGStat — официальный API по их тарифам. Каналы со скрытым
превью через web-источник недоступны.
Проект не аффилирован с Meta. Meta признана экстремистской организацией
и запрещена на территории РФ.

## Лицензия

MIT — см. [LICENSE](LICENSE).