TubeScout 🔭

Превратите YouTube в поисковый движок для вашего AI-агента. MCP-сервер (без API-ключа) плюс набор навыков, которые позволяют Claude Code, Codex и OpenCode искать по YouTube как по базе данных, читать транскрипты в масштабе и добывать из видео доказательства — утверждения, цифры, сигналы спроса — вместо расплывчатых впечатлений.

Инструменты для генерации идей сканируют Reddit и форумы. YouTube — это мессто, где основатели показывают подтверждения: дашборды выручки, плейбуки, реальные цифры на камеру — и никто это не добывает. TubeScout — добывает.

Быстрый старт (60 секунд)

Claude Code

claude mcp add --scope user tubescout -- npx -y tubescout

Codex

codex mcp add tubescout -- npx -y tubescout

OpenCode — добавьте в ~/.config/opencode/opencode.json в раздел "mcp":

"tubescout": { "type": "local", "command": ["npx", "-y", "tubescout"], "enabled": true }

Вот и всё — ни API-ключа, ни настройки. Затем спрашивайте своего агента, например:

«Найди 5 самых просматриваемых видео об n8n за последний месяц и резюмируй, с чем люди испытывают трудности.»

Самый простой вариант «всё в одном» (Claude Code): установка в качестве плагина — MCP-сервер + все 6 навыков двумя командами:

/plugin marketplace add not0lucky/tubescout
/plugin install tubescout@tubescout

Или установите набор навыков вручную (работает для Cl aide Code, Codex и OpenCode):

git clone https://github.com/not0lucky/tubescout && cd tubescout
./scripts/install-skills.sh   # installs into ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills

Related MCP server: youtube-mcp

Инструменты

Навыки (методы исследования)

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

Смотрите реальный запуск /yt-breakdown на трёх видео из серии «как я зарабатываю $X в месяц» — включая то, что пережило скептическую проверку, а что нет.

Как это работает (честно)

Здесь нет магии, и в этом вся суть:

• youtubei.js общается с внутренним InnerTube API от YouTube — тем же, что использует сайт. Без ключа и квот.

• Транскрипты — это собственные субтитры YouTube, получаемые через цепочку отката: дорожка timedtext в ANDROID-клиенте → конечная точка транскриптов InnerTube (известная периодическими ошибками 400 — повтор с задержкой) → локальный yt-dlp, если он у вас есть. Каждый ответ сообщает, какой source его выдал.

• Весь анализ происходит в вашем агенте. Сервер поставляет данные; навыки поставляют метод.

Ограничения

• Запускайте локально. YouTube агрессивно ограничивает по частоте IP-адреса дата-центров — это локальный stdio-сервер по замыслу, а не размещённый сервис.

• YouTube меняет внутренности без предупреждения; если что-то ломается — обновитесь (npx всегда подтягивает последнюю версию) и создайте issue с ID неработающего видео.

• Видео с отключёнными субтитрами невозможно транскрибировать (редкий случай; об этом явно говорит ошибка).

• Сбор субтитров находится в серой зоне условий использования YouTube — нормально для локального исследовательского инструментария, но не стройте на этом размещённый платный продукт.

Разработка

npm install && npm run build
npm test          # unit tests (offline)
npm run test:live # live smoke tests against real videos — run before publishing
npm run inspect   # MCP Inspector against the built server

MIT — см. LICENSE.

Создано Anir — я автоматизирую всё. Ещё на agramprojects.com.