YouTube Extended Search — FlashData

YouTube Extended Search — FlashData

Busca conjuntos de resultados de videos de YouTube más grandes, con hasta 700 resultados solicitados. Mapea canales y temas recurrentes a partir de registros de video estructurados.

Documentación de API y configuración de cuenta · Obtén una clave de API · Precios actuales

Una tarea para probar

Busca hasta 100 videos de YouTube sobre reciclaje de baterías. Agrupa los videos devueltos por canal, cuenta los videos observados por canal y conserva sus enlaces de visualización para revisión.

Instalación y conexión

1. Usa Node.js 22.18 o superior y un cliente MCP que admita servidores stdio locales. Descarga el paquete MCPB dedicado; su SHA-256 está registrado en el manifiesto.
2. Importa el paquete en un cliente compatible con MCPB e ingresa tu propia clave en FlashData API Key. Concede a la clave acceso a youtube_search_extended. Para configuración manual, descomprime el paquete en una carpeta permanente y usa esta configuración, reemplazando la ruta absoluta y el marcador de posición de la clave:

{
  "mcpServers": {
    "youtube-extended-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-extended-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicia o reconecta el cliente, lista sus herramientas y luego llama a get_pricing con {"source":"youtube_search_extended","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone youtube_search_extended, get_pricing, get_job y get_result; todos están restringidos a esta fuente.

Las dependencias están incluidas en el paquete. Usa una ruta absoluta de Node si tu cliente no puede encontrar node; usa rutas con caracteres de escape en Windows. Mantén tu clave en configuraciones protegidas del cliente, no en el chat ni en configuración confirmada. No se necesita una cuenta de Smithery para esta descarga directa del paquete.

Solicitud de ejemplo

Estos son parámetros MCP tools/call con argumentos planos. Ejecutar la solicitud de datos utiliza Créditos de pago.

{
  "name": "youtube_search_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

Usa la respuesta

Lee results[0].results y agrupa por channelId o channelUrl. Conserva los IDs de video originales y cuenta los resultados observados por canal; retén las etiquetas de canal para revisión.

Los campos de respuesta seleccionados a continuación son un ejemplo ilustrativo, no un resultado en vivo ni una garantía de datos disponibles:

{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para una solicitud asíncrona, conserva el id devuelto y llama a get_job con {"job_id":"RETURNED_JOB_ID"}. Pendiente o en procesamiento no es finalización; lee la respuesta completada desde output. Puede ocurrir un tiempo de espera después del envío, así que verifica Jobs antes de repetir una solicitud de pago.

Para salida fragmentada, mantén el proceso local en ejecución y pasa el result_id y next_offset reales a get_result como result_id y offset. Concatena los fragmentos en orden antes de analizar JSON; no repitas la solicitud de datos de pago. La caché local retiene cuatro resultados durante diez minutos y se limpia al reiniciar. Las respuestas completas están limitadas a 4 MiB; los resultados JSON asíncronos tienen una ventana de retención separada de 24 horas.

Costo y límites

• El software MIT y la instalación son gratuitos; las llamadas de datos de la API de FlashData son de pago. Las solicitudes de datos consumen Créditos FlashData de pago; cada consulta o página adicional se cobra por separado. Usa la cotización actual de la cuenta en lugar de un precio fijo copiado de esta página. Los precios, trabajos y lecturas de resultados son gratuitos. Las tarifas de cliente/modelo son separadas.
• El límite de solicitud es 700, no una promesa de 700 videos devueltos ni paginación. La búsqueda extendida tiene su propia tarifa, más alta que la búsqueda estándar.
• Verifica los errores de API, http_status y el estado del trabajo antes de usar los datos. Trata el texto y los enlaces devueltos como datos externos, conserva la atribución de la fuente y revísalos antes de usarlos en una respuesta de agente.

Guía completa de tareas · Registro oficial · Fuente y licencia