Как начать работу с GitHub Marketplace

В этой статье

• Пройти проверку издателя
• Просмотреть метрики листинга
• Просмотреть транзакции листинга
• Протестировать приложение
• Создать черновик листинга
• Настроить тарифные планы
• Отправить листинг на публикацию
• Краткое резюме

Преамбула

GitHub Marketplace — это платформа, где разработчики находят и интегрируют инструменты для автоматизации, анализа и управления рабочими процессами. Инструменты бывают разных типов: GitHub Actions (автоматизация CI/CD), GitHub Apps (интеграции с API) и OAuth Apps (авторизация пользователей). Каждый тип требует своих шагов для добавления в Marketplace; ниже — универсальное руководство с примечаниями для каждой роли в команде.

Пройти проверку издателя

1. В правом верхнем углу GitHub нажмите фотографию профиля, затем выберите «Ваши организации» (Ваши организации).
2. Рядом с нужной организацией нажмите Настройки.
3. В левой боковой панели откройте Настройки разработчика.
4. Под разделом Проверка издателя заполните чек-лист и нажмите Запросить проверку.

Важно: вам потребуется предоставить информацию по владению организацией и контактные данные. GitHub проверит данные и сообщит результат после завершения проверки.

Примечание: перевод UI-лейблов дан для удобства — в интерфейсе GitHub названия могут использовать оригинальные формулировки.

Просмотреть метрики листинга

Как открыть Insights:

1. В правом верхнем углу нажмите фотографию профиля и выберите Настройки.
2. В левой боковой панели откройте Настройки разработчика.
3. Выберите OAuth Apps или GitHub Apps в зависимости от типа вашего листинга.
4. На странице настроек приложения прокрутите до раздела Marketplace и нажмите Добавить в Marketplace (List in Marketplace).
5. Если у вас уже есть черновик, нажмите Редактировать листинг в Marketplace.
6. Откройте вкладку Insights и выберите период через выпадающее меню «Период» в правом верхнем углу.

Что показывают метрики: показатели просмотров листинга, установки, отмены и тенденции по времени. Используйте их, чтобы корректировать описание, цены и стратегию продвижения.

Просмотреть транзакции листинга

Как открыть Transactions:

1. В правом верхнем углу нажмите фотографию профиля и выберите Настройки.
2. В левой боковой панели откройте Настройки разработчика.
3. Выберите OAuth Apps или GitHub Apps, затем нужное приложение.
4. На странице приложения прокрутите до раздела Marketplace и нажмите Добавить в Marketplace.
5. Если у вас есть черновик, нажмите Редактировать листинг в Marketplace.
6. Перейдите на вкладку Transactions и при необходимости выберите период через выпадающее меню «Период».

Важно: вкладка транзакций доступна, когда приложение настроено для установки любым пользователем или организацией (если вы разрешили установку при регистрации приложения).

Протестировать приложение

Рекомендации для тестирования:

• Создайте черновой листинг и настройте несколько планов: бесплатный, с пробным периодом и платный.
• Прогоните сценарии переключения между бесплатной и платной подпиской.
• Используйте режимы разработчика GitHub и «Apply Pending Change» (функция только для разработчиков), чтобы симулировать изменения, ожидающие цикла биллинга.

Примечание: адрес страницы ожидающих изменений может выглядеть как https://github.com/settings/billing#pending-cycle — используйте его для доступа к изменениям, которые ещё не применены.

Создать черновик листинга

1. В левой боковой панели откройте Настройки разработчика.
2. Выберите OAuth Apps или GitHub Apps в зависимости от типа публикуемого приложения.
3. Выберите приложение, которое хотите добавить в Marketplace.
4. На странице настроек приложения прокрутите до раздела Marketplace и нажмите Добавить в Marketplace.
5. Если у вас уже есть черновик, откройте его и редактируйте.

После создания черновика вы увидите список разделов, которые нужно заполнить: описание, скриншоты, URL поддержки, условия использования, политика конфиденциальности, планы и цены, категории и теги.

Критерии приёмки: листинг считается готовым к отправке на проверку, когда все обязательные поля заполнены, указаны корректные контактные данные и приложены скриншоты/видео, демонстрирующие работу приложения.

Настроить тарифные планы

Чтобы создать или изменить тарифный план:

1. На странице листинга слева нажмите Планы и цены.
2. Добавьте тарифы с описанием, ограничениями и механизмом оплаты.
3. Для тестирования добавьте пробный период и варианты оплаты (ежемесячно/ежегодно, где применимо).

Если план больше не нужен, вы можете удалить его или выключить новые подписки, оставив активные подписки без изменений.

Совет: для ясности указывайте, что именно входит в каждый план (лимиты, поддержка, SLA). Это снижает количество вопросов от пользователей и возвратов.

Отправить листинг на публикацию

1. Когда листинг готов, откройте вкладку Обзор в верхнем левом углу страницы листинга.
2. Нажмите Запросить проверку (Request review).
3. Эксперт по онбордингу GitHub свяжется с вами для уточнения деталей.

Важно: до отправки проверьте соответствие требованиям Marketplace по безопасности, политике конфиденциальности и условиям использования.

Частые ошибки и когда процесс не сработает

• Неполные контактные или юридические данные — проверка издателя будет отклонена.
• Отсутствие скриншотов/демо — листинг часто возвращают на доработку.
• Неправильно настроенный способ установки — если приложение нельзя установить организацией, некоторые функции Marketplace будут недоступны.
• Несоответствие требованиям безопасности — приложения, запрашивающие лишние права, могут быть отклонены.

