# PostFrog full context # Product ## Platform web ## Stack Astro (static output) + Markdown/MDX content collections, статьи хранятся файлами в репозитории. Решение EDDY, 2026-08-06. Причина: удалённый автопостинг статей из scheduled-тасков и routines Claude сводится к «записать .md файл и задеплоить», без внешней CMS и её ключей; SEO-примитивы (sitemap, RSS, canonical, JSON-LD) собираются на этапе билда, на клиент уходит ноль JS. Языки: RU + EN, оба дерева индексируются, hreflang обязателен. Деплой: первично Railway (там же, где живёт бот; проект `cleanmypostbot`), возможен последующий перенос на VPS. Домена на 2026-08-06 нет: канонический хост живёт одной константой в конфиге сайта и меняется в одном месте. Папка сайта: `landing/` внутри репозитория бота, пока untracked (решение EDDY: сначала посмотреть локально, потом решить, оставляем ли). ## Users **Первичный:** автор Telegram-канала, который пишет посты сам. Пишет на бегу, часто с телефона, часто голосом. Ему важно, чтобы пост выглядел прилично (заголовки, акценты, цитаты, коллаж), но он не хочет возиться с разметкой и не держит в голове ограничения Telegram. **Сцена:** человек уже в Telegram, увидел бота в чужом канале или в выдаче, и решает за 10-20 секунд, стоит ли жать Start. Сайт для него — не место работы, а место проверки: «это вообще живое, что оно умеет, сколько стоит». **Вторичный (растущий):** LLM и агенты (ChatGPT, Perplexity, Claude, AI Overviews), которые отвечают на вопрос «чем отформатировать пост для Telegram-канала». Для них сайт должен быть машиночитаемым источником фактов, а не картинкой. ## Product Purpose PostFrog (@postfrog_bot) превращает сырой текст или голосовое сообщение в готовый оформленный пост для Telegram-канала и публикует его в канал в один тап. Успех сайта: посетитель понимает продукт и уходит в бота (переход в @postfrog_bot — единственное целевое действие); блог со временем приносит органический поисковый и LLM-трафик по запросам про оформление постов, Telegram-разметку и ведение каналов. ## Positioning Не «ещё один AI-редактор текста», а полный цикл внутри Telegram: приём (текст, голосовое, кружочек, альбом) → форматирование под конкретные возможности Telegram (Rich Text Bot API 10.2 или MarkdownV2, лимиты 32768/4096/1024) → правка свободным текстом или голосом («короче», «передвинь фото наверх») → публикация в один тап, хоть сразу во все свои каналы. Механизм, который сосед не скопирует одной строкой: бот учится стилю конкретного канала по 1-2 присланным постам автора и пишет дальше в этом стиле. ## Operating Context - Всё происходит внутри Telegram, у клиента нет отдельного приложения и веб-кабинета. - Публикация требует, чтобы бот был админом канала с правом «Публикация сообщений». Это отдельный шаг, который люди делают руками в настройках канала. - Перед генерацией действует гейт: пользователь должен быть подписан на каналы из списка (по умолчанию @eddyai). - Оплата — только Telegram Stars, оплата рублями пока не подключена. - Сайт живёт отдельно от бота: единственная связь — ссылка на @postfrog_bot. ## Capabilities and Constraints **Подтверждённые возможности продукта (v1-v1.6):** - Вход: текст, фото/видео/альбом (кап 10 медиа), голосовое, видео-кружок. Голос и кружки транскрибируются (Whisper). - Выход: Rich Text (Bot API 10.2) или Markdown, на выбор; заголовки, акценты, таблицы, цитаты, коллажи. - Правки свободным текстом или голосом, версии поста. - До 3 URL-кнопок под постом. - Пресеты: «Стиль канала» (по 1-2 постам автора) и именованные. - Публикация в один тап, кросспостинг «во все каналы», канал по умолчанию. - Режим writer, транскрипция видео, уверенное исправление опечаток (v1.6). **Чего продукт НЕ делает (не обещать на сайте):** нет inline-режима, нет расписания постов, нет AI-генерации картинок, нет оплаты рублями. **Ограничение сайта:** статьи блога публикуются как файлы в репозитории; любой пайплайн автопостинга обязан оставаться «записал файл → собрал → задеплоил», без ручных шагов в браузере. ## Brand Commitments - Имя **PostFrog**, ник **@postfrog_bot**. CleanMyPost — только историческое имя репозитория, на сайте не показывается. - Маскот: круглая зелёная лягушка-«шарик», один большой белый глаз с тёмным зрачком, маленький улыбающийся рот с розовым языком, толстый тёмный контур, флэт-вектор. Исходник лого у EDDY. - Есть готовый набор frog-эмодзи и брендовых изображений в стиле «flat cartoon vector, thick dark outlines» (`assets/`, `docs/brand-postfrog.md`). - Голос: дружелюбный, разговорный, без канцелярита и без хайпа. - **Жёсткое правило проекта: никаких длинных тире (em/en dash) ни в одном тексте.** Только дефис. - Формулировки из BotFather (ru/en) уже утверждены и служат опорой для копирайта сайта. ## Evidence on Hand **Есть:** живой бот @postfrog_bot; полная спецификация продукта (`cleanmypost-spec-v1.md`); бренд-док с маскотом и промптами (`docs/brand-postfrog.md`); брендовые изображения `assets/postfrog-intro.jpg`, `assets/admin-add.jpg`; реальные цены и лимиты; реальный список фич по версиям v1-v1.6; канал автора @eddyai. **Нет и выдумывать нельзя:** отзывов, кейсов, имён клиентов, количества пользователей, сгенерированных постов, рейтингов, наград, «доверяют N каналов», бенчмарков скорости, гарантий аптайма. Демонстрационные посты внутри интерфейса можно сочинять и показывать как демо, но любая коммерческая или фактическая цифра — только из этого файла. ## Product Principles 1. **Показывать продукт в работе, а не описывать его.** Главное доказательство — превращение сырого текста в готовый пост, видимое сразу. 2. **Единственное целевое действие — уйти в бота.** Всё остальное на странице подчинено этому и не конкурирует с ним. 3. **Машиночитаемость наравне с человекочитаемостью.** Факты о продукте должны одинаково доставаться и человеком, и LLM-агентом. 4. **Честность вместо социального доказательства.** Пока нет цифр и отзывов, продукт продаёт себя механизмом и ценой, а не выдуманной популярностью. 5. **Публикация статьи — операция в один шаг.** Если для новой статьи нужен ручной шаг в браузере, пайплайн спроектирован неправильно. ## Accessibility & Inclusion Требований сверх стандарта не заявлено. Базовый уровень обязателен: контраст текста от 4.5:1, работоспособность с клавиатуры, осмысленные alt, уважение к `prefers-reduced-motion`. Аудитория заметно мобильная (люди приходят из Telegram с телефона), поэтому мобильный рендер — не второй приоритет, а первый. ## Published articles - Когда лучше публиковать посты в Telegram: свой тест URL: https://postfrog.site/blog/kogda-publikovat-posty-v-telegram Description: Как найти лучшее время публикации в Telegram для своей аудитории: выбрать окна, провести тест, фиксировать первые просмотры и принять решение. Tags: telegram, планирование - Продвижение Telegram-канала без покупки пустых цифр URL: https://postfrog.site/blog/prodvizhenie-telegram-kanala Description: Как продвигать Telegram-канал: подготовить посадочную ленту, выбрать источники, размечать размещения и оценивать качество аудитории. Tags: telegram, продвижение - Вовлеченность Telegram-канала: полезные показатели URL: https://postfrog.site/blog/vovlechennost-telegram-kanala Description: Как оценивать вовлеченность Telegram-канала: реакции, комментарии, пересылки, переходы и ответы в контексте задачи публикации. Tags: telegram, аналитика - Как считаются просмотры в Telegram-канале URL: https://postfrog.site/blog/kak-schitayutsya-prosmotry-v-telegram Description: Понятное объяснение счетчика просмотров в Telegram-канале: что он показывает, почему меняется после публикации и как использовать его осторожно. Tags: telegram, аналитика - Просмотры постов в Telegram: читать цифры в контексте URL: https://postfrog.site/blog/prosmotry-postov-v-telegram Description: Как анализировать просмотры постов в Telegram с учетом возраста, пересылок, источников и размера аудитории, не гоняясь за одной цифрой. Tags: telegram, аналитика - Статистика постов в Telegram: сравнивать без самообмана URL: https://postfrog.site/blog/statistika-postov-v-telegram Description: Как сравнивать статистику Telegram-постов по теме, формату и возрасту, вести журнал гипотез и не делать вывод по одной публикации. Tags: telegram, аналитика - Статистика Telegram-канала: что смотреть каждую неделю URL: https://postfrog.site/blog/statistika-telegram-kanala Description: Как читать статистику Telegram-канала: рост, охват, источники просмотров, уведомления, пересылки и решения по недельному отчету. Tags: telegram, аналитика - Хэштеги в Telegram-канале как внутренняя навигация URL: https://postfrog.site/blog/heshtegi-v-telegram-kanale Description: Как использовать хэштеги в Telegram-канале для навигации: короткий словарь, понятные названия, размещение и регулярная чистка. Tags: telegram, аудитория - Анонимный опрос в Telegram-канале: когда он уместен URL: https://postfrog.site/blog/anonimnyj-opros-v-telegram Description: Когда нужен анонимный опрос в Telegram-канале, как сформулировать чувствительный вопрос и не обещать больше приватности, чем дает инструмент. Tags: telegram, аудитория - Опросы в Telegram-канале: вопросы, которые дают ответ URL: https://postfrog.site/blog/oprosy-v-telegram-kanalah Description: Как делать опросы в Telegram-канале: один вопрос, полноценные варианты, нейтральная формулировка и решение по результату. Tags: telegram, аудитория - Бот для расшифровки голосовых: что проверить до старта URL: https://postfrog.site/blog/bot-rasshifrovki-golosovyh Description: Как выбрать бота для расшифровки голосовых сообщений: языки, точность, лимиты, приватность, экспорт и редактура результата. Tags: telegram, голос - Расшифровка голосовых сообщений: редакторский процесс URL: https://postfrog.site/blog/rasshifrovka-golosovyh-soobshchenij Description: Редакторский процесс расшифровки голосовых сообщений: подготовка аудио, транскрипт, сверка спорных мест, структура и хранение. Tags: telegram, голос - Как перевести голосовое сообщение в текст и пост URL: https://postfrog.site/blog/golosovoe-soobshchenie-v-tekst Description: Как перевести голосовое сообщение в текст и превратить расшифровку в Telegram-пост: структура, редактура, факты и оформление. Tags: telegram, голос - Как записывать кружки в Telegram без пересъемок URL: https://postfrog.site/blog/kak-zapisyvat-kruzhki-v-telegram Description: Как записывать кружки в Telegram с первого или второго дубля: свет, звук, кадр, тезис, темп речи и проверка перед отправкой. Tags: telegram, голос - Кружки в Telegram: как использовать их для контента URL: https://postfrog.site/blog/kruzhki-v-telegram Description: Как использовать кружки в Telegram для контента: личное включение, короткая демонстрация, ответ, отчет и превращение видео в пост. Tags: telegram, голос - Видео в посте Telegram: подготовка, подпись и обложка URL: https://postfrog.site/blog/video-v-poste-telegram Description: Как подготовить видео для Telegram-поста: сильное начало, вертикальный или горизонтальный кадр, субтитры, обложка, подпись и сжатие. Tags: telegram, медиа - Несколько фото в посте Telegram: собрать сильный альбом URL: https://postfrog.site/blog/neskolko-foto-v-poste-telegram Description: Как собрать альбом из нескольких фото в Telegram: выбрать первый кадр, выстроить порядок, убрать повторы и написать общую подпись. Tags: telegram, медиа - Пост с фото в Telegram: композиция текста и кадра URL: https://postfrog.site/blog/post-s-foto-v-telegram Description: Как собрать пост с фото в Telegram: выбрать главный кадр, связать подпись с деталями снимка и подготовить доступный текст. Tags: telegram, медиа - Размер картинки для поста в Telegram без обрезки URL: https://postfrog.site/blog/razmer-kartinki-dlya-posta Description: Как выбрать размер и пропорции картинки для Telegram-поста, оставить безопасные поля и подготовить четкий файл без лишнего веса. Tags: telegram, медиа - Картинки для постов в Telegram: выбирать по смыслу URL: https://postfrog.site/blog/kartinki-dlya-postov-v-telegram Description: Как подбирать картинки для Telegram-постов по задаче: доказательство, объяснение, атмосфера, серия и проверка прав на изображение. Tags: telegram, медиа - Бесплатный автопостинг в Telegram без хрупкой схемы URL: https://postfrog.site/blog/besplatnyj-avtoposting-v-telegram Description: Бесплатный автопостинг в Telegram: когда достаточно встроенного планирования, RSS и простого бота, а где экономия становится хрупкой. Tags: telegram, публикация - Автопостинг в Telegram: где он помогает, а где мешает URL: https://postfrog.site/blog/avtoposting-v-telegram Description: Как настроить автопостинг в Telegram без дублей и сломанной разметки: источник, фильтры, преобразование, очередь и контроль ошибок. Tags: telegram, публикация - Бот для публикации постов в Telegram: права и риски URL: https://postfrog.site/blog/bot-dlya-publikacii-postov Description: Как выбрать и безопасно подключить бота для публикации в Telegram: права администратора, тестовый канал, журнал действий и отзыв доступа. Tags: telegram, публикация - Бот для постов в Telegram: как выбрать под свой процесс URL: https://postfrog.site/blog/bot-dlya-postov-v-telegram Description: Как выбрать бота для создания Telegram-постов: входные форматы, редактура, Rich Text, медиа, предпросмотр и контроль публикации. Tags: telegram, публикация - Публикация постов в Telegram: надежный процесс URL: https://postfrog.site/blog/publikaciya-postov-v-telegram Description: Редакционный процесс публикации постов в Telegram: роли, статусы, предпросмотр, проверка фактов, выпуск и действия после публикации. Tags: telegram, публикация - Отложенный пост в Telegram: настройка и контроль URL: https://postfrog.site/blog/otlozhennyj-post-v-telegram Description: Как запланировать отложенный пост в Telegram, проверить часовой пояс, медиа и ссылки, а также оставить контроль перед выпуском. Tags: telegram, публикация - Как закрепить пост в Telegram и не превратить его в склад URL: https://postfrog.site/blog/kak-zakrepit-post-v-telegram Description: Как закрепить пост в Telegram-канале и что поместить в закреп: навигацию, старт для новичка, актуальное предложение или важное обновление. Tags: telegram, публикация - Реакции на посты в Telegram как быстрый сигнал URL: https://postfrog.site/blog/reakcii-v-telegram-postah Description: Как настроить реакции на посты в Telegram, выбрать небольшой набор и получать полезный сигнал вместо случайной коллекции эмодзи. Tags: telegram, аудитория - Комментарии в Telegram-канале: включить и настроить URL: https://postfrog.site/blog/kommentarii-v-poste-telegram Description: Как включить комментарии в Telegram-канале, связать обсуждение с группой, задать правила и не оставлять вопросы без модерации. Tags: telegram, аудитория - Кнопка в посте Telegram: сценарии, текст и проверка URL: https://postfrog.site/blog/knopka-v-poste-telegram Description: Как сделать кнопку в Telegram-посте: выбрать одно действие, написать короткий текст, настроить ссылку через бота и проверить сценарий. Tags: telegram, публикация - Ссылка в посте Telegram: как сделать ее понятной URL: https://postfrog.site/blog/ssylka-v-poste-telegram Description: Как добавить ссылку в Telegram-пост, написать понятный анкор, выбрать место, проверить переход и не перегрузить публикацию. Tags: telegram, оформление - Как редактировать пост в Telegram после публикации URL: https://postfrog.site/blog/redaktirovat-post-v-telegram Description: Как безопасно редактировать опубликованный пост в Telegram: исправление опечаток, фактов, ссылок, условий и прозрачное обновление. Tags: telegram, публикация - Длинный пост в Telegram: как удержать внимание URL: https://postfrog.site/blog/dlinnyj-post-v-telegram Description: Как написать длинный пост в Telegram: сильный вход, карта текста, подзаголовки, примеры, переходы и честное сокращение. Tags: telegram, оформление - Размер поста в Telegram: сколько текста оставит читателя URL: https://postfrog.site/blog/razmer-posta-v-telegram Description: Как выбрать размер Telegram-поста по задаче и экрану телефона, сократить лишнее и не путать технический лимит с хорошей длиной. Tags: telegram, оформление - Формат поста в Telegram: выбрать под задачу, а не моду URL: https://postfrog.site/blog/format-posta-v-telegram Description: Как выбрать формат Telegram-поста под задачу: короткая заметка, инструкция, разбор, история, подборка, опрос или анонс. Tags: telegram, оформление - Форматирование текста в Telegram: понятный справочник URL: https://postfrog.site/blog/formatirovanie-teksta-v-telegram Description: Справочник по форматированию текста в Telegram: жирный, курсив, подчеркивание, зачеркивание, цитаты, код и скрытый текст. Tags: telegram, оформление - Эмодзи для оформления постов в Telegram без перегруза URL: https://postfrog.site/blog/emodzi-dlya-oformleniya-postov Description: Как использовать эмодзи в Telegram-постах: роли, частота, тон канала, доступность и редакционный набор вместо случайного декора. Tags: telegram, оформление - Символы для оформления постов в Telegram: когда они нужны URL: https://postfrog.site/blog/simvoly-dlya-oformleniya-postov Description: Какие символы использовать в Telegram-постах, как назначить им роль и почему декоративные рамки часто ухудшают чтение на телефоне. Tags: telegram, оформление - Красивое оформление постов в Telegram: система стиля URL: https://postfrog.site/blog/krasivoe-oformlenie-postov-telegram Description: Как создать узнаваемый стиль Telegram-постов: правила заголовков, акцентов, эмодзи, медиа и повторяемый шаблон без однообразия. Tags: telegram, оформление - Оформление поста в Telegram без визуального шума URL: https://postfrog.site/blog/oformlenie-posta-v-telegram Description: Практическая схема оформления Telegram-поста: первая строка, абзацы, выделения, списки, цитаты, ссылки и финальная проверка. Tags: telegram, оформление - Как сделать пост в Telegram: путь от мысли до кнопки URL: https://postfrog.site/blog/kak-sdelat-post-v-telegram Description: Полный процесс создания поста в Telegram: задача, черновик, структура, оформление, медиа, проверка и публикация без лишних действий. Tags: telegram, оформление - Текст для Telegram-канала: от заметки до публикации URL: https://postfrog.site/blog/tekst-dlya-telegram-kanala Description: Как написать текст для Telegram-канала из сырой заметки: выбрать одну мысль, построить ход, убрать служебные фразы и закончить действием. Tags: telegram, оформление - Темы постов для Telegram-канала: рабочая матрица URL: https://postfrog.site/blog/temy-postov-dlya-telegram-kanala Description: Матрица тем для Telegram-канала: вопросы аудитории, наблюдения, разборы, сравнения, ошибки и истории без бесконечного мозгового штурма. Tags: telegram, контент-план - Рубрики для Telegram-канала, которые не надоедают URL: https://postfrog.site/blog/rubriki-dlya-telegram-kanala Description: Как придумать рубрики Telegram-канала, задать им правила и вовремя закрыть те, которые не помогают читателю или автору. Tags: telegram, контент-план - Контент-план для Telegram-канала на четыре недели URL: https://postfrog.site/blog/kontent-plan-dlya-telegram-kanala Description: Контент-план Telegram-канала на месяц: цели публикаций, рубрики, баланс форматов, подготовка материалов и гибкий недельный цикл. Tags: telegram, контент-план - Как вести Telegram-канал без редакции и выгорания URL: https://postfrog.site/blog/kak-vesti-telegram-kanal Description: Практичная система ведения Telegram-канала в одиночку: ритм, запас тем, короткий редакционный цикл и защита от выгорания. Tags: telegram, контент-план - Идеи для Telegram-канала: как найти тему с запасом URL: https://postfrog.site/blog/idei-dlya-telegram-kanala Description: Как выбрать идею Telegram-канала, которой хватит надолго: пересечение опыта, интереса аудитории, форматов и доступного времени. Tags: telegram, запуск-канала - Описание Telegram-канала: формула, примеры и проверка URL: https://postfrog.site/blog/opisanie-telegram-kanala Description: Как написать описание Telegram-канала: обещание пользы, тематика, ритм, автор и понятное действие без рекламных штампов. Tags: telegram, запуск-канала - Название для Telegram-канала: как выбрать и проверить URL: https://postfrog.site/blog/nazvanie-dlya-telegram-kanala Description: Практический способ выбрать название Telegram-канала: критерии, короткий список вариантов, проверка ссылки и тест без вкусовщины. Tags: telegram, запуск-канала - Как создать Telegram-канал и подготовить его к первому посту URL: https://postfrog.site/blog/kak-sozdat-telegram-kanal Description: Пошаговый запуск Telegram-канала: тема, тип доступа, название, описание, первые публикации и проверка перед приглашением читателей. Tags: telegram, запуск-канала - How to format a Telegram post without visual clutter URL: https://postfrog.site/en/blog/how-to-format-a-telegram-post Description: A practical structure for Telegram posts: headings, paragraphs, emphasis, quotes, media and buttons that stay easy to scan on a phone. Tags: telegram, formatting - How to turn a voice message into a Telegram post URL: https://postfrog.site/en/blog/voice-message-to-telegram-post Description: A practical workflow for dictating an idea, removing repetition, rebuilding structure, checking facts and preparing a voice draft for publication. Tags: telegram, voice