본문으로 건너뛰기
KO
API 키 받기

작업 흐름 / JavaScript

Node.js MCP 클라이언트를 Google Search 및 YouTube에 연결하십시오

스트리밍 가능한 HTTP, discover MCP 도구에 FlashData에 연결하고 공식 SDK를 사용하여 Node.js에서 명시된 Google Search 요청을 보냅니다.

FlashData · 업데이트

공유 인터페이스를 통해 연결된 클라이언트는 검색 및 비디오 도구

MCP는 클라이언트 discover 도구를 허용하고 공유 프로토콜을 통해 호출합니다. FlashData는 원격 스트림 가능한 HTTP 엔드포인트를 통해 Google Search 및 YouTube 데이터 도구를 노출합니다. 이 튜토리얼은 Node.js 클라이언트를 연결하고 사용 가능한 도구 정의를 나열하고 명시적으로 활성화 할 때만 검색을 실행합니다.

이것은 프로토콜 통합 가이드입니다. 일반 Python 기능을 원하면 에이전트 프레임 워크를 등록하고 사용 AI 에이전트에 Google 및 YouTube 검색 도구 추가.

SDK를 설치하고 서버에서 API 키 유지

Node.js 22 또는 나중에 사용하십시오. 예를 들어 공식 MCP SDK 버전을 이미 FlashData 문서에서 확인했습니다. 서버 환경에서 API 키 유지; 브라우저 번들, 공공 저장소 또는 MCP 엔드 포인트 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'

끝점은 https://data.flashdata.dev/mcp. 인증은 X-API-Key 헤드러. 로컬 FlashData 서버를 시작할 필요가 없습니다. 이 연결은 Streamable HTTP를 사용하여 stdio 명령이 아닙니다.

연결, 검사 도구 및 선택적으로 한 검색을 실행

이 파일을 저장 mcp-search.mjs. 기본적으로 호출 listTools() 그리고 사용할 수 있는 도구 이름과 Google Search 입력 스키마를 인쇄합니다. Discovering tools는 유료 데이터 쿼리를 실행하지 않습니다.

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 인수는 평평

REST와 MCP는 다른 요청 모양과 동일한 검색 작업을 설명합니다. REST 쿼리 장소 국가 및 언어 제어 내부 params. MCP 도구 수신 gl, hl, num 으로 page 직접 안으로 arguments; REST를 보내지 마십시오 params MCP 도구에 객체. 알 수없는 필드가 거부됩니다.

YouTube의 경우, 호출을 생성하기 전에 공구 스키마를 검사합니다. transcript 도구는 video_id, language 으로 auto; auto 기존의 자동 또는 로더 보호 트랙을 선택합니다. 그것은 그들을 부족한 비디오에 대한 캡션을 생성하지 않습니다.

비동기 작업과 큰 결과 처리

제품 정보 mode: "async" 실시간 결과 대신 작업 영수증을 원할 때. 반환된 일을 지키십시오 ID는 그것을 것과 같이 통과합니다 job_id 으로 get_job. 완료된 작업은 원래 응답을 포함 output; 결과는 완료 후에 24 시간을 위해 유지됩니다. 작업이 다시 쿼리를 제출하지 않습니다.

큰 결과는 JSON 텍스트 펑크로 도착 할 수 있습니다. result_id 으로 next_offset. 호출 get_result 동일한 열쇠로, 반환 상쇄를 사용하여 계속 next_offset null입니다. 패싱하기 전에 주문에 펑크를 넣으십시오. 한계는 UTF-16 코드 단위에서, 줄 또는 바이트 아닙니다 측정됩니다. 결과 캐시는 10 분을 지속하며 키 당 최대 4 개의 큰 결과를 보유하며 곧 결과를 완화 할 수 있습니다.

비디오 또는 오디오를 저장하기 위해, 통화 youtube_download 으로 a storage 대상과 API 키는 youtube_download를 부여합니다. 반환된 작업 ID 및 설문 조사 저장 get_job. 파일 기반 Bulk 처리를 위해, 사용 Bulk 처리 API.

무슨 일이 있었는지에 따라 치료 실패

성공적인 HTTP 교환은 여전히 공구 결과를 포함 할 수 있습니다. isError: true; 그 분야를 검사하십시오. 도구 오류는 유용한 업스트림 상태를 유지하고 식별자를 요청합니다. 다시 시도하기 전에 잘못된 인수, 허가 또는 신용 잔액을 수정합니다.

timeout 또는 잃어버린 연결은 쿼리가 실행되지 않았는지 증명하지 않습니다. 으로 query_outcome_unknown, resubmitting의 앞에 요구 History를 검사하십시오. 이 클라이언트는 deliberately 지불한 공구 통화의 주위에 자동적인 구호 반복이 없습니다. 큰 상류 응답은 4 MiB로 제한되어 있으므로 작은 결과 카운트로 시작합니다.

기존의 크레딧 가격을 사용하려면 추가 MCP 요금이 부과되지 않습니다. 읽음 MCP 참조, MCP 개요 으로 가격 : concurrency 또는 일괄 크기 선택하기 전에 생산 클라이언트에 대 한.