MendleM/Pipepost

Активирует ключ лицензии кредитного пакета Pipepost, приобретённый на pipepost.dev. Проверяет ключ на сервере лицензий и добавляет кредиты к локальному балансу. FREE. Возвращает: { activated: true, plan: 'starter'|'pro'|'power', credits_added, total_credits }. Распространённые ошибки: недействительный или уже погашенный ключ (VALIDATION_ERROR), сервер лицензий недоступен (NETWORK_ERROR).

Извлекает просмотры, реакции и комментарии постов из каждой настроенной CMS-платформы (devto, ghost, hashnode, wordpress) и агрегирует итоговые значения. БЕСПЛАТНО. Требует учётные данные платформы. Medium и Substack перечислены, но их API не предоставляют аналитику на уровне постов. Возвращает: { platforms: [{ platform, posts: [{ title, url, views?, reactions?, comments?, published_at? }], note? }], summary: { total_posts, total_views, total_reactions } }. Типичные ошибки: не настроено ни одной платформы (VALIDATION_ERROR), ошибка аутентификации вышестоящей системы отображается для каждой платформы в поле 'note'.

Перечисляет уведомления, адресованные настроенному аккаунту Bluesky: упоминания и ответы по умолчанию, опционально включает репосты/лайки/подписки. БЕСПЛАТНО. Требует social.bluesky.handle и app_password. Возвращает: { notifications: [{ uri, cid, reason, author, record, indexed_at, is_read }] }. Распространённые ошибки: отсутствуют учётные данные (VALIDATION_ERROR), AppView временно недоступен (PLATFORM_ERROR; клиент переключается на bsky.social).

Публикует напрямую в Bluesky одним постом или цепочкой ответов. БЕСПЛАТНО. Требует настройки social.bluesky.handle и social.bluesky.app_password через setup (пароль приложения из bsky.app/settings/app-passwords). Лимит 300 графем на пост; голые URL автоматически превращаются в фасеты. Возвращает: { uri, cid, posts?: [{ uri, cid }] }. Типичные ошибки: отсутствуют учётные данные (VALIDATION_ERROR), превышение графем (VALIDATION_ERROR), ошибка 4xx от API Bluesky (PLATFORM_ERROR).

Отвечает на пост в Bluesky как одиночный ответ или цепочка сообщений. Корневая и родительская strong-ссылки, необходимые для AT Protocol, вычисляются автоматически из parent_uri. БЕСПЛАТНО. Требует social.bluesky.handle + app_password. Ограничение: 300 графем на пост. Возвращает: { uri, cid, posts?: [{ uri, cid }] }. Распространённые ошибки: отсутствуют учётные данные (VALIDATION_ERROR), родительский пост не найден (VALIDATION_ERROR), превышение лимита графем (VALIDATION_ERROR).

Ищет публичные посты Bluesky по ключевому слову, автору, упоминаниям, тегу или языку через app.bsky.feed.searchPosts. БЕСПЛАТНО. Теперь требует аутентификацию Bluesky (логин + пароль приложения), потому что AppView закрывает эту конечную точку. Возвращает: { posts: [{ uri, cid, author, text, created_at, like_count, repost_count }], cursor? }. Типичные ошибки: отсутствие учётных данных (VALIDATION_ERROR), AppView 5xx (PLATFORM_ERROR).

Получает полную переписку вокруг поста Bluesky: родительские посты сверху, дерево ответов снизу. Используйте это перед bluesky_reply, чтобы понять контекст разговора. БЕСПЛАТНО. Для публичных тредов учетные данные не требуются. Возвращает: { thread: { post, parent?, replies?: thread[] } }. Частые ошибки: URI поста не найден (VALIDATION_ERROR), ошибка AppView 5xx (PLATFORM_ERROR).

Проверяет каждый URL в Markdown-документе, отправляя HEAD-запросы (с понижением до GET). БЕСПЛАТНО. Ограничение параллельных запросов: 10, таймаут на URL: 8 с. Сообщает о битых (4xx/5xx), перенаправленных (3xx) и превысивших таймаут ссылках. Возвращает: { total, ok, broken: [{ url, status }], redirects: [{ url, to }], timeouts: string[] }. Типичные ошибки: некорректный Markdown возвращает пустой результат без выбрасывания исключения.

Проверяет статью в Markdown на проблемы качества перед публикацией: иерархию заголовков, длину абзацев, сложность предложений, пассивный залог, отсутствие alt-текста, нарушенный порядок заголовков. Базовый аудит (количества, сводка) БЕСПЛАТНЫЙ. Полный аудит (номера строк для каждой проблемы, серьёзность, предложения по исправлению) стоит 1 кредит. Возвращает: { score, word_count, reading_time_min, issues: [{ severity, line?, message, fix? }] }. Частые ошибки: недостаточно кредитов для полного аудита (PAYMENT_REQUIRED).

