ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เอกสารอ้างอิง API

เครื่องมือและสคีมา MCP

เงยหน้าขึ้นดู FlashData MCP อาร์กิวเมนต์ของเครื่องมือ, ค่าปริยาย, อ่านบัญชีผู้ใช้, รัฐงาน และผลที่ได้จากการดึงข้อมูล

ในหน้านี้

เวอร์ชัน Markdown

OAuth, Codex, OpenClaw ถึง API- ตัวเลือกการเข้าใช้คีย์

เลือกของคุณ MCP โปรแกรมลูกข่ายและการเชื่อมต่อ

การรับส่งข้อมูลและการตรวจสอบสิทธิ์

เจ้าของโฮสต์ MCP จุดสิ้นสุดใช้สายข้อมูลได้ HTTP. APIการเชื่อมต่อคีย์ส่ง X-API-Keyการใช้งานเครื่องมือต่อไปนี้สิทธิ์ของกุญแจและหน่วยกิตที่มีอยู่

ประมวลผลได้ HTTP
URL: https://data.flashdata.dev/mcp
X-API-Key[คุณ... API กุญแจ:

เก็บจริง ๆ ของคุณ FlashData API เคล็ด ลับ ใน การ ปรับ ปรุง ความ เชื่อ ของ ลูก ค้า. อย่า นํา เรื่อง นั้น มา พูด คุย หรือ ใช้ เครื่อง มือ โต้ เถียง กัน. ส่วนนี้ครอบคลุม API- การเชื่อมต่อคีย์; ครอบคลุมการเข้าใช้ตัวแทน OAuth การล็อกอินและการทดสอบ Codex ถึง OpenClaw การปรับแต่ง youtube_download รองรับการดาวน์โหลดสื่อแบบไม่ต่อเนื่องตามรูปแบบ API- ขออนุญาตนะ

จัดการ API กุญแจ

สืบค้นเครื่องมือ

ลูกความของคุณค้นพบเครื่องมือที่ได้รับจากกุญแจ ทั้ง 6 คน Google และ 8 YouTube เครื่องมือข้อมูลปริยายไปยังเวลาจริงและยังยอมรับ mode: async. submit_batch สนับสนุนทั้งสองกลุ่ม youtube_download ใช้การดาวน์โหลดอย่างเป็นทางการ APIต้องการห้องเก็บของลูกค้า และรองรับงาน Async หรือ 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ตะกร้า ของ ปรสิต. ชื่อเครื่องมือสอบถามเลือกแหล่งของมัน เฉพาะรายการใน submit_batch ต้องการแหล่งข่าว API กุญแจและ callback_url ไม่ใช่ข้อโต้แย้งของเครื่องมือ เดอะ JSON ตัวอย่างด้านล่างนี้ เป็นวัตถุเหตุผลสําหรับ client.callTool(ชื่อ).

ใช้ JSON บูเลียนและจํานวนเต็ม ไม่ใช่สตริง ช่องข้อมูลที่ไม่รู้จักถูกปฏิเสธ เดอะ 14 Comment=เครื่องมือสอบถามข้อมูลName 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_formatmp4 (ค่าปริยาย)/webm/mkv สําหรับวิดีโอ, m4a (ค่าปริยาย)/mp3/opus สําหรับเสียง audio_language: default/original; audio_quality: best/320/256/192/128เสียงเท่านั้น yt_dlp_formatถึง 1024 อักขระ, แทนที่คุณภาพ, fps และภาษา Omit video_quality/fps สําหรับเสียงและ audio_language สําหรับวิดีโอเท่านั้น ต้องการจัดเก็บและดาวน์โหลดที่เข้าคู่กับแฟ้ม API params.storage. start_at/end_atเอส, ขึ้นถึง 12 ชั่วโมง end_at ต้องตาม start_at. upload_metadataภูฏาน ค่าปริยาย false. ทุกชุดดาวน์โหลดต้องการที่เก็บ ไม่ 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 และ Tors access_key/secret_key กับการทํางาน region/endpoint_url. GCS ใช้ service_account (project_id, client_email, private_key); Azure ใช้ account_name และตู้คอนเทนเนอร์ sas_token ขออนุญาตเขียน จุดปลายต้องเข้าถึงได้จากคนงาน อ่าน ใบรับรอง จาก การปรับแต่ง ของ คุณ; อย่า วาง ข้อมูล เหล่า นั้น ลง ใน การ สนทนา หรือ สะท้อน ความ คิด เห็น.
google_*queryสืบค้น: 1–2,000 อักขระ. gI: 2 อักษร ประเทศ; hl: 1–35 รหัสภาษาตัวละคร location/tbs: 1–200 อักขระ; num/pageจํานวนเต็ม 1–100อัตโนมัติ: บูเลอัน เลือก วิธี ที่ ถูก ต้อง โดย ใช้ พฤติกรรม ของ ผู้ ให้ สืบค้น โดย ไม่ มี ประเทศ ที่ มั่นคง, ภาษา, หรือ ผล ที่ ได้ รับ ประกัน.
youtube_searchqueryสืบค้น: 1–2,000 ตัวละคร max_results: 1–20ค่าปริยาย 202; กรอง: วัตถุการกรอง, ตัดทิ้ง หรือ null เพื่อไม่ให้กรอง
youtube_search_extendedqueryสืบค้น: 1–2,000 ตัวละคร max_results: 1–700ค่าปริยาย 20สืบค้นเมื่อ:
youtube_metadatavideo_idinclude_formats ถึง include_chaptersไอคอนแสดงปริยาย true.
youtube_transcriptvideo_idภาษาโอไมท์ชอบแบบเอนออริคมากกว่า จากนั้นก็กลับมาเป็นเพลงเดิม ด้วยอัตโนมัติ=trueโค้ดแต่ละตัวชอบติดตาม - ออร์แกน จากนั้นรหัสธรรมดา; โดยตรง - ออริก และออโต้=false อยู่เฉยๆนะ อาเรย์พยายามทั้งหมด 1–10 ต้องการภาษาและส่งแทร็กเสียงและข้อผิดพลาดกลับเป็นลําดับ ค่าปริยายไปยัง true สําหรับคําบรรยายอัตโนมัติ
youtube_captionsvideo_idภาษาโอไมท์ชอบแบบเอนออริคมากกว่า จากนั้นก็กลับมาเป็นเพลงเดิม ด้วยอัตโนมัติ=trueโค้ดแต่ละตัวชอบติดตาม - ออร์แกน จากนั้นรหัสธรรมดา; โดยตรง - ออริก และออโต้=false อยู่เฉยๆนะ อาเรย์พยายามทั้งหมด 1–10 ต้องการภาษาและส่งแทร็กเสียงและข้อผิดพลาดกลับเป็นลําดับ ค่าปริยายไปยัง false สําหรับคําบรรยายของผู้อัปโหลด
youtube_trainabilityvideo_idไม่มีอาร์กิวเมนต์เลือกนอกจากโหมด รายงาน เรื่อง การ จัด ประเภท ลิขสิทธิ์ เพื่อ การ ก่อ สร้าง; ไม่ อนุญาต ให้ ฝึก อบรม.
youtube_channelhandleด้ามจับ: 1–100 อักขระ; video_limit: 1–100ค่าปริยาย 20.
youtube_suggestionsqueryสืบค้น: 1–2,000 อักขระ; ภาษา: ค่าปริยาย en; ขอบเขต: โค้ดประเทศสองตัว, ค่าปริยายของสหรัฐอเมริกา

video_id คือ 11- ช่างทําเล็บ YouTube ID ใช้ตัวอักษร, ตัวเลข, เน้นหรือไฮเฟน; จัดหา ID แทนที่จะเป็นวีดีโอ URL. รหัสภาษาแต่ละภาษาคือ 1–35 ตัวอักษรที่ใช้อักษร ตัวเลข หรือไฮเฟน สําหรับคําบรรยายภาพ, อัตโนมัติ=true เลือกคําบรรยายภาพอัตโนมัติ false เลือกคําบรรยายภาพที่อัปโหลดมา โดยไม่มีการผิดพลาดโดยอัตโนมัติ สําหรับอาร์เรย์ภาษา ให้ตรวจสอบข้อผิดพลาด แม้เมื่องานสําเร็จ

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 ต้องการคุณสมบัติที่: 3603d, 4k, creative_commonsHd, 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 รับแหล่งทางเลือก; ไม่สนใจมันสําหรับทุกคน MCP แหล่งที่มาการค้นหาที่ได้รับอนุญาตโดยคีย์ของคุณ request_count เป็นจํานวนเต็มจาก 1 ถึง 100000ค่าปริยาย 1□ แต่ละหน้าหรือแต่ละชุดนับเป็นการร้องขอแยก get_usage รับแหล่งทางเลือก; ไม่สนใจมันสําหรับแหล่งที่มาที่ได้รับอนุญาตทั้งหมด มันรวมถึงการใช้ youtube_download จํานวนครั้งที่ดาวน์โหลด creditsPerTb (1 ทีบี = 10^12 Ittes; การดาวน์โหลดชื่อที่เก็บและชําระโดยการอัปโหลดจริง. request_count ไม่สามารถใช้กับการดาวน์โหลดและ estimatedCredits คือ null.

get_usage from/to ต้องเป็นยูทีซี ISO time tamps เช่น 2026-09-21.00 น.002 ทุ่ม แล้วแต่ 1–3 ตัวเลขที่สอง เศษส่วน จากไม่รวม, เป็นตัวเลขเฉพาะ, ถูกปัดเหลือนาที หน้าต่างปริยายคือ 7 วัน และค่าสูงสุดคือ 31 วัน. โดย เฉพาะ จาก นั้น เจ็ด วัน ต่อ มา ก็ จะ เป็น อีก เจ็ด วัน เท่า นั้น. อ่าน การ ตอบ รับ ของ 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 จะคืนค่ากลับมาเป็นงานพิมพ์; ส่งต่อเป็น 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 และชดเชยด้วยค่าจากการตอบสนองของคุณ อ่านชิ้นต่อไปโดยไม่เปลี่ยนคําค้น

get_job อาร์กิวเมนต์ [_] JSON
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}

การตอบสนองขนาดใหญ่รวมถึง JSON ชิ้นส่วนข้อความ result_id ถึง next_offset. เรียก get_result ด้วยกุญแจดอกเดิมและของที่ส่งกลับมา result_id. ออฟเซต เป็นจํานวนเต็มที่ไม่เป็นลบ, ค่าปริยาย 02; ใช้ ส่วน ที่ อยู่ ก่อน หน้า นี้ next_offset ดําเนินการต่อไป ลิมิตเป็นจํานวนเต็มจาก 1 ถึง 16000ค่าปริยาย 16000วัดจาก UTF16 รหัสหน่วยไม่ใช่ ไบต์ หรือแถวที่ผลออกมา เรียง ตาม ลําดับ ก่อน หด ตัว JSON; next_offset=null ทําเครื่องหมายตอนจบ ผลต่าง ๆ จะถูกจัดเก็บไว้ในแคช 10 นาทีที่มีผลมากที่สุดสี่ใหญ่ต่อคีย์และอาจขับไล่ได้เร็วขึ้น การ อ่าน ชิ้น ส่วน ไม่ ได้ ทํา ซ้ํา การ สอบ ถาม หรือ ค่า ใช้ จ่าย ที่ ได้ มา.

get_result อาร์กิวเมนต์ [_] JSON
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}

