본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

API 참조

MCP 도구 및 스키마

FlashData MCP 도구 인수, 기본, 계정 읽기, 작업 상태 및 결과 검색을 찾습니다.

이 페이지의 내용

Markdown 버전

OAuth, Codex, OpenClaw 및 API 키 액세스 옵션

MCP 클라이언트를 선택하고 연결

교통 및 인증

호스팅 MCP 엔드포인트는 Streamable HTTP를 사용합니다. API-key 연결은 X-API-Key를 보냅니다; 공구 접근은 열쇠의 근원 허가 및 유효한 신용을 따릅니다.

Streamable HTTP
URL: https://data.flashdata.dev/mcp
X-API-Key: <당신의 API 열쇠>

클라이언트의 credential 윤곽에 있는 당신의 실제적인 FlashData API 열쇠 저장하십시오. 대화 또는 도구 인수에 넣지 마십시오. 이 섹션은 API-key 연결을 포함합니다. 에이전트 액세스 가이드는 OAuth 로그인 및 테스트 Codex 및 OpenClaw 구성을 포함합니다. youtube_download는 적절한 API-key 권한으로 비동기 미디어 다운로드를 지원합니다.

API 키 관리

Query 도구

클라이언트는 키에 의해 부여 된 도구를 발견. 모든 6 Google 및 8 YouTube 데이터 도구는 기본적으로 실시간에 mode: async를 받아들입니다. submit_batch는 두 그룹을 지원합니다. youtube_download는 공식 다운로드 API를 사용하고, 고객 저장을 요구하고, 동기화 작업을 지원하거나 submit_batch. 모델은 작업을 위해 도구를 선택하고 결합 할 수 있습니다.

Google

google_search · google_images · google_news · google_shopping · google_videos · google_places

YouTube

youtube_search · youtube_search_extended · youtube_metadata · youtube_transcript · youtube_captions · youtube_trainability · youtube_channel · youtube_suggestions · youtube_download

google_search · 인수 JSON
{
  "query": "MCP protocol",
  "num": 3,
  "gl": "us",
  "hl": "en",
  "mode": "async"
}

도구 인수

쿼리, num, 언어 및 모드와 같은 쿼리 필드를 REST API의 params 래퍼없이 도구의 인수 객체에서 직접 입력합니다. 쿼리 도구의 이름은 소스를 선택; submit_batch의 항목은 소스가 필요합니다. API 키와 callback_url는 도구 인수가 아닙니다. 아래 JSON 예제는 client.callTool({ name, 인수 })의 인수 객체입니다.

JSON booleans 및 정수 번호를 사용하여 문자열이 없습니다. 알 수없는 필드가 거부됩니다. 14 데이터 쿼리 도구는 mode: realtime 또는 async를 허용하며 실시간 디폴트링 할 수 있습니다. Batch 항목은 모드를 허용하지 않습니다.