Ищет изображения для обложек на Unsplash. БЕСПЛАТНО. Требует access_key Unsplash, настроенный через setup. Ограничен демо-лимитом Unsplash в 50 запросов/ч или продакшн-лимитом в 5000 запросов/ч. Возвращает: { results: [{ url_full, url_regular, url_small, photographer, photographer_url, attribution_html, alt }] }. Типичные ошибки: отсутствует ключ Unsplash (VALIDATION_ERROR), превышен лимит запросов (PLATFORM_ERROR).

Публикует одну статью на нескольких CMS-платформах за один вызов. Стоит 1 кредит суммарно независимо от количества платформ (типичное использование: 5 платформ). URL первой успешной платформы используется как канонический для остальных. Требуются учётные данные для каждой целевой платформы. Возвращает: { results: [{ platform, status: 'success'|'error', url?, error? }], canonical_url, summary: { ok, failed } }. Типичные ошибки: не настроено ни одной платформы (VALIDATION_ERROR), закончились кредиты (PAYMENT_REQUIRED). Сбои на отдельных платформах сообщаются в results, но весь вызов не прерывается.

Безвозвратно удаляет сохранённый черновик по идентификатору. БЕСПЛАТНО. Операция необратима. Возвращает: { deleted: true, id }. Типичные ошибки: идентификатор черновика не найден (VALIDATION_ERROR).

Генерирует корректно оформленный frontmatter для SSG и публикационных платформ: hugo, jekyll, astro, nextjs, devto, hashnode, ghost. БЕСПЛАТНО. Автоматически извлекает описание, время чтения, slug и предлагает теги из содержимого. Без внешних вызовов. Возвращает: { frontmatter: string, format, extracted: { slug, reading_time_min, description } }. Частые ошибки: неизвестный формат (VALIDATION_ERROR).

Генерирует оптимизированный под платформу социальный контент из статьи: Twitter (тред), LinkedIn (длинный пост), Reddit (пост + предложенные сабреддиты), Bluesky (одиночный пост объёмом до 300 графем). Стоит 1 кредит за вызов независимо от количества платформ. Не требует учётных данных платформы (этот инструмент генерирует текст; для фактической публикации используйте bluesky_post / linkedin_post / x_post / mastodon_post). Возвращает: { posts: { twitter?, linkedin?, reddit?, bluesky? } }. Типичные ошибки: недостаточно кредитов (PAYMENT_REQUIRED).

Получает полное содержимое сохранённого черновика по идентификатору. БЕСПЛАТНО. Возвращает: { id, title, content, created_at, platforms?: string[] }. Типичные ошибки: идентификатор черновика не найден (VALIDATION_ERROR).

Отправляет один или несколько URL-адресов в API IndexNow для мгновенного индексирования в поисковых системах Bing, Yandex, Naver и Seznam (Google не участвует в IndexNow). БЕСПЛАТНО. Не требуются учетные данные платформы; используется общий ключ Pipepost. Возвращает: { submitted: number, key, accepted: string[], rejected: string[] }. Распространенные ошибки: некорректный URL или схема, отличная от https (VALIDATION_ERROR), восходящий 4xx от IndexNow (PLATFORM_ERROR).

Публикует напрямую в LinkedIn в виде одной записи в ленте (макс. 3000 символов). Бесплатно. Требует social.linkedin.access_token (область w_member_social). Person URN автоматически получается из /v2/userinfo при первом использовании и кешируется. У LinkedIn нет публичного API для создания цепочек, поэтому поддерживаются только одиночные записи. Возвращает: { urn, url }. Частые ошибки: отсутствующий или просроченный access_token (VALIDATION_ERROR), LinkedIn 401 (PLATFORM_ERROR), превышение 3000 символов (VALIDATION_ERROR).

Перечисляет все сохранённые локальные черновики с id, title, created_at, целевыми платформами и кратким предпросмотром. БЕСПЛАТНО. Читает из ~/.pipepost/drafts/. Возвращает: { drafts: [{ id, title, created_at, platforms?: string[], preview }] }. Ошибок нет.

Выводит список опубликованных и черновых постов на настроенной платформе (devto, ghost, hashnode, wordpress, medium, substack). БЕСПЛАТНО. Требуются учетные данные платформы. Возвращает: { posts: [{ id, title, status, url, published_at }] }. Частые ошибки: платформа не настроена (VALIDATION_ERROR), ошибка аутентификации на внешнем сервисе (PLATFORM_ERROR).

