Saltar al contenido
ES
Obtener clave API

Corrientes de trabajo / JavaScript

Conectar un cliente Node.js MCP a Google Buscar y YouTube

Conéctese a FlashData sobre Streamable HTTP, descubra las herramientas MCP y envíe una solicitud explícita de búsqueda Google desde Node.js usando el SDK oficial.

FlashData · Actualizado

Un cliente conectado a través de una interfaz compartida a herramientas de búsqueda y vídeo

MCP permite a un cliente descubrir herramientas y llamarlas a través de un protocolo compartido. FlashData expone las herramientas de datos Google Search y YouTube a través de un terminal remoto Streamable HTTP. Este tutorial conecta un cliente Node.js, enumera las definiciones de herramientas disponibles, y ejecuta una búsqueda sólo cuando lo habilita explícitamente.

Esta es una guía de integración de protocolos. Si desea que las funciones Python ordinarias se registren con un marco de agente, use Añadir herramientas de búsqueda Google y YouTube a un agente AI.

Instala la tecla SDK y guarda la tecla API en el servidor

Uso Node.js 22 o más tarde. El ejemplo utiliza el funcionario MCP SDK versión ya verificada en el FlashData documentación. API llave en un entorno servidor; no lo incruste en un paquete de navegador, repositorio público o MCP endpoint URL.

bash
mkdir flashdata-mcp-client
cd flashdata-mcp-client
npm init -y
npm install @modelcontextprotocol/[email protected]
export FLASHDATA_API_KEY='your-api-key'

El punto final es https://data.flashdata.dev/mcp. La autenticación utiliza X-API-Key header. No es necesario iniciar un servidor FlashData local. Esta conexión utiliza Streamable HTTP, no un comando stdio.

Conectar, inspeccionar herramientas y ejecutar opcionalmente una búsqueda

Guardar este archivo como mcp-search.mjs. Por defecto llama listTools() e imprime los nombres de las herramientas disponibles y el esquema de entrada Google Buscar. Descubrir herramientas no ejecuta una consulta de datos pagados.

javascript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error("Set FLASHDATA_API_KEY first.");
const client = new Client({ name: "search-example", version: "1.0.0" });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL("https://data.flashdata.dev/mcp"),
    { requestInit: { headers: { "X-API-Key": key } } },
  ));
  const { tools } = await client.listTools();
  console.log("Available tools:", tools.map(tool => tool.name));
  const search = tools.find(tool => tool.name === "google_search");
  if (!search) throw new Error("google_search is not available to this client.");
  console.log("Search input schema:", JSON.stringify(search.inputSchema, null, 2));
  if (process.env.RUN_SEARCH === "1") {
    const result = await client.callTool({
      name: "google_search",
      arguments: { query: process.env.SEARCH_QUERY ?? "MCP protocol",
        gl: "us", hl: "en", num: 3, page: 1, mode: "realtime" },
    });
    if (result.isError) {
      console.error(JSON.stringify(result, null, 2));
      process.exitCode = 1;
    } else {
      console.log(JSON.stringify(result, null, 2));
    }
  } else {
    console.log("Discovery complete. Set RUN_SEARCH=1 to submit a billable query.");
  }
} finally {
  await client.close();
}
bash
node mcp-search.mjs
# Run only when you are ready to submit a search using account Credits:
RUN_SEARCH=1 SEARCH_QUERY='MCP protocol' node mcp-search.mjs

Los argumentos MCP son planos

REST y MCP describen la misma tarea de búsqueda con diferentes formas de solicitud. Una consulta REST coloca los controles de país y lenguaje dentro params. Una herramienta MCP recibe gl, hl, num y page directamente en arguments; no enviar un REST params objeto a la herramienta MCP. Los campos desconocidos son rechazados.

Para YouTube, inspeccione el esquema de herramientas antes de construir una llamada. video_id, language y auto; auto selecciona la pista automática existente o suministrada por el cargador. No genera capciones para un vídeo que les falta.

Trabajos asincrónicos y grandes resultados

Uso mode: "async" cuando usted quiere un recibo de trabajo en lugar de un resultado en tiempo real. Mantenga el trabajo devuelto ID y pasarlo como job_id a get_job. Los trabajos completados incluyen la respuesta original en output; los resultados se retienen para 24 horas después de la terminación. Leer un trabajo no envía la consulta de nuevo.

Los grandes resultados pueden llegar como un fragmento de texto JSON con result_id y next_offset. get_result con la misma llave y seguir utilizando el offset devuelto hasta next_offset es null. Mangos concatenados en orden antes de analizar. El límite se mide en unidades de código UTF-16, no filas o bytes. El caché de resultado dura los minutos 10, tiene en la mayoría de cuatro resultados grandes por clave, y puede desalojar los resultados antes.

Para entregar vídeo o audio a su almacenamiento, llame youtube_download con una storage destino y una tecla API que otorga youtube_download. Guardar el trabajo devuelto ID y la encuesta get_job. Para el procesamiento Bulk basado en archivos, utilice el API de procesamiento Bulk.

Treat fallas según lo que pasó

Un exitoso intercambio HTTP todavía puede contener un resultado de la herramienta con isError: true; verifique ese campo. Los errores de herramientas conservan el estado de corriente y los identificadores de solicitud útiles. Arreglar argumentos inválidos, permisos o saldo de crédito antes de intentarlo de nuevo.

Una conexión temporal o perdida no prueba que una consulta no fue ejecutada. query_outcome_unknown, inspeccionar la historia de la solicitud antes de volver a presentar. Este cliente deliberadamente no tiene un bucle automático de reingreso alrededor de una llamada de herramienta pagada. Grandes respuestas preliminares se limitan a 4 MiB, así que comience con un pequeño recuento de resultados.

Las consultas usan los precios de los créditos existentes, sin cargo adicional MCP. Lea el Referencia de MCP, MCP y fijación de precios antes de elegir los tamaños de concurrencia o lote para un cliente de producción.