TubeScout 🔭

YouTube을 AI 에이전트를 위한 리서치 엔진으로 바꿔드립니다. API 키가 필요 없는 MCP 서버와 스킬 팩으로, 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 키도, 설정도 필요 없습니다. 그런 다음 에이전트에게 이렇게 물어보세요:

"지난 달 n8n에 관한 가장 많이 본 영상 5개를 찾아서 사람들이 무엇에 어려움을 겪고 있는지 요약해줘."

가장 쉬운 올인원 (Claude Code): 플러그인으로 설치 — MCP 서버 + 6개 스킬 전부를 두 개의 명령어로:

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

또는 스킬 팩을 수동으로 설치 (Claude 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

도구

스킬 (리서치 방법론)

모든 스킬은 컨텍스트 인식형입니다: 대화에서 무엇을 만들고 있는지, 스택, 이미 분석한 영상을 읽고, 일반적인 조언 대신 실제 레버리지에 맞춘 판정을 제공합니다.

세 개의 "월 X달러 버는 방법" 영상에 대한 실제 /yt-breakdown 실행 결과를 확인하세요 — 회의론자 검증을 통과한 것과 통과하지 못한 것이 무엇인지 포함해서요.

작동 방식 (솔직하게)

여기에는 마법이 없습니다. 그리고 그게 핵심입니다:

• youtubei.js는 YouTube의 내부 InnerTube API와 통신합니다 — 사이트가 사용하는 것과 동일한 API입니다. 키도, 할당량도 없습니다.

• 트랜스크립트는 YouTube 자체 자막이며, 폴백 체인으로 가져옵니다: ANDROID 클라이언트 timedtext 트랙 → InnerTube 트랜스크립트 엔드포인트 (간헐적으로 400 오류 발생 — 백오프로 재시도) → 로컬에 yt-dlp가 있으면 사용. 각 응답은 어떤 source가 제공했는지 알려줍니다.

• 모든 분석은 당신의 에이전트에서 이루어집니다. 서버는 데이터를 제공하고, 스킬은 방법을 제공합니다.

제한 사항

• 로컬에서 실행하세요. YouTube는 데이터센터 IP를 적극적으로 속도 제한합니다 — 이 서버는 설계상 호스팅 서비스가 아닌 로컬 stdio 서버입니다.

• YouTube는 예고 없이 내부를 변경합니다; 문제가 생기면 업데이트하고 (npx는 항상 최신 버전을 가져옴) 실패한 영상 ID와 함께 이슈를 등록하세요.

• 자막이 비활성화된 영상은 트랜스크립트를 만들 수 없습니다 (드묾; 오류 메시지에 명시적으로 표시됨).

• 자막 스크래핑은 YouTube ToS의 회색 지대에 있습니다 — 로컬 리서치 도구로는 괜찮지만, 호스팅 유료 제품을 만들지 마세요.

개발

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에서.