Отправляет пост напрямую в любой экземпляр Mastodon в виде одного сообщения или последовательной цепочки. БЕСПЛАТНО. Требует указания social.mastodon.instance_url и social.mastodon.access_token (область: write:statuses) через настройки. Обычно лимит символов на экземпляр - 500. Возвращает: { id, url, posts?: [{ id, url }] }. Частые ошибки: отсутствуют учётные данные (VALIDATION_ERROR), API экземпляра возвращает 4xx (PLATFORM_ERROR).

Публикует статью в формате Markdown на одну CMS-платформу: devto, ghost, hashnode, wordpress, medium или substack. Стоит 1 кредит за вызов. Требует учётные данные платформы, настроенные через инструмент 'setup'. Поддерживает статусы draft|published, теги, canonical_url, серии и обложку. Substack публикуется через обратно-инженерную аутентификацию по куки. Возвращает: { url, id, platform, status }. Частые ошибки: платформа не настроена (VALIDATION_ERROR), исчерпание кредитов (PAYMENT_REQUIRED), upstream 4xx/5xx (PLATFORM_ERROR), тайм-аут сети (NETWORK_ERROR).

Преобразует полную статью в контент, адаптированный для платформ: twitter, linkedin, reddit, hackernews (только заголовок), bluesky, newsletter (вводный абзац). Стоит 1 кредит за вызов. Сохраняет URL-адреса и учитывает ограничения по длине для каждой платформы. Возвращает: { outputs: { twitter?: string[], linkedin?: string, reddit?: { title, body, subreddits }, hackernews?: string, bluesky?: string, newsletter?: string } }. Типичные ошибки: недостаточно кредитов (PAYMENT_REQUIRED).

Сохраняет содержимое Markdown как локальный черновик в ~/.pipepost/drafts/ (локально на машине, никогда не передаётся). БЕСПЛАТНО. Черновик поддерживает привязку к одной или нескольким платформам для последующей публикации через 'publish' или 'cross_publish'. Возвращает: { id, title, created_at, platforms?: string[] }. Типичные ошибки: отсутствует 'content' (VALIDATION_ERROR), ошибка записи в файловую систему (PLATFORM_ERROR).

Генерирует SEO-оптимизированный мета-заголовок (<60 символов), мета-описание (<160 символов) и теги Open Graph из содержимого статьи. Не использует внешние API-вызовы; выполняется локально. Стоит 1 кредит за вызов. Возвращает: { title, description, og: { title, description, image_alt }, twitter: { card, title, description } }. Частые ошибки: недостаточно кредитов (PAYMENT_REQUIRED).

Анализирует markdown-контент на SEO-качество и возвращает оценку от 0 до 100 с градацией. Базовая оценка (структура заголовков, количество слов, плотность ключевых слов, читаемость) не требует учетных данных и БЕСПЛАТНА. Полный анализ (список проблем, приоритетные предложения, пробелы по связанным ключевым словам) стоит 1 кредит. Возвращает: { score, grade, breakdown, issues?, suggestions? }. Типичные ошибки: отсутствие 'content' (VALIDATION_ERROR), недостаточно кредитов для полного анализа (PAYMENT_REQUIRED).

Настраивает и сохраняет учётные данные платформы в ~/.pipepost/config.json (локальный файл, никогда не передаётся). Поддерживает devto, ghost, hashnode, wordpress, medium, substack, unsplash. Заменяет любые существующие учётные данные для той же платформы. FREE. Возвращает: { platform, status: 'configured', validated: boolean }. Распространённые ошибки: отсутствуют обязательные поля для выбранной платформы (VALIDATION_ERROR).

Показывает текущую конфигурацию Pipepost: настроенные платформы, баланс кредитов, дату ежемесячного сброса бесплатных кредитов и активный лицензионный план. БЕСПЛАТНО. Без аргументов. Возвращает: { version, credits: { remaining, free_remaining, next_reset }, platforms: string[], plan }. Без ошибок.

Публикует напрямую в X (Twitter) как одиночный твит (макс. 280 графем) или цепочку ответов через X v2 /tweets. Встроенная подпись OAuth 1.0a HMAC-SHA1. БЕСПЛАТНО на этом сервере, но бесплатный уровень API X ограничивает запись 17 твитами за 24 часа. Требует social.x.api_key, api_secret, access_token, access_token_secret через настройку. Возвращает: { id, url, tweets?: [{ id, url }] }. Распространённые ошибки: отсутствие учётных данных (VALIDATION_ERROR), превышение 280 графем (VALIDATION_ERROR), ограничение частоты запросов 429 (PLATFORM_ERROR).