reel-radar
Skill4 starsChanged 4 months agoMITView on GitHub
Контент-разведка Instagram под съёмку: берёт эталонный аккаунт твоей ниши, сканирует его подписки, вытаскивает залетевшие рилсы за последние 7 дней, фильтрует по ключевым словам ниши, ранжирует композитно (просмотры + комментарии + ER), транскрибирует, сопоставляет с тем, что уже работает на твоём аккаунте, и отдаёт HTML-дашборд с 25 референсами плюс 15 готовых ТЗ на съёмку — телесуфлёр, монтажный timeline, код-слово. Используй этот скилл, когда просят найти рилсы, сделать разведку рилсов, придумать что снимать, собрать референсы или идеи для съёмки, разобрать что залетает у конкурентов в Instagram, подготовить ТЗ для съёмки на неделю — даже если слово «reel-radar» не произнесено. НЕ для: публикации в Instagram, накрутки, сбора персональных данных, YouTube и TikTok.
- Reads credentials
In this repository43 other files it gives its agents.
- agent-browserSkill
- agent-introspectionSkill
- agentos-contentSkill
- carousel-instagramSkill
- chat-archiveSkill
- codex-imageSkill
- content-engineSkill
- cross-reviewSkill
- datawrapperSkill
- dev-pipelineSkill
- excalidrawSkill
- fast-loop-codingSkill
- groq-voiceSkill
- higgsfield-generateSkill
- higgsfield-marketplace-cardsSkill
- higgsfield-product-photoshootSkill
- higgsfield-soul-idSkill
- instagram-superpowerSkill
- learningsSkill
- loop-codingSkill
- markdown-newSkill
- mcp-api-buildSkill
- mcp-builderSkill
- memory-auditSkill
- miro-boardSkill
- perplexity-researchSkill
- presentSkill
- reels-analytics-for-brokersSkill
- reelsSkill
- remote-agent-desktopSkill
- security-auditSkill
- senior-brainstormSkill
- seo-tuneSkill
- server-doctorSkill
- telegram-chipSkill
- threads-contentSkill
- topic-monitorSkill
- transcriptSkill
- twitterSkill
- workshopSkill
- youtube-producerSkill
- youtube-thumbnailSkill
- yt-researchSkill
The file
Files
Reel Radar — разведка рилсов под съёмку
Пайплайн: подписки эталонного аккаунта → свежие рилсы → фильтр по нише → ранжирование → транскрипция → сопоставление с твоим аккаунтом → артефакты для съёмки.
Скилл отвечает на один вопрос: что снимать на этой неделе. Не «какие рилсы хорошие вообще», а «какие форматы прямо сейчас залетают у аккаунтов, за которыми следит твоя ниша, и какие из них ложатся на твой аккаунт».
Когда запускать
- Нужны идеи и референсы под съёмку рилсов
- Планёрка по контенту, нужен запас ТЗ на неделю
- Хочешь понять, какие форматы сейчас работают в нише
Что на выходе
Два типа артефактов, оба HTML (никаких .mp4 на выходе):
dashboard.html— 25 рилсов-референсов: метрики (просмотры, лайки, комментарии, ER), почему залетел (формула), темы и ключевые слова, ссылка на оригинал, сводная таблица с трендами.tz-01.html … tz-15.html— готовые задания на съёмку: телесуфлёр, монтажный timeline с таймкодами, код-слово для CTA, ссылка на оригинал.
Отбор 15 из 25 — по релевантности к топ-рилсам твоего собственного аккаунта за 30 дней. Идея простая: не гнаться за чужим успехом, а взять из чужого успеха то, что уже подтверждено твоей аудиторией.
Что нужно до запуска
| Что | Зачем | Где взять |
| Python 3.9+ | скрипты, только стандартная библиотека | https://python.org |
| FFmpeg | сжатие видео и извлечение аудио | https://ffmpeg.org |
LOORE_API_KEY | данные Instagram через Loore | https://app.loore.ai → Настройки → API и MCP, документация https://docs.loore.ai |
GROQ_KEY | транскрипция (Whisper) | https://console.groq.com |
TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID | доставка артефактов, опционально | @BotFather |
export LOORE_API_KEY="..." # ключ Loore, в чат и в git не попадает
export GROQ_KEY="..." # понимается и GROQ_API_KEY
export TARGET_USER="account" # эталонный аккаунт ниши, без @Ключи — только через переменные окружения. В скилле не лежит ни одного ключа, ни одного аккаунта и ни одного chat_id: без настройки скрипты падают с понятной ошибкой, а не работают «по чужим данным».
Настройка под свою нишу
1. Эталонный аккаунт (TARGET_USER, или target_user в
config/defaults.json, или --username). Это аккаунт, чьи подписки сканируются.
Логика: возьми аккаунт, который сам живёт в нише и подписан на её лидеров — его
лента подписок и есть карта ниши. Обычно это твой собственный рабочий аккаунт.
2. Ключевые слова — config/keywords.txt, по одному на строку, # в начале
строки = комментарий. Матч по границе слова, регистр не важен, работает и для
кириллицы. В комплекте лежит пример под нишу AI/агентов — замени на свою
вокабулярку, иначе фильтр выкинет всё релевантное.
3. Код-слова CTA — по умолчанию восемь примеров в scripts/10-gen-tz.py.
Свои: CODE_WORDS_FILE=/path/words.json в формате [["СЛОВО", "что человек за
это получит"], ...], либо разово на весь батч — FORCE_CTA_CODE +
FORCE_CTA_BENEFIT.
4. Запасной список аккаунтов (опционально) — data/watchlist.example.json
скопируй в data/watchlist.json и заполни своими. Нужен, когда у эталонного
аккаунта закрытые или недоступные подписки: тогда пайплайн идёт по твоему списку.
Переменные окружения целиком
| Переменная | Что делает |
LOORE_API_KEY | ключ Loore (источник данных Instagram), обязателен |
LOORE_SPEND_AUTHORIZATION_ID | одобренный бюджет расхода Loore на прогон, без него платные вызовы останавливаются с 428 |
GROQ_KEY / GROQ_API_KEY | ключ транскрипции, обязателен |
TARGET_USER | эталонный аккаунт, перекрывает конфиг |
TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID | доставка артефактов |
TELEGRAM_EXPECT_BOT | ожидаемый username бота, проверка перед отправкой |
REEL_RADAR_ENV | путь к своему env-файлу вместо <skill>/.env |
TOP_FINAL | сколько ТЗ на выходе, перекрывает top_final |
COMPRESS_THRESHOLD_MB | порог сжатия видео, перекрывает конфиг |
CACHE_TTL_HOURS | время жизни кэша подписок |
CODE_WORDS_FILE | свой список код-слов CTA |
WATCHLIST | свой путь к запасному списку аккаунтов |
FORCE_CTA_CODE, FORCE_CTA_BENEFIT, FORCE_CTA_BRIDGE_LEAD | одинаковый CTA на весь батч |
Остальные пороги и размеры выборок — в config/defaults.json; переменные
окружения имеют приоритет над файлом.
Временное окно
Рилсы подписок: последние 7 дней включая сегодня. Твои собственные рилсы для релевантности: последние 30 дней.
Окно всегда считается от today() и логируется на старте. Даты нигде не
захардкожены — не подставляй их руками.
Процесс (11 шагов)
Скрипты в scripts/, оркестратор scripts/run.sh с поддержкой resume.
1. Подписки эталонного аккаунта (1-fetch-following.py)
Loore ig-following по handle, страницы по 50 через cursor. Кэш на 24 часа,
отдельный файл на каждый аккаунт. Строки списка в Loore не несут bio и число
подписчиков – их добирает шаг 2, и только для тех, у кого есть свежие рилсы.
2. Рилсы по всем найденным аккаунтам (2-fetch-reels.py)
Параллельно (async, semaphore=8): Loore ig-user-reels (одна страница, 20
последних рилсов с подписью), фильтр takenAt по окну 7 дней, сортировка по
просмотрам, топ-3 с аккаунта. Для авторов со свежими рилсами – один ig-profile
(bio и подписчики для фильтра и ER). Закрытые аккаунты пропускаются.
3. Фильтр по ключевым словам (3-filter-relevant.py)
Матч config/keywords.txt против caption, хэштегов и bio автора.
4. Композитное ранжирование (4-rank-composite.py)
rank_views + rank_comments + rank_er, меньше — лучше. Топ-25.
5. Скачать видео (5-download-videos.sh)
Loore ig-download по ссылке рилса → downloadUrl (подписанная ссылка без
ключа, живёт около 15 минут) → curl. Если больше 50 МБ — сжатие ffmpeg
(libx264, crf 28, scale 720).
6. Транскрибация (6-transcribe.sh)
ffmpeg → ogg/opus 64k → Groq whisper-large-v3-turbo. Успех проверяется по HTTP
200, не по grep по тексту.
7. Свои топ-рилсы за 30 дней (7-fetch-own-reels.py)
Тот же clips-эндпоинт для твоего аккаунта, топ-10 по просмотрам.
8. Матч по релевантности (8-relevance-match.py)
Для каждого из 25 кандидатов score 0-100: темы +40, формула +30,
engagement-профиль +30. Топ-15.
9. Дашборд (9-gen-dashboard.py) — по шаблону templates/dashboard.html.
10. 15 ТЗ (10-gen-tz.py) — по шаблону templates/tz-reel.html.
11. Доставка в Telegram (11-deliver-telegram.sh, опционально)
Проверка личности бота через getMe, затем intro → дашборд → 15 ТЗ → финальное
сообщение. Видео не отправляются, папка videos/ удаляется после транскрипции.
Отдельно, вне основного пайплайна: find-creators.py — поиск новых аккаунтов
ниши по ключевым словам и хэштегам, с фильтрами по подписчикам и частоте
публикаций. Нужен, когда подписок эталонного аккаунта мало и пул надо расширить.
Запуск
export LOORE_API_KEY=... GROQ_KEY=... TARGET_USER=...
# бюджет расхода Loore: лимит в кредитах называет пользователь
export LOORE_SPEND_AUTHORIZATION_ID=$(python3 scripts/_loore.py approve --flow reel-radar --cap <кредиты>)
bash scripts/run.sh --skip-telegramОпции:
--resume— продолжить с последнего завершённого шага--skip-telegram— не отправлять, только сложить файлы--out /path— своя папка вывода (по умолчанию/tmp/reel-radar/YYYY-MM-DD)
Правило 1-в-1 (hard rule)
Телесуфлёр в ТЗ = перевод транскрипта оригинала, не пересказ и не переработка. Берёшь фразы по порядку, переводишь, подставляешь свой tone of voice, меняешь CTA. Всё.
Остаётся 1-в-1 из оригинала: продукт и инструмент; workflow и число шагов в том же порядке; фичи и примеры; логика хука; структура «проблема → решение → демо → результат»; длина и ритм.
Меняется только три вещи:
- Язык — переводится, а не пересказывается своими словами.
- Tone of voice — под твой голос.
- CTA в конце — призыв автора («comment X», «link in bio») заменяется на твоё код-слово + бенефит.
Запрещено: пересказывать своими словами; подставлять шаблонную формулу («Ты не знал, что…», «3 шага, чтобы…») вместо содержания оригинала; менять продукт; сокращать число шагов «для ритма». Формула используется только для монтажного timeline, не для текста.
Пример
Транскрипт (EN):
This tool is now here and it's going to be coming after the big three. So they just gave us a new application that allows us to build mobile apps, web apps, presentations, front-end design, anything from a graphical interface.
Телесуфлёр (RU, 1-в-1):
Инструмент вышел. Идёт за большой тройкой. Нам дали приложение, в котором ты собираешь мобильные приложения, веб-приложения, презентации, фронт-энд-дизайн — всё из графического интерфейса.
Тот же продукт, та же мысль, тот же порядок — только переведено и с «ты».
CTA вшит в телесуфлёр, не отдельным блоком
CTA — последний абзац самого телесуфлёра, с плавным переходом из содержания ролика в код-слово. Единый текст, который читается в кадре без склейки: хук → контент → CTA.
Мостик строится из содержания именно этого ролика: «…так это и внедряют. И это только верх айсберга — всю схему разбираю целиком. Напиши СХЕМА в комментах…». В шаблоне секция «код-слово» остаётся как визуальный дубль для монтажёра — сам призыв звучит в телесуфлёре.
Короткий или неруссский транскрипт
Если транскрипт пустой, короче 40 символов или почти без кириллицы, генератор
ставит маркер [TO_BE_ADAPTED_BY_CLAUDE] и кладёт сырой транскрипт в
<details>. Такой телесуфлёр дописывается вручную — переводом, не выдумкой.
Транскрипт короче 40 символов = пометить ТЗ «требует пересмотра оригинала».
Валидация перед отправкой (обязательно)
LLM при адаптации склонен добавлять отсебятину и терять блоки оригинала. Два слоя проверки:
Слой 1 — детерминированный скрипт:
python3 scripts/validate-fidelity.py pairs.jsonpairs.json = [{"id":…, "reference":<транскрипт>, "teleprompter":<текст без
HTML>, "expected_swaps":["хабспот->амо"], "codeword":"ГАЙД"}].
Ловит язык-инвариантные сигналы: потерянные или выдуманные числа,
подменённые бренд-якоря, объём вне нормы (дроп блока или вода), вшито ли
код-слово в хвост. Вердикт PASS / WARN / FAIL, код возврата 1 при FAIL. FAIL —
чинить. WARN — смотреть глазами, часто легитимно (транслит имён, «108000» →
«108 тысяч», намеренный свап через expected_swaps).
Слой 2 — LLM-critic: прочитать пару (референс ↔ телесуфлёр) и выписать ADDED (чего нет в оригинале → удалить), REMOVED (что выпало → вернуть), CHANGED (намеренные правки → ок). Непустые ADDED/REMOVED = переделать. На объёме выносить в субагента.
Спот-чек перед отправкой: 2-3 ТЗ открыть глазами — совпадает ли продукт, совпадает ли число шагов, вшит ли CTA последним абзацем.
Ограничения (честно)
- Без ключей не работает.
LOORE_API_KEY— обязателен, весь сбор данных стоит на нём.GROQ_KEY— без него нет транскриптов, а значит ТЗ будут пустыми болванками: шаги 6, 10 и правило 1-в-1 держатся на транскрипте. - Доступ к данным Instagram неофициальный. Loore отдаёт публичные данные, официального API Instagram для чужих рилсов не существует. Аккаунт, который вчера отвечал, может отдать 404/403 (закрыли или удалили). Это не баг скилла, это природа источника.
- Расход Loore. Каждая страница, профиль и скачивание – платный запрос.
Перед прогоном назови пользователю лимит в кредитах, после его «да» создай
бюджет (
python3 scripts/_loore.py approve --flow reel-radar --cap <N>) и передай id черезLOORE_SPEND_AUTHORIZATION_ID. Без бюджета Loore отвечает428 needs_user_confirmation, на401/402/403скрипт останавливается с подсказкой (кроме403 private_account– приватный аккаунт просто пропускается). На429клиент ждётRetry-After; если ждать дольше 120 секунд (суточный лимит), прогон останавливается с кодом 4 и временем перезапуска. Тарифы – на https://loore.ai. - Риск для аккаунта. Скилл только читает публичные данные и ничего не публикует, не лайкает и не подписывается — но сам факт использования неофициального доступа к Instagram противоречит его ToS. Не используй чужие логины, не подставляй сюда аккаунт, который тебе жалко потерять.
- Закрытые и забаненные аккаунты. Если у эталонного аккаунта нет публичного
списка подписок — шаг 1 вернёт пусто. Тогда нужен
data/watchlist.jsonвручную; это не автоматизируется. - Чего нет в данных в принципе: досматриваемость, охваты, переходы, демография. Снаружи их не видит никто. Доступны просмотры, лайки, комментарии, дата (Loore для рилсов отдаёт ещё сохранения и репосты) — из них и считается ER. Если автор скрыл лайки, Loore не подставляет число: в ER такой рилс идёт с нулём лайков.
- Транскрипт — не истина. Whisper ошибается на именах, терминах и плохом звуке. Перед съёмкой ТЗ читается глазами.
- Формула хука определяется эвристикой по ключевым словам, а не пониманием ролика. На пограничных случаях будет «Инсайт» — общий формат по умолчанию.
- 15 ТЗ ≠ 15 готовых сценариев. Это заготовки с телесуфлёром из перевода оригинала. Финальный текст всегда правится человеком.
- Это инструмент для анализа рынка. Не собирай персональные данные, не строй профили на людей, не копируй чужие ролики дословно — используй как источник форматов и формул, а не как копипаст.
Lessons encoded
- Для пакетного скачивания видео платное
ig-downloadстабильнее публичных даунлоадеров - Успех транскрипции проверять по HTTP-коду, а не по grep «error» в ответе
- Ключи из env-файла подтягивать через
source, а не парсингом строк наstartswith— иначе в переменную уедет строка сexportи получишь 401 - Фоновые прогоны —
nohup … & disown - Проверка личности бота перед отправкой обязательна: один неверный токен в окружении = отчёт улетел не в тот чат
- Видео больше 50 МБ сжимать до транскрипции
- CTA вшивается в телесуфлёр последним абзацем, не отдельным блоком
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

