Описание

Инструмент командной строки, который превращает беспорядочное дерево папок с рецептами в календарь публикаций TikTok. Он сканирует каждую папку, выбирает *готовое* видео (игнорируя сырые монтажные клипы), нечётко сопоставляет его с нужной строкой в базе рецептов для подписи и планирует пакет на аккаунт TikTok через API PostMyPost — по одному посту в день, от старого клипа к новому. Каждый пост создаётся с нужными настройками TikTok: публичный, разрешены комментарии / дуэт / stitch.

У мейкера была папка на каждый рецепт, где сырой монтажный материал (IMG_*.MOV, Gen_*.mp4) перемешан с одним готовым видео, и отдельная CSV-база рецептов с заголовками и описаниями. Чтобы выложить видео в TikTok, для каждой папки приходилось: найти готовый клип, найти его рецепт, написать подпись и запланировать на ближайший свободный день — и так десятки раз вручную, с реальным риском задвоить пост или пропустить день.

Решение

Инструмент делит работу на два осознанных шага, чтобы человек контролировал, что именно публикуется. Шаг 1 — построение маппинга: офлайн-скан папок, выбор готового видео, нечёткое сопоставление имени файла со строкой рецепта и запись mapping.csv со статусом на строку (OK, REVIEW, AMBIGUOUS, NO_VIDEO, SKIP), оценкой уверенности и редактируемой подписью. Мейкер правит только помеченные строки и свободно редактирует подписи. Шаг 2 — планирование: отправляются только строки OK, от старого видео к новому (чтобы самый свежий клип встал последним), по одному посту в календарный день. Режим dry-run и проверка первого поста --limit 1 позволяют убедиться до отправки всего пакета, а каждая запланированная папка фиксируется в .scheduled_state.json, поэтому повторный запуск не задваивает посты и просто продолжает со следующего свободного дня.

Ключевая идея — оставить человеку контрольную точку ровно там, где автоматизация слабее всего: в сопоставлении видео с рецептом. Вместо слепого доверия нечёткому матчингу инструмент показывает свою уверенность и помечает всё сомнительное на проверку — мейкер подтверждает спорные случаи, и ничего не публикуется с неверной подписью. Второй приоритет — идемпотентность: поскольку запуск планирования затрагивает живой соцкалендарь, каждое действие фиксируется, а повторные запуски безопасны по замыслу, с dry-run, чтобы заранее увидеть, что именно произойдёт.

Результат

- Десятки видео-рецептов запланированы в TikTok одной пакетной командой, по одному в день
- Подписи автоматически сопоставлены с нужным рецептом, ручная проверка — только там, где есть сомнение
- Безопасные, возобновляемые запуски — без дублей и пропущенных дней, продолжает с места остановки
- Полностью настраивается через переменные окружения (проект, даты, время, число постов в день, настройки TikTok)

Презентация проекта