Billing และข้อผิดพลาด

จง ใช้ ทรัพย์ สิน ที่ คุณ มี อยู่ ใน แผน งาน ของ คุณ โดย ไม่ เพิ่ม อะไร เข้า ไป MCP ค่าใช้จ่าย. ตั้งค่าข้อผิดพลาดของเครื่องมือ isError และเป็นน้ําที่ไหลรินตลอดเวลา HTTP สถานะและการร้องขอ ID. เรียกคืนค่าเครดิตสําหรับปรับดุลภาพที่ไม่เพียงพอ และตรวจสอบสิทธิ์การใช้กุญแจเพื่อเข้าใช้งานข้อผิดพลาด

การเชื่อมต่อที่หมดเวลาหรือสูญหาย ไม่ได้หมายความว่าการสอบถามจะไม่ถูกประมวลผล สําหรับ query_outcome_unknownเช็คคําขอ History ใน คอนโซล ก่อน ตัดสิน ใจ จะ ยอม รับ อีก ครั้ง. อย่าพยายามส่งข้อมูลคืนโดยอัตโนมัติ การอ่านงานหรือชิ้นงานที่มีอยู่นั้น สามารถทําการย้อนรอยได้ การตอบสนองของแม่น้ํามีข้อจํากัด 4 MiB, ขนาดการค้นหาจํากัด; การตอบรับที่มากเกินไปอาจจะได้รับการคิดค่าแล้ว

อยู่ใต้กรอบ HTTP รหัสสถานะ · กฎของการลองใหม่

ตรวจสอบด้วย JavaScript ลูกข่าย

ลูกความคนนี้ใช้เจ้าหน้าที่ตรวจสอบ SDK 1.30.0 เชื่อมต่อผ่านสื่อได้ 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();
}