Duyệt tài liệu
Tham chiếu API
Công cụ và lược đồ MCP
Nhìn lên FlashData MCP tham số công cụ, mặc định, tài khoản đọc, trạng thái công việc và kết quả thu hồi.
Trên trang này
OAuth, Codex, OpenClaw và API- Tùy chọn truy cập phím
Chọn đi MCP trạm khách và kết nối
Vận chuyển và xác thực
Máy chủ MCP điểm kết thúc sử dụng luồng được HTTP. API- Kết nối phím X-API-Key; công cụ truy cập theo các quyền truy cập mã nguồn khóa và tín dụng sẵn có.
URL: https://data.flashdata.dev/mcp
X-API-Key: API Chìa khóa>Lưu khóa API FlashData thật trong cấu hình thông tin xác thực của trình khách. Không đưa khóa vào cuộc trò chuyện hoặc tham số công cụ. Phần này hướng dẫn kết nối bằng khóa API; hướng dẫn truy cập cho tác nhân trình bày đăng nhập OAuth và cấu hình Codex, OpenClaw đã kiểm thử. youtube_download hỗ trợ tải nội dung đa phương tiện bất đồng bộ với quyền API-key phù hợp.
Quản lý API phímTruy vấn công cụ
Khách hàng của anh phát hiện ra các công cụ được chấp thuận bởi chìa khóa. Cả sáu Google và tám YouTube dữ liệu công cụ mặc định đến thời gian thực và cũng chấp nhận mode: async. submit_batch Hỗ trợ cả hai nhóm. youtube_download sử dụng việc tải chính thức API, yêu cầu lưu trữ khách hàng, và hỗ trợ một công việc định kỳ hoặc submit_batch. Mô hình có thể chọn và kết hợp các công cụ cho nhiệm vụ này.
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
{
"query": "MCP protocol",
"num": 3,
"gl": "us",
"hl": "en",
"mode": "async"
}Đối số công cụ
Đặt các trường truy vấn như truy vấn, num, ngôn ngữ và chế độ trực tiếp vào đối tượng lý luận của công cụ, mà không có RTT APINhững tình nhân của họ bị gói gọn. Tên của công cụ truy vấn chọn nguồn gốc; chỉ mục nhập vào submit_batch Cần nguồn. API phím và callback_url không phải là đối số công cụ. Hạt JSON Ví dụ dưới đây là đối tượng đối tượng đối số cho client.callTool({ tên, tham số ].
Dùng JSON Những số nguyên và lặt vặt, chứ không phải chuỗi. Các trường không rõ bị từ chối. Hạt 14 Công cụ truy vấn dữ liệu chấp nhận mode: realtime hoặc là một định kỳ, mặc định cho thời gian thực. Mục nhập Batch không chấp nhận chế độ.
| Công cụ | Bắt buộc | Các đối số và mặc định tùy chọn |
|---|---|---|
youtube_download | video_id, storage | Chế độ hỗ trợ chỉ định (mặc định). download_type: audio_video (mặc định)/video/audio. video_quality: <=720 mặc định: best/worst hay <=, ==, >= có 144/360/480/720/1080/1440/2160/4320. fps: sự so sánh tương tự với 1–240. output_format:mp4 (mặc định)/webm/mkv cho video, m4a (mặc định)/mp3/opus cho âm thanh. audio_language: default/original; audio_quality: best/320/256/192/128Chỉ có âm thanh. yt_dlp_format: đến 1024 ký tự, chất lượng ghi đè, fps và ngôn ngữ được chọn. Omit video_quality/fps cho âm thanh và âm thanh audio_language chỉ cho phim ảnh. kho cần thiết và khớp API params.storage. start_at/end_at: HH:MM:SS, đến 12 giờ; end_at Phải theo start_at. upload_metadata: boolean, default false. Mỗi lần tải xuống cần phải có kho. Không browser_delivery hay callback_url. |
storage | storage_type, storage_url | storage_url là tên xô của bạn (Azure: container), không phải thư mục cục bộ. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; tùy chọn object_prefix. S3, S3- Tương tự, OSS, COS, BOS và TOS sử dụng access_key/secret_key với ứng dụng region/endpoint_url. GCS sử dụng service_account (project_id, client_email, private_key); Azure sử dụng account_name và một thùng sas_token với sự cho phép viết. Điểm cuối phải được tiếp cận từ Thợ. Hãy đọc thông tin từ cấu hình lưu trữ của bạn; đừng dán chúng vào máy trò chuyện hoặc lặp lại. |
google_* | query | Yêu cầu: 1–2,000 ký tự. gl: quốc gia hai chữ cái; hl: 1–35 ký tự ngôn ngữ; location/tbs: 1–200 ký tự; num/page: số nguyên 1–100; Tự động chính xác: booquile. Những tùy chọn có giá trị sử dụng hành vi của người cung cấp tìm kiếm, không có quốc gia cố định, ngôn ngữ hoặc kết quả chắc chắn. |
youtube_search | query | Yêu cầu: 1–2,000 các nhân vật. max_results: 1–20mặc định 20; bộ lọc: đối tượng lọc, bỏ qua hoặc null không có bộ lọc. |
youtube_search_extended | query | Yêu cầu: 1–2,000 các nhân vật. max_results: 1–700mặc định 20; bộ lọc: cũng giống như tìm kiếm chuẩn. |
youtube_metadata | video_id | include_formats và include_chapters: booleans, cả hai mặc định true. |
youtube_transcript | video_id | Ngôn ngữ Omit thích en-orig, sau đó en, trở lại một theo dõi. Với tự động =true., mỗi mã thích theo dõi -ig của nó, sau đó các mã đơn giản; rõ ràng -orig và tự động =false Giữ nguyên vị trí. Arrays thử tất cả 1–10 yêu cầu ngôn ngữ và các đường dẫn và lỗi trở lại. true cho các phụ đề tự động. |
youtube_captions | video_id | Ngôn ngữ Omit thích en-orig, sau đó en, trở lại một theo dõi. Với tự động =true., mỗi mã thích theo dõi -ig của nó, sau đó các mã đơn giản; rõ ràng -orig và tự động =false Giữ nguyên vị trí. Arrays thử tất cả 1–10 yêu cầu ngôn ngữ và các đường dẫn và lỗi trở lại. false để tải lên chú thích. |
youtube_trainability | video_id | Không có đối số tùy chọn ngoại trừ chế độ. Báo cáo phân loại bằng cấp sáng tạo; nó không cho phép huấn luyện. |
youtube_channel | handle | Tay lái: 1–100 ký tự; video_limit: 1–100mặc định 20. |
youtube_suggestions | query | Yêu cầu: 1–2,000 ký tự; ngôn ngữ: mặc định en; vùng: mã quốc gia hai chữ cái, mặc định là U.S. |
video_id là một 11- Hồ sơ. YouTube ID sử dụng chữ cái, con số, gạch nối hay dấu gạch nối; cung cấp ID Thay vì là đoạn phim URL. Mỗi ngôn ngữ được mã hóa 1–35 ký tự sử dụng chữ cái, số hoặc dấu gạch nối. Cho phụ đề, tự động =true chọn đầu đề tự động và false chọn những phụ đề tải lên, không có hậu phương tự động giữa chúng. Đối với danh sách ngôn ngữ, kiểm tra lỗi ngay cả khi công việc thành công.
YouTube Bộ lọc tìm kiếm
filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; khoảng cách: <4, 4-20 hay >20; sort_by: rating/relevance/view_count/upload_date. Lá cờ đặc trưng là những điều làm ô uế; true đòi hỏi tính năng này: 3603d, 4k, creative_commonsHd, Hdr, trực tiếp, vị trí, mua, phụ đề, vr180.
{
"query": "renewable energy",
"max_results": 5,
"filters": {
"type": "video",
"duration": "<4",
"subtitles": true
}
}Thông hiểu tài khoản (tự do)
get_balance đọc tài khoản chia sẻ của bạn; get_pricing đánh giá chi phí truy vấn; get_limits đọc giới hạn kế hoạch và công việc đang chờ; get_usage Tóm tắt cuối cùng 7 ngày theo mặc định, với tối đa 31- Thời gian qua ngày. Sử dụng tất cả các khóa tài khoản cho phép dùng chìa khóa điện thoại và có thể bị trì hoãn.
get_balance và get_limits Lấy {}. get_pricing Chấp nhận một nguồn tùy chọn; bỏ qua nó cho tất cả MCP Truy vấn được ủy quyền bằng chìa khóa của bạn. request_count là một số nguyên từ 1 phải 100000mặc định 1; mỗi trang hoặc hàng loạt mục tính là yêu cầu riêng. get_usage Chấp nhận một nguồn tùy chọn; bỏ qua nó cho tất cả các nguồn có thẩm quyền. Bao gồm cả youtube_download sử dụng. Tải về creditsPerTb (1 lao = 10^12 byte); tải về các tờ tín dụng lưu trữ và định cư bằng byte thật sự tải lên. request_count không áp dụng cho việc tải về và estimatedCredits là null.
get_usage from/to Phải là nhãn giờ ISO UTC như 2026-09- 21T00:00:00Z, tùy chọn với 1–3 Các chữ số thứ hai phân số. Từ chữ số riêng biệt, đến độc quyền, được làm tròn đến phút. Cửa sổ mặc định là 7 ngày và tối đa là 31 ngày. Chỉ từ, bảy ngày sau, với chỉ đến, từ bảy ngày trước đó. Hãy đọc câu trả lời from/to cho cửa sổ hiệu quả.
{
"source": "google_search",
"request_count": 3
}{
"source": "youtube_metadata",
"from": "2026-09-21T00:00:00Z",
"to": "2026-09-22T00:00:00Z"
}Công việc và kết quả lớn
Một yêu cầu đặc biệt trả lại một ID công việc; vượt qua nó như job_id phải get_job để đọc job.status. Công việc hoàn thành bao gồm câu trả lời yêu cầu gốc trong kết xuất. Để tải về, kết xuất là danh sách tải lên: output.results[0].file_url chỉ tới kho của khách hàng, với file_size, downloaded_bytes và Md5. Tập tin cá nhân cần sự xác thực về kho lưu trữ. JSON Kết quả được giữ lại 24 Hàng giờ; lưu trữ và truy cập phương tiện truyền thông theo chính sách lưu trữ của bạn. submit_batch Chấp nhận ít nhất một. Google hay YouTube truy vấn (bao gồm việc tải về), với các đối số gốc và căn cứ trên mỗi mục. Mỗi mục đều được tính riêng biệt, và kế hoạch của bạn được áp dụng trong trường hợp có giới hạn. Việc đọc không tính tiền nữa. Dựa vào tập tin Bulk không phải là MCP đồ nghề.
Đang xử lý một tập tin ID? Sử dụng Bulk HTTP API
{
"video_id": "FUfGcZ092b0",
"language": "en",
"auto": true,
"mode": "async"
}{
"queries": [
{
"source": "google_search",
"query": "renewable energy",
"num": 3
},
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"include_formats": false
}
]
}Thay thế mẫu job_id, result_id và bù đắp với các giá trị từ phản ứng của bạn. Đọc phần tiếp theo mà không cần phục hồi lại yêu cầu.
{
"job_id": "job_REPLACE_WITH_RETURNED_ID"
}Đáp ứng lớn bao gồm một JSON Phần văn bản, result_id và next_offset. nhỏ get_result Với cùng một chiếc chìa khóa và trở về result_id. bù đắp là một số nguyên không âm tính, mặc định 0; sử dụng các trước next_offset để tiếp tục. Giới hạn là một số nguyên từ 1 phải 16000mặc định 16000được đo bằng UTF-16 Các đơn vị mã chứ không phải byte hoặc kết quả hàng. Phân loại đoạn trước khi phân tách JSON; next_offset=null Đánh dấu kết thúc. Kết quả được lưu tạm cho 10 chỉ trong vòng bốn phút, mỗi chiếc chìa khóa đạt được nhiều thành quả lớn nhất, và có thể bị đuổi khỏi nhà sớm hơn. Đọc các đoạn không lặp lại các yêu cầu hoặc tính tiền.
{
"result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
"offset": 16000,
"limit": 16000
}Billing lỗi
Hàng loạt các cuộc thăm dò dùng tiền tín dụng của bạn mà không cần thêm MCP sạc. Lỗi công cụ isError Và giữ dòng chảy ngược HTTP Name ID. Phục hồi danh sách để giữ thăng bằng không đủ và kiểm tra quyền truy cập của các khóa.
Thời hạn hoặc mất kết nối không có nghĩa là yêu cầu đã không được thực hiện. Vì query_outcome_unknownKiểm tra yêu cầu History trên bàn điều khiển trước khi quyết định phục tùng lần nữa. Không tự động thử lại việc nộp tiền; đọc các công việc hoặc mảng đã có có có thể được lấy lại. Đáp ứng ngược dòng chỉ giới hạn 4 MiB, vì vậy giới hạn kích thước tìm kiếm; câu trả lời có thể đã được sạc.
Kiểm tra bằng một JavaScript ứng dụng khách
Khách hàng này sử dụng chính thức xác SDK 1.30.0 để kết nối trên luồng được HTTP và liệt kê các công cụ mà không cần chạy truy vấn trả tiền. Hãy giữ lấy nó. mcp-check.mjs, đã đặt FLASHDATA_API_KEY trong môi trường của bạn, sau đó chạy nút mcp-check.mjs.
npm install @modelcontextprotocol/[email protected]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();
}