Pular para o conteúdo
PT
Obter chave API

Fluxos de trabalho / JavaScript

Conecte um cliente Node.js MCP à pesquisa Google e YouTube

Conecte-se a FlashData sobre HTTP Streamable, descubra ferramentas MCP, e envie um pedido de busca Google explícito de Node.js usando o SDK oficial.

FlashData · Actualizado

Um cliente conectado através de uma interface compartilhada para ferramentas de busca e vídeo

MCP permite que um cliente discover ferramentas e chamá-los através de um protocolo compartilhado. FlashData expõe Google Search e YouTube ferramentas de dados através de um remoto endpoint streamable HTTP. Este tutorial conecta um cliente Node.js, lista as definições de ferramentas disponíveis, e executa uma pesquisa apenas quando você explicitamente habilitá-lo.

Este é um guia de integração de protocolo. Se você quer que as funções comuns Python se registrem com uma estrutura de agentes, use Adicione Google e YouTube ferramentas de busca para um agente de IA.

Instale o SDK e mantenha a chave API no servidor.

Use Node.js 22 ou mais tarde. O exemplo usa a versão oficial MCP SDK já verificada na documentação FlashData. Mantenha a chave API em um ambiente de servidor; não a incorpore em um pacote de navegador, repositório público ou 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'

O ponto final é https://data.flashdata.dev/mcp. Autenticação usa o X-API-Key Cabeçalho. Você não precisa iniciar um servidor FlashData local. Essa conexão usa o Streamable HTTP, não um comando stdio.

Conecte, inspecione ferramentas e, opcionalmente, execute uma busca

Salve este arquivo como mcp-search.mjs. Por padrão, ele chama listTools() e imprime os nomes de ferramentas disponíveis e o esquema de entrada Google Search. Descobrir ferramentas não executa uma consulta paga.

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

MCP argumentos são simples

REST e MCP descrevem a mesma tarefa de busca com diferentes formas de solicitação. Uma consulta REST coloca o país e os controles de linguagem dentro params. Uma ferramenta MCP recebe gl, hl, num e.. page diretamente em arguments; Não envie um REST params objeto à ferramenta MCP. Campos desconhecidos são rejeitados.

Para YouTube, inspecione o esquema de ferramentas antes de construir uma chamada. Uma ferramenta de transcrição leva video_id, language e.. auto; auto seleciona a faixa automática existente ou fornecida pelo carregador. Não gera legendas para um vídeo que não as tem.

Lidar com trabalhos assíncronos e grandes resultados

Use mode: "async" Quando você quer um recibo de trabalho em vez de um resultado em tempo real. Mantenha o trabalho devolvido ID e passe-o como job_id para get_job. Trabalhos completados incluem a resposta original em output; Os resultados são retidos para 24 horas após a conclusão. Ler um trabalho não submete a pergunta novamente.

Grandes resultados podem chegar como um pedaço de texto JSON com result_id e.. next_offset. Chame get_result com a mesma chave e continuar usando o deslocamento de volta até next_offset é null. Concatenar pedaços em ordem antes de analisar. O limite é medido em UTF-16 unidades de código, não linhas ou bytes. O cache de resultados dura minutos 10, tem no máximo quatro grandes resultados por chave, e pode despejar resultados mais cedo.

Para entregar vídeo ou áudio para o seu armazenamento, ligue para youtube_download com um storage Destino e uma chave API que concede youtube_download. Salve o trabalho de volta ID e pesquisa get_job. Para processamento Bulk baseado em arquivos, use o API de processamento Bulk.

Tratar falhas de acordo com o que aconteceu

Uma troca HTTP bem sucedida ainda pode conter um resultado de ferramenta com isError: true; Verifique esse campo. Erros de ferramenta retêm status e identificadores de pedidos úteis. Conserte argumentos inválidos, permissões ou saldo de crédito antes de tentar novamente.

Um intervalo ou conexão perdida não prova que uma consulta não foi executada. Por... query_outcome_unknown, inspecione o pedido History antes de reenviar. Este cliente deliberadamente não tem nenhum circuito de repetição automática em torno de uma chamada de ferramentas paga. Grandes respostas são limitadas a 4 MiB, então comece com uma pequena contagem de resultados.

Consultas usam o preço dos créditos existentes, sem nenhum custo adicional do MCP. Leia o Referência MCP, MCP visão geral e.. Precificação antes de escolher o tamanho de um lote para um cliente de produção.