Перейти к содержимому
Все статьи

Открытые проекты

Instagram Agent Skill от AZIRAL: как проверять многоязычный контент локально

Олжас Азирали представляет открытый набор AZIRAL: пять навыков для AI-агентов и три Python-инструмента. Кириллица, казахский текст, emoji и честная работа с пропусками в статистике.

5 минут чтенияОпубликовано
В этой статье

Я, Олжас Азирали, основатель AZIRAL, публикую Instagram Agent Skill - открытый набор для подготовки контента о продуктах. В нём пять навыков для AI-агентов и три небольших инструмента Python. Задача набора - помочь пройти путь от подтверждённого материала до сценария, подписи или карусели, сохранив смысл в русской, английской и казахской версиях.

Материал подготовлен с помощью AI-инструментов на основе открытого кода и воспроизводимых примеров проекта. В нём нет заявлений о росте продаж или охватов: таких измерений для этого набора пока не опубликовано.

36 секунд, без звука. В ролике визуализированы реальные результаты локальных команд; пример статистики синтетический. Команды, смысл проверок и ограничения разобраны ниже.

Пять отдельных рабочих процессов

План, сценарий и анализ статистики требуют разных исходных данных. Поэтому набор разделён на пять навыков. Plan собирает аудиторию, цель, доступные материалы и факты. Reel отделяет произносимые реплики от экранных подписей и действий. Caption готовит языковые версии и описание изображения. Carousel выстраивает последовательность слайдов. Insights помогает прочитать переданные показатели публикаций.

Например, запись прототипа подтверждает работу показанной функции. Она сама по себе не подтверждает, что продукт уже запущен, имеет клиентов или приносит доход. В инструкциях эти различия сохраняются. Если факта не хватает, его нужно уточнить, а незаполненную пометку нельзя выдавать за готовую подпись.

Текст, emoji и границы проверки

Для многоязычного инструмента важно учитывать не только латинские буквы. В казахском тексте встречаются Ә, Ғ, Қ, Ң, Ө, Ұ, Ү, Һ и І. Составной emoji, например 👩‍💻, может включать соединитель между символами. Автоматическое удаление всех невидимых знаков способно изменить такую последовательность.

Локальный caption_check.py читает UTF-8 и возвращает отчёт, сохраняя исходный файл. Он отмечает незаполненные факты, выбранные управляющие символы и превышение заданных редакционных ограничений. Обнаруженный знак предлагается проверить в контексте; текст не переписывается молча.

Встроенный предпросмотр считает кодовые точки Unicode. Это не точная копия ленты Instagram и не измерение ширины на телефоне. Бюджет хештегов и длину предпросмотра можно менять. Чистый отчёт также не доказывает правильность перевода: имена, суммы, даты и обещания нужно сверять с источником.

Оценка времени речи

В сценарии для тайминга остаются только произносимые реплики: одна строка в формате роль | текст на каждый смысловой фрагмент. Пометки для монтажёра и экранные надписи хранятся отдельно. Инструмент beat_sheet.py учитывает слова с кириллицей, выбранный темп и паузы между фрагментами.

Русский пример из репозитория содержит 44 слова. При темпе 145 слов в минуту и паузах по 0,25 секунды оценка составляет 18,957 секунды. Это расчёт по тексту, а не замер записи. Числа, сокращения, произношение и подача меняют реальное время, поэтому перед монтажом нужен записанный прогон.

Казахская и английская версии не обязаны совпадать по числу слов. Важнее одинаковый смысл и удобная речь. После адаптации для каждого языка стоит проверить тайминг заново, а готовый кадр посмотреть на экране телефона.

Ноль и неизвестное значение

В insights.py пустая ячейка CSV означает неизвестное значение, а 0 - измеренный ноль. Если охват равен нулю или не передан, показатель действий на 1000 охваченных аккаунтов остаётся null. Подстановка нуля скрыла бы разницу между отсутствием наблюдения и отсутствием действий.

Просмотры сравниваются с медианой переданных публикаций того же формата, включая рассматриваемую публикацию. Такая медиана описывает выборку, а не независимо измеренную норму аккаунта. Результат не доказывает причин роста и не прогнозирует будущий охват. Небольшая или выборочная выгрузка требует особенно осторожных выводов.

CSV в репозитории синтетический: он демонстрирует обычные значения, нулевой охват и пропуски. Это не статистика AZIRAL и не история успеха клиента. Инструмент также отклоняет отрицательные значения, дубли идентификаторов и повреждённые строки.

Как попробовать и проверить

Навыки устанавливаются командой npx skills add azirali/instagram-agent-skill. Три инструмента можно запускать отдельно от AI-агента: достаточно Python 3.10+ и файлов из репозитория. Они используют стандартную библиотеку, не обращаются в сеть и не требуют пароля Instagram.

После скачивания проекта выполните из его корня:

python3 skills/aziral-instagram-caption/scripts/caption_check.py examples/caption.kk.txt --language kk --strict
python3 skills/aziral-instagram-reel/scripts/beat_sheet.py examples/reel.ru.txt --wpm 145 --target 30
python3 skills/aziral-instagram-insights/scripts/insights.py examples/insights.csv

В репозитории есть 18 автоматических тестов для обработки многоязычного текста, сохранения входных файлов и пограничных случаев статистики. Они проверяют поведение инструментов, а не реакцию аудитории. Автопубликация, генерация видео и подключение к Instagram в набор не входят; использование выбранного AI-агента может иметь отдельную стоимость.

Авторство и лицензия

Это самостоятельные инструкции и реализации AZIRAL под лицензией MIT, Copyright (c) 2026 Olzhas Azirali / AZIRAL. Идея упаковки рабочих процессов в навыки вдохновлена проектом Jake Schincariol. Его файлы, каталог формул, оценки и исследования в этот набор не включены. Происхождение описано в NOTICE.md.

Код, примеры RU/EN/KK и инструкции доступны на GitHub. Вопросы и воспроизводимые ошибки можно оставить в Issues проекта. Для знакомства с другими работами доступны мой профиль и страница проекта на Product Hunt.