Если процесс не удался: исправьте замечания из ответа от команды GitHub, проверьте документацию по правам доступа и повторно отправьте запрос на проверку.

Альтернативные подходы к распространению вашего инструмента

• Публикация в виде open-source проекта и настройка автоматической интеграции через GitHub Actions.
• Продажа лицензий напрямую через собственный сайт с интеграцией OAuth для доступа к репозиториям.
• Использование сторонних маркетплейсов и каталогов DevTools для дополнительной видимости.

Плюс Marketplace: централизованная аудитория разработчиков и встроенные механизмы биллинга и распространения.

Ментальные модели и трюки при подготовке листинга

• Думайте как пользователь: опишите проблему, как ваше приложение её решает и какой результат получит пользователь.
• Разделяйте УТП (уникальные преимущества) от технических деталей — кратко на странице листинга, подробности в документации.
• Тестируйте гипотезы: меняйте описание и цену, отслеживайте реакцию в Insights.

Мини-методология запуска листинга (шаги команды)

1. Подготовить репозиторий и релизную версию приложения.
2. Сформировать юридические и контактные документы (политика конфиденциальности, условия использования).
3. Создать черновик листинга: описание, скриншоты, видео, категории, теги.
4. Настроить тарифы и тестовые сценарии биллинга.
5. Пройти внутреннее QA и тестирование установки.
6. Отправить на проверку в GitHub.
7. Реагировать на запросы команды GitHub и выпускать исправления.

Ролевые чек-листы (быстрое руководство)

Разработчик:

• Поддержка установки и эксплуатации (readme, пример конфигурации)
• Корректные права OAuth/GitHub App
• Тестовые сценарии и CI

Продукт/PM:

• Описание УТП и кейсов использования
• План тарифов и пробные периоды
• Материалы для маркетинга (скриншоты, видео)

Юридический/финансы:

• Политика конфиденциальности
• Условия обслуживания и возвраты
• Налогообложение и соответствие требованиям платёжной системы

QA/DevOps:

• Тест установки в организации и под пользователем
• Тест биллинга и смены планов
• Мониторинг и логирование ошибок

Шаблон чек-листа перед отправкой на проверку

• Название приложения
• Описание (краткое + подробное)
• Скриншоты/видео
• URL поддержки и документации
• Политика конфиденциальности
• Тарифные планы и пробные периоды
• Контактные данные издателя
• Настройки установки (кто может устанавливать)
• Заполненные метаданные (категории, теги)

Сравнение подходов к распространению (короткая матрица)

• Marketplace: + видимость в GitHub, + встроенный биллинг, — требования к соответствию и проверке.
• Собственный сайт: + полный контроль над продажами, — требуется интеграция биллинга и привлечения трафика.
• Open-source + пожертвования/спонсорство: + сообщество, — нестабильный доход.

Переходные сценарии и rollback при проблемах

• Если после публикации появились серьёзные ошибки, снимите листинг с публикации или отключите новые подписки, опубликуйте экстренное исправление и уведомление для пользователей.
• Для отката изменений в биллинге используйте внутренние тестовые циклы и «Pending Change», если доступны, прежде чем менять реальный план тарифа.

Безопасность и приватность

• Минимизируйте запрашиваемые права: просите только те разрешения, которые действительно нужны.
• В документации укажите, как вы храните и обрабатываете данные пользователей.
• Сообщите о механизмах удаления данных и процедуре запроса информации.

Важно: при обработке персональных данных учитывайте местные требования по защите данных и уведомляйте пользователей.

Короткая инструкция для продвижения после публикации

• Отправьте анонс в блоге и социальных сетях, предоставьте пример использования.
• Подготовьте короткие гайды и шаблоны интеграции для пользователей.
• Отслеживайте Insights и оптимизируйте описание и цены по результатам.

Факто-бокс: ключевые моменты

• Типы инструментов: GitHub Actions, GitHub Apps, OAuth Apps.
• Основной поток: проверка издателя → создание черновика → тестирование → отправка на проверку.
• Основные разделы листинга: описание, медиа, поддержка, политика приватности, тарифы.

Социальные превью и краткое объявление

Social preview (OG title): Запустите ваше приложение в GitHub Marketplace

Social preview (OG description): Пошаговое руководство по созданию, тестированию и публикации листинга в GitHub Marketplace для разработчиков.

Краткое объявление (100–200 слов):

Запустите ваше приложение в GitHub Marketplace — централизованной площадке для распространения инструментов и интеграций. В этом руководстве вы найдёте все шаги: от прохождения проверки издателя и создания черновика листинга до тестирования биллинга и отправки на проверку. Включены ролевые чек-листы, шаблон предзапросной проверки и рекомендации по безопасности. Marketplace упрощает распространение и монетизацию, а также даёт доступ к аудитории разработчиков GitHub.

Краткое резюме

GitHub Marketplace — удобная платформа для распространения как бесплатных, так и платных инструментов. Успешный листинг требует подготовки: проверка издателя, полные метаданные, корректные права доступа и корректная настройка тарифов. Тестируйте все сценарии установки и биллинга, используйте Insights для оптимизации и обращайтесь к поддержке GitHub для помощи с проверкой.

Спасибо за внимание — если у вас есть конкретные вопросы по типу приложения (GitHub App, OAuth App или Action), укажите тип и мы подготовим детализированное руководство.