Tube Search

Búsqueda en Tube

Documentación

tube-search-mcp

Servidor MCP para Archivarix Tube Search — busca videos archivados de YouTube mediante asistentes de IA.

Busca entre más de mil millones de videos de YouTube indexados desde 2005. Encuentra videos eliminados, metadatos, miniaturas y subtítulos.

Inicio rápido

npx tube-search-mcp --api-key tsk_YOUR_KEY

O con variable de entorno:

export TUBE_API_KEY=tsk_YOUR_KEY
npx tube-search-mcp

Obtén tu clave de API en tube.archivarix.net (Perfil → Claves de API).

Configuración

Claude Desktop

Agrega a ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Claude Code

Agrega a ~/.claude/mcp.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

VS Code

Agrega a .vscode/mcp.json en tu proyecto:

{
  "servers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Cursor

Agrega a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tube-search": {
      "command": "npx",
      "args": ["-y", "tube-search-mcp"],
      "env": {
        "TUBE_API_KEY": "tsk_YOUR_KEY"
      }
    }
  }
}

Herramientas disponibles

Herramienta	Descripción
`search_channel`	Encuentra todos los videos archivados de un canal de YouTube
`search_videos`	Búsqueda de texto completo en títulos y descripciones de videos
`get_video`	Obtén metadatos de un video específico por ID
`get_subtitles`	Obtén la transcripción como texto plano legible
`get_summary`	Obtén un resumen del video generado por IA
`generate_summary`	Genera un nuevo resumen de IA para un video
`browse_summaries`	Explora resúmenes por etiqueta, canal o idioma
`get_video_status_history`	Consulta el historial de cambios de estado de un video
`get_usage`	Consulta tu uso actual de API y límites

Recursos

URI	Descripción
`tube://video/{videoId}`	Metadatos del video
`tube://channel/{channelId}`	Información del canal
`tube://subtitles/{videoId}`	Transcripción como texto plano
`tube://summary/{videoId}`	Resumen generado por IA
`tube://tags`	Etiquetas de resúmenes populares

Prompts

Prompt	Descripción
`research_video`	Flujo de trabajo integral de análisis de videos
`channel_overview`	Investigación y estadísticas de canales
`find_deleted`	Descubre y analiza videos eliminados

Variables de entorno

Variable	Descripción	Predeterminado
`TUBE_API_KEY`	Clave de API (obligatoria)	—
`TUBE_MCP_URL`	Endpoint MCP personalizado	`https://tube.archivarix.net/mcp`

Cómo funciona

Este paquete actúa como un proxy stdio-a-HTTP. Se conecta al servidor MCP remoto de Archivarix Tube Search mediante Streamable HTTP y expone las mismas herramientas, recursos y prompts a través del transporte stdio para clientes de IA locales.

AI Client ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp

Documentación

Documentación completa: tube.archivarix.net/guide/mcp

Licencia

MIT