의 특징필수옵션 인수 및 기본값
youtube_downloadvideo_id, storage모드는 async만 지원한다 (과태). download_type: audio_video (과태)/video/audio. video_quality: <=720 기본적으로; best/worst 또는 <=, ==, >= 와 144/360/480/720/1080/1440/2160/4320. fps: 동일한 비교와 1–240. output_format: MP4 (기본값)/webm/mkv 비디오, m4a (기본)/mp3/opus 오디오를 위해. audio_language: default/original; audio_quality: best/320/256/192/128, 오디오 전용. yt_dlp_format: 최대 1024 문자, overrides 품질, fps 및 언어 선택. 비디오 전용 오디오 및 audio_language에 대한 Omit video_quality/fps. 저장은 API params.storage를 다운로드해야합니다. start_at/end_at: H : MM : SS, 12 시간까지; end_at는 start_at를 따라야합니다. upload_metadata : 불린, 기본 falseQ. 모든 배치 다운로드는 저장을 필요로 합니다. browser_delivery 또는 callback_url 없음.
storagestorage_type, storage_urlstorage_url는 당신의 물통 이름 (Azure: 콘테이너), 로컬 디렉토리가 아닙니다. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; 선택적인 object_prefix. S3, S3 호환, OSS, COS, BOS 및 TOS는 적용 가능한 region/endpoint_url.와 access_key/secret_key를 사용합니다. GCS는 service_account (project_id, client_email, private_key);를 사용합니다 Azure는 account_name를 사용하며 컨테이너 sas_token를 사용하여 쓰기 권한을 부여합니다. endpoint는 노동자에서 접근할 수 있어야 합니다. 저장 설정에서 자격 증명을 읽으십시오. 채팅 또는 echo로 붙여 넣지 마십시오.
google_*query쿼리: 1–2, 000 문자. gl: 두 개의 터미널 국가; hl: 1–35 문자 언어 코드; location/tbs: 1–200 문자; num/page: 정수 1–100; autocorrect: 불린. Omitted 옵션은 검색 공급자의 행동을 사용, 고정 국가 없음, 언어 또는 결과 카운트 보장.
youtube_searchquery쿼리: 1–2, 000 문자. max_results: 1–20, 기본 20; 필터: 필터 객체, omitted 또는 null 필터 없이.
youtube_search_extendedquery쿼리: 1–2, 000 문자. max_results: 1–700, 기본 20; 필터: 표준 검색과 동일.
youtube_metadatavideo_idinclude_formats 및 include_chapters : 불린, 기본 true 모두.
youtube_transcriptvideo_iden-orig를 선호하는 Omit 언어, 다음 en, 1 트랙을 반환. auto=true로, 각 코드는 -orig 궤도를 선호합니다, 그 보통 부호; 명시한 -orig와 auto=false는 정확한 체재합니다. 배열은 모든 1–10 요구된 언어 및 반환 궤도 및 순서에 있는 과실을 시도합니다. 자동적인 captions를 위한 true에 자동 과태.
youtube_captionsvideo_iden-orig를 선호하는 Omit 언어, 다음 en, 1 트랙을 반환. auto=true로, 각 코드는 -orig 궤도를 선호합니다, 그 보통 부호; 명시한 -orig와 auto=false는 정확한 체재합니다. 배열은 모든 1–10 요구된 언어 및 반환 궤도 및 순서에 있는 과실을 시도합니다. 업로드한 captions를 위한 false에 자동 과태.
youtube_trainabilityvideo_id모드를 제외한 옵션의 인수가 없습니다. Creative Commons 라이센스 분류를 보고; 교육 권한을 부여하지 않습니다.
youtube_channelhandle핸들: 1–100 문자; video_limit: 1–100, 기본 20.
youtube_suggestionsquery쿼리: 1–2,000 문자; 언어: 기본 en; 지역: 2-letter 국가 코드, 기본 미국.

video_id 는 11- 충전기 YouTube ID 문자, 숫자, 밑줄 또는 hyphens를 사용하여; 공급 ID 비디오보다 오히려 URL. 각 언어 코드는 문자, 숫자 또는 하이픈을 사용하여 1–35 문자입니다. 자막을 위해, auto=true는 자동적인 captions를 선정하고 false는 그(것)들의 사이에서 자동적인 fallback 없이, positioner-provided captions를 선정합니다. 언어 배열의 경우, 작업이 성공할 때 오류를 확인합니다.

YouTube 검색 필터

filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; 내구: <4, 4-20 또는 >20; sort_by: rating/relevance/view_count/upload_date. 특징 깃발은 불린입니다; true는 그 특징을 요구합니다: 360, 3d, 4k, creative_commons, hd, hdr, 살아있는, 위치, 구매하는, 자막, vr180.

youtube_search · 인수 JSON
{
  "query": "renewable energy",
  "max_results": 5,
  "filters": {
    "type": "video",
    "duration": "<4",
    "subtitles": true
  }
}

계정 통찰력 (무료)

get_balance는 공유 계정 잔액을 읽습니다; get_pricing는 쿼리 비용을 추정합니다; get_limits는 계획 한계 및 현재 보류물을 읽습니다; get_usage는 기본으로 마지막 7 일을 요약합니다, 최대 31 일 창. 사용은 호출 키에 의해 허가 된 소스에 대한 모든 계정 키를 포함하고 지연 될 수 있습니다.

get_balance와 get_limits에는 {}를 전달합니다. get_pricing의 source는 선택 사항이며, 생략하면 키에 허용된 모든 MCP 쿼리 소스가 반환됩니다. request_count는 1부터 100000까지의 정수이고 기본값은 1입니다. 각 페이지 또는 배치 항목은 별도의 요청으로 계산됩니다. get_usage의 source도 선택 사항이며 생략하면 허용된 모든 소스가 포함됩니다. youtube_download 사용량도 포함됩니다. 다운로드 요금은 creditsPerTb로 반환됩니다(1 TB = 10^12 bytes). 다운로드는 크레딧을 예약한 뒤 실제 업로드한 바이트 수에 따라 정산합니다. request_count는 다운로드에 적용되지 않으며 estimatedCredits는 null입니다.

