Документация

Как пользоваться TubeMine.

Быстрый старт, тарифы, форматы экспорта, лимиты и частые ошибки.

Обновлено: May 21, 2026

01 Обзор

TubeMine читает публичные комментарии под видео YouTube и возвращает аналитику аудитории: направление сентимента, самые частые слова, самые частые эмодзи. Вставьте URL и получите результат за несколько секунд.

Подойдёт авторам, маркетинговым аналитикам, ML-исследователям, инди-разработчикам и всем, кому нужен сигнал аудитории без ручной прокрутки сотен комментариев.

02 Комментарии в ваш AI-ассистент (MCP)

TubeMine MCP - это удалённый сервер Model Context Protocol, который позволяет вашему ИИ-ассистенту забирать комментарии YouTube прямо в чате. Базовые модели не умеют получать комментарии YouTube сами, поэтому TubeMine закрывает этот пробел и отдаёт вашей модели сырые данные. Весь анализ делает уже ваш ИИ.

get_youtube_comments(video_url, sort, max) , Сырую ветку комментариев: автор, текст, лайки, ответы и временные метки. Без сводок и оценок. Ваша модель читает данные и отвечает на ваш вопрос.

Получить и управлять ключом можно на странице Доступ для ИИ-ассистента. Там же можно обновить ключ (это отзовёт старый на всех подключённых клиентах) или отозвать отдельного клиента.

терминал
claude mcp add --transport http TubeMine https://tubemine.tech/api/mcp --header "Authorization: Bearer YOUR_KEY"

Сервер: https://tubemine.tech/api/mcp

Полный гайд по подключению клиентов

03 Быстрый старт (аккаунт не нужен)

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

  • 1. Вставьте публичный YouTube URL. Форма на главной принимает любой стандартный YouTube URL (короткий, полный, с таймкодом).
  • 2. Подтвердите превью. TubeMine получает заголовок, канал, число просмотров, лайков и комментариев чтобы вы убедились что выбрали нужное видео.
  • 3. Нажмите «Анализ» и скачайте CSV. Результаты отрисовываются в браузере, CSV формируется на стороне клиента со столбцами author, text, likes, replies, publishedAt.

Анонимный лимит: 1 000 комментариев на один IP на одно видео. Результаты живут в браузере до закрытия вкладки. Войдите чтобы поднять лимит до 5 000 комментариев в месяц и сохранять до 10 анализов в истории.

04 Войдите для тарифа Free

Вход через Google переключает вас с IP-лимита на месячный лимит на аккаунт, добавляет качественную оценку сентимента и сохраняет последние анализы в историю.

  • Вход через Google. Маршрут /login обрабатывает OAuth. Пароли запоминать не нужно.
  • 5 000 комментариев в месяц. Считается по всем видео которые вы проанализировали в текущем календарном месяце. Сбрасывается 1-го числа.
  • Качественная оценка сентимента. Каждый анализ показывает качественную полоску направления сентимента (positive, neutral, negative). Pro добавляет точные проценты.
  • Последние 10 анализов сохраняются плюс скачивание CSV. Зайдите в /history чтобы пересмотреть прошлые запуски. Столбцы CSV те же что и в анонимном режиме: author, text, likes, replies, publishedAt.

05 Тариф Pro ($19/month)

Pro стоит $19 в месяц с 3-дневным бесплатным trial. Добавляет точные проценты сентимента, полные рейтинги слов и эмодзи, экспорт в JSON и Excel, месячный лимит 100 000 комментариев и 100 сохранённых анализов в истории.

  • Цена и trial. Pro стоит $19 / month. Новые подписки получают 3-дневный бесплатный trial; первое списание происходит только на 4-й день если вы продолжаете.
  • 7 дней на возврат. После первого списания у вас есть 7 дней чтобы запросить возврат через customer portal. Trial и окно возврата не суммируются: trial идёт до любого списания, окно возврата стартует только когда начинается биллинг.
  • Отмена в любой момент. Pro работает помесячно, без минимального срока. Отмена через customer portal в два клика.
  • 100 000 комментариев в месяц, 100 сохранённых анализов, точные проценты сентимента и тренды. JSON и Excel экспорт доступны с /dashboard и /history.

Полное сравнение и FAQ на /pricing.

06 Форматы экспорта (CSV, JSON, Excel)

Доступны три формата, по тарифам.

  • CSV (все тарифы). Столбцы: author, text, likes, replies, publishedAt. Формируется на стороне клиента через Papa Parse. Ячейки начинающиеся с =, +, -, @ санитайзятся, чтобы не сработала formula injection при открытии файла в Excel или Sheets.
  • JSON (Pro). Та же структура записей что в CSV плюс агрегаты анализа: проценты сентимента, топ слов, топ эмодзи. Скачивается с /dashboard или /history. Пометка «API coming soon» на странице цен относится к планируемому публичному REST API для разработчиков; сам JSON-экспорт работает уже сейчас.
  • Excel / XLSX (Pro). Формируется на сервере. Те же данные что и JSON. Та же защита от formula injection что и для CSV.

Защита от formula injection (shipped 2026-05-21) покрывает ASCII =, +, -, @ и их full-width Unicode варианты. Hardening рекомендованный OWASP для любого пользовательского контента который экспортируется в таблицы.

07 Лимиты и квоты

Лимиты считаются отдельно для каждого тарифа.

  • Анонимный (по IP). 1 000 комментариев на один IP на одно видео. Месячный лимит на IP сбрасывается 1-го числа следующего календарного месяца.
  • Free и Pro (по аккаунту). Лимит привязан к вашему Google-аккаунту: 5 000 / month для Free, 100 000 / month для Pro. Сбрасывается 1-го числа. Текущее использование и дата сброса видны на /profile.
  • Квота YouTube API. TubeMine использует собственную общую квоту YouTube Data API v3, ваш собственный API key не нужен. Если общая квота исчерпана на день, вы можете увидеть сообщение «TubeMine has hit its YouTube API daily quota»; квота обновляется ежедневно по расписанию YouTube.

08 Частые ошибки

Если extract или preview падает, вот как читать самые частые сообщения об ошибке.

  • "Video not found" URL некорректный или видео приватное / удалено. Откройте URL в новой вкладке YouTube чтобы проверить; TubeMine работает только с публичными видео.
  • "Comments are disabled for this video by the uploader" Автор видео отключил комментарии на стороне YouTube; нет ветки комментариев чтобы её анализировать.
  • "TubeMine has hit its YouTube API daily quota. Please try again tomorrow." Наша общая квота YouTube Data API на день исчерпана. Обновляется ежедневно по расписанию YouTube; попробуйте на следующий день.
  • "Monthly Pro cap reached. Resets on the 1st." / "Free tier cap reached. Upgrade for 100,000 comments/month." Ваш аккаунт достиг месячного лимита (5 000 для Free, 100 000 для Pro). Квота сбрасывается 1-го числа следующего календарного месяца. Текущее использование и дата сброса видны на /profile.
  • "Monthly budget exhausted" Месячный лимит для анонимных посетителей на один IP. Войдите через Google чтобы перейти на лимит по аккаунту (5 000 Free, 100 000 Pro).

Если ничего из перечисленного не соответствует тому что вы видите, напишите на hello@tubemine.app.

09 Open source (MIT)

TubeMine, это open source под MIT-лицензией. Репозиторий целиком на GitHub.

Контрибьюции приветствуются: форкните репозиторий, создайте feature-ветку, откройте pull request в main с понятным описанием. Локальная настройка описана в разделе Contributing в README.