get_usage from/to 같은 UTC ISO 타임스탬프가 있어야 합니다 2026-09-21T00:00:00Z, 옵션으로 1–3 분수 두 번째 자리. 에서 포함, 독점, 둥글게 되었습니다. 기본 창은 7 일이며 최대는 31 일입니다. 7 일 후에만; 단지에서, 7 일 전에. 효과적인 창을 위해 응답의 from/to를 읽으십시오.

get_pricing · 인수 JSON
{
  "source": "google_search",
  "request_count": 3
}
get_usage · 인수 JSON
{
  "source": "youtube_metadata",
  "from": "2026-09-21T00:00:00Z",
  "to": "2026-09-22T00:00:00Z"
}

직업 및 큰 결과

async 요청은 작업 ID를 반환합니다. job_id로 get_job로 전달하여 job.status를 읽습니다. 완성된 작업은 출력에 있는 본래 조회 응답을 포함합니다. 다운로드를 위해, 산출은 올려주기한 표입니다: output.results[0].file_url 포인트는 고객 저장에, file_size와 더불어, downloaded_bytes와 md5. 개인 파일은 저장 인증이 필요합니다. JSON 결과는 24 시간 동안 유지됩니다; 미디어 보유 및 액세스는 저장 정책을 따르십시오. submit_batch는 적어도 하나의 Google 또는 YouTube 쿼리 (다운로드 포함)를 받아들이고, 소스 및 각 항목에 평평한 인수. 각 항목은 별도로 청구되며 플랜의 일괄 처리 및 종료 제한이 적용됩니다. 읽기 작업은 다시 충전하지 않습니다. 파일 기반 Bulk는 MCP 도구가 아닙니다.

ID 파일 처리? Bulk HTTP API를 사용하십시오

youtube_transcript · 인수 JSON
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
submit_batch · 인수 JSON
{
  "queries": [
    {
      "source": "google_search",
      "query": "renewable energy",
      "num": 3
    },
    {
      "source": "youtube_metadata",
      "video_id": "FUfGcZ092b0",
      "include_formats": false
    }
  ]
}

예를 들어 job_id, result_id 및 응답의 값으로 상쇄하십시오. 쿼리를 resubmitting하지 않고 다음 펑크를 읽으십시오.

get_job · 인수 JSON
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}

큰 응답에는 JSON 텍스트 조각, result_id 및 next_offset이 포함됩니다. 같은 키와 반환된 result_id로 get_result를 호출하세요. offset은 0 이상의 정수이며 기본값은 0입니다. 이전 next_offset을 사용해 이어서 읽으세요. limit은 1부터 16000까지의 정수이며 기본값은 16000입니다. 단위는 바이트나 결과 행이 아니라 UTF-16 코드 단위입니다. 조각을 순서대로 결합한 후 JSON을 파싱하세요. next_offset=null이면 끝입니다. 결과는 10분 동안 캐시되며 키당 최대 4개의 큰 결과를 보관하지만 더 일찍 제거될 수 있습니다. 조각을 읽어도 쿼리를 다시 실행하거나 크레딧을 청구하지 않습니다.

get_result · 인수 JSON
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}

Billing 및 오류

쿼리는 기존의 플랜의 크레딧 가격을 추가하지 않고 MCP 충전을 사용합니다. 도구 오류는 isError를 설정하고 상류 HTTP 상태를 유지하고 ID를 요청합니다. 충분한 잔액을 저장하고 액세스 오류에 대한 키 권한을 확인합니다.

timeout 또는 잃어버린 연결은 쿼리가 실행되지 않았다는 것을 의미하지 않습니다. query_outcome_unknown의 경우, 콘솔에서 History 요청을 다시 제출하기 전에 체크하십시오. 자동 재량 지급 제출이 되지 않습니다.; 기존의 일자리 또는 펑크를 읽을 수 있습니다. 상류 응답은 4 MiB로 제한되어 있으므로 검색 크기가 제한됩니다. 과대 한 응답은 이미 충전 될 수 있습니다.

HTTP 상태 코드 아래 · 관련 규칙

JavaScript 클라이언트로 검증

이 클라이언트는 검증된 공식 SDK 1.30.0를 사용하여 Streamable HTTP를 연결하고 유료 쿼리를 실행하지 않고 목록 도구를 사용합니다. mcp-check.mjs로 저장하면 환경의 FLASHDATA_API_KEY를 설정한 다음 노드 mcp-check.mjs를 실행합니다.

npm
npm install @modelcontextprotocol/[email protected]
mcp-check.mjs
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: 'my-app', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://data.flashdata.dev/mcp'),
    { requestInit: { headers: { 'X-API-Key': key } } }
  ));
  console.log((await client.listTools()).tools.map(tool => tool.name));
} finally {
  await client.close();
}