# Alat dan skema MCP

Lihat FlashData MCP argumen alat, default, akun baca, status pekerjaan dan hasil penerimaan.

Referensi boonical: https://flashdata.dev/ms/docs/mcp

[Pilihlah klien MCP anda dan sambungkan](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)

[OAuth, Codex, OpenClaw dan APIQ-key access](https://flashdata.dev/ms/docs/guides/agent-access/reference.md)

<a id="connect"></a>

## Angkutan dan autentikasi

Saat ini titik akhir MCP menggunakan HTTP yang dapat ditampung. Sambungan kunci API-key kirim X-API-Key; akses alat mengikuti izin sumber kunci dan kredit yang tersedia.

### Streamable HTTP

```text
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>
```

Simpan kunci FlashData API yang sebenarnya dalam konfigurasi kredensial klien. Jangan masukkan ke dalam percakapan atau argumen alat. Bagian ini meliputi koneksi API-key; panduan akses agen meliputi login OAuth dan login Codex yang diuji dan konfigurasi OpenClaw. youtube_download mendukung unduhan media asinkron dengan izin API-key yang sesuai.

<a id="tools"></a>

## Alat pertanyaan

Klienmu menemukan alat yang diberikan oleh kunci. Kesemua enam Google dan delapan YouTube alat data baku ke realtime dan juga menerima mode: async. submit_batch mendukung kedua grup. youtube_download menggunakan unduhan formal API, membutuhkan penyimpanan pelanggan, dan mendukung pekerjaan sinkron atau submit_batch. Model dapat memilih dan menggabungkan alat-alat untuk tugas.

google_search · google_images · google_news · google_shopping · google_videos · google_places

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

<a id="parameters"></a>

## Argumen Alat-alat tool

Letak lema pertanyaan seperti query, num, bahasa dan mode secara langsung dalam objek argumen alat, tanpa pembengkokan param EST API. Nama sebuah questery tool memilih sumbernya; hanya entri dalam submit_batch yang membutuhkan sumber. Kunci API dan callback_url bukanlah argumen alat. Contoh JSON di bawah ini adalah objek argumen untuk client.callTool({ name, argumen }).

Use JSON boolean dan bilangan integer, bukan string. Medan yang tidak diketahui ditolak. Kata tanya data 14 menerima mode: realtime atau async, default ke realtime. Masukan Batch tidak menerima mode.

| Alat Fon | Wajib | Argumen opsional & standar |
| --- | --- | --- |
| youtube_download | video_id, storage | mode hanya menyokong async (lalai). download_type: audio_video (lalai)/video/audio. video_quality: <=720 secara lalai; best/worst atau <=, ==, >= dengan 144/360/480/720/1080/1440/2160/4320. fps: perbandingan yang sama dengan 1–240. output_format: mp4 (lalai)/webm/mkv untuk video, m4a (lalai)/mp3/opus untuk audio. audio_language: default/original; audio_quality: best/320/256/192/128, untuk audio sahaja. yt_dlp_format: sehingga 1024 aksara, mengatasi pilihan kualiti, fps dan bahasa. Jangan sertakan video_quality/fps untuk audio atau audio_language untuk video sahaja. storage diperlukan dan sepadan dengan params.storage dalam Download API. start_at/end_at: HH:MM:SS, sehingga 12 jam; end_at mesti selepas start_at. upload_metadata: boolean, false secara lalai. Setiap muat turun batch memerlukan storage. browser_delivery dan callback_url tidak disokong. |
| storage | storage_type, storage_url | storage_url adalah nama ember Anda (Azure: container), bukan direktori lokal. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; opsional object_prefix. S3, S3-compatible, OSS, COS, BOS dan TOS gunakan access_key/secret_key dengan region/endpoint_url. yang dapat diaplikasikan GCS menggunakan service_account (project_id, client_email, private_key); Azure organ account_name Dan sebuah wadah. sas_token Dari izin menulis. Titik akhir harus dapat dicapai dari Pekerja. Baca kelayakan dari konfigurasi penyimpanan anda; jangan paskan ke dalam chatting atau gema mereka. |
| google_* | query | query: 1–2,000 aksara. gl: kod negara dua huruf; hl: kod bahasa sepanjang 1–35 aksara; location/tbs: 1–200 aksara; num/page: integer 1–100; autocorrect: boolean. Pilihan yang tidak dinyatakan mengikut tingkah laku penyedia carian, tanpa jaminan negara, bahasa atau bilangan hasil tertentu. |
| youtube_search | query | Pertanyaan lema: 1–2,000 aksara ν. max_results: 1–20, default 20); filter: objek filter, diabaikan atau null Tak ada filter. |
| youtube_search_extended | query | Pertanyaan lema: 1–2,000 aksara ν. max_results: 1–700, default 20; penapis: sama dengan pencarian standar. |
| youtube_metadata | video_id | include_formats dan include_chapters: boolean, keduanya standar true. |
| youtube_transcript | video_id | Bahasa Omit untuk lebih memilih en-orig, kemudian en, kembali satu trek. Dengan auto=true, setiap kode lebih menyukai trek -orignya, maka kode biasa; eksplisit -orig dan auto=false tetap tepat. Other Arrays mencoba semua bahasa 1–10 yang diminta dan mengembalikan trek dan kesalahan secara berurutan. default otomatis ke true untuk kapsi otomatis. |
| youtube_captions | video_id | Bahasa Omit untuk lebih memilih en-orig, kemudian en, kembali satu trek. Dengan auto=true, setiap kode lebih menyukai trek -orignya, maka kode biasa; eksplisit -orig dan auto=false tetap tepat. Other Arrays mencoba semua bahasa 1–10 yang diminta dan mengembalikan trek dan kesalahan secara berurutan. Oto default ke false untuk uploader-provided kaptions. |
| youtube_trainability | video_id | Tidak ada argumen opsional kecuali mode. Vóguesco Reports Creative Commons klasifikasi lisensi; tidak memberikan izin pelatihan. |
| youtube_channel | handle | handle: 1–100 karakter; video_limit: 1–100, standar 20. |
| youtube_suggestions | query | Pertanyaan lema: 1–2,000 Aksara jarka; bahasa: en default; wilayah: kode negara dua huruf, standar US. |

video_id Dan dia adalah... 11-character YouTube ID Wheks menggunakan huruf, angka, garis bawah atau tanda hubung; memasok ID Lebih daripada videonya URL. Tiap kode bahasa adalah 1–35 dengan menggunakan huruf, angka atau tanda hubung. Untuk subtitle, auto=true memilih kapsi otomatis dan false memilih uploader-provided kaptions, dengan tidak ada fallback otomatis di antara mereka. Untuk tata bahasa, periksa kesalahan bahkan ketika pekerjaan berhasil.

### Filter pencarian YouTube

filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_yeardurasi: <4, 4-20 OR atau ORANG >20; sort_by: rating/relevance/view_count/upload_date. Bendera fitur feature adalah boolean; true membutuhkan fitur tersebut: 360, 3d, 4k, creative_commons, hd, hdr, live, lokasi, dibeli, subtitles, vr180.

<a id="account"></a>

## Pemahaman akun palsu (bebas)

get_balance membaca baki akaun bersama; get_pricing menganggarkan kos pertanyaan; get_limits membaca had pelan dan kerja yang sedang menunggu; get_usage merumuskan 7 hari terakhir secara lalai, dengan julat maksimum 31 hari. Penggunaan merangkumi semua kunci akaun bagi sumber yang dibenarkan oleh kunci pemanggil dan mungkin lewat dikemas kini.

get_balance Dan get_limits Diambil {}. get_pricing Mekan menerima sumber pilihan; abaikan itu untuk semua MCP Sumber pertanyaan yang disahkan oleh kuncimu. request_count Taksi adalah integer dari 1 Ke 100000, default 1LUV; setiap halaman atau butir ketupat dihitung sebagai permintaan terpisah. get_usage Keabsahan menerima sumber opsional; abaikan itu untuk semua sumber yang berwenang. Ini termasuk penggunaan youtube_download. Kembalian prioritas unduhan unduhan creditsPerTb (1 TB TB = 10^12 download Credits cadangan dan diselesaikan oleh bytes unggahan yang sebenarnya. request_count FOG tidak berlaku untuk memuat-turun dan estimatedCredits Ini adalah... null.

get_usage from/to Haruslah nama waktu ISO ISO UTC seperti 2026-09-21T00:00:00Z, secara pilihan dengan 1–3 Fraksional digit kedua. dari inklusif, ke ekslusif, dibulatkan ke menit. Jendela defaultnya adalah 7 hari dan maksimumnya adalah 31 hari. Hanya tujuh hari kemudian, hanya tujuh hari kemudian, dari tujuh hari sebelumnya. Bacalah from/to balasan untuk jendela yang efektif.

<a id="jobs"></a>

## Pekerjaan dan hasil yang besar

Permintaan async pemberian sinkron mengembalikan id kerja; lulus sebagai job_id ke get_job untuk membaca job.status. Tugas yang sudah selesai termasuk jawaban pertanyaan asli dalam keluaran. Untuk unduhan, output adalah manifes unggah: output.results[0].file_url menunjuk ke penyimpanan pelanggan, dengan file_size, downloaded_bytes dan md5. Berkas-berkas pribadi milik mereka membutuhkan otentikasi penyimpananmu. Hasil JSON tetap dipertahankan untuk jam 24; retensi media dan akses mengikuti kebijakan penyimpanan Anda. submit_batch menerima setidaknya satu Google atau YouTube query (termasuk unduhan), dengan argumen sumber dan datar pada setiap masukan. Setiap entri ditagih secara terpisah, dan rencana Anda berlaku secara bertahap dan terbatas. Pembacaan pekerjaan tidak dikenakan biaya lagi. berbasis Berkas ZOF Bulk Tidak ada. MCP Alat bantu.

Megantikan contoh job_id, result_id dan ofset dengan nilai dari respon anda. Baca potongan berikutnya tanpa mengirimkan ulang pertanyaan.

Tanggapan besar yang besar meliputi sebuah potongan teks JSON, result_id dan next_offset. Panggilan get_result Dan dengan kunci yang sama dan kembali result_id. ofset adalah integer tidak negatif, baku 0); gunakan yang sebelumnya next_offset Untuk melanjutkan. batas adalah integer dari 1 Ke 16000, default 16000, diukur dalam UTF-16 kode unit dari pada byte atau baris hasil. Konkatenasi potongan dalam urutan sebelum menghurai JSON; next_offset=null menandai akhir. Hasil hasil yang dicache untuk menit 10, dengan paling banyak empat hasil besar per kunci, dan mungkin diusir lebih cepat. Potongan-potongan bacaan tidak mengulangi kueri atau biaya kredit.

[Memproses file ID? Gunalah Bulk HTTP API](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md)

<a id="billing"></a>

## Billing dan error

Kekhawatiran menggunakan harga kredit rencana Anda yang sudah ada tanpa biaya tambahan MCP. Kesalahan alat tool tool set isErrorQ dan mempertahankan status HTTP hulu dan permintaan ID. Penghargaan Pulih Kerugian untuk keseimbangan yang tidak mencukupi dan memeriksa izin kunci untuk kesalahan akses.

KELUAR atau sambungan hilang tidak berarti pertanyaan tidak dilakukan. Untuk query_outcome_unknown, periksa Request History di konsol sebelum memutuskan untuk mengajukan lagi. Jangan secara otomatis mencoba kembali penyerahan yang telah dibayar; membaca pekerjaan atau potongan yang sudah ada dapat dicoba kembali. Respons upstream di atas terbatas pada 4Q MiB, sehingga batas ukuran pencarian; respon oversize mungkin sudah dibebankan.

[Kode status HTTP tersembunyi](https://flashdata.dev/ms/docs/errors/reference.md#status-codes) · [Peraturan percobaan kembali](https://flashdata.dev/ms/docs/errors/reference.md#retries)

### youtube_download · arguments JSON

```json
{
  "video_id": "FUfGcZ092b0",
  "download_type": "audio_video",
  "video_quality": "<=360",
  "output_format": "mp4",
  "storage": {
    "storage_type": "s3",
    "storage_url": "your-video-bucket",
    "object_prefix": "mcp-downloads",
    "access_key": "YOUR_STORAGE_ACCESS_KEY",
    "secret_key": "YOUR_STORAGE_SECRET_KEY",
    "region": "us-east-1"
  }
}
```

### google_search · arguments JSON

```json
{
  "query": "MCP protocol",
  "num": 3,
  "gl": "us",
  "hl": "en",
  "mode": "async"
}
```

### youtube_search · arguments JSON

```json
{
  "query": "renewable energy",
  "max_results": 5,
  "filters": {
    "type": "video",
    "duration": "<4",
    "subtitles": true
  }
}
```

### youtube_transcript · arguments JSON

```json
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
```

### submit_batch · arguments JSON

```json
{
  "queries": [
    {
      "source": "google_search",
      "query": "renewable energy",
      "num": 3
    },
    {
      "source": "youtube_metadata",
      "video_id": "FUfGcZ092b0",
      "include_formats": false
    }
  ]
}
```

### get_job · arguments JSON

```json
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}
```

### get_result · arguments JSON

```json
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}
```

### get_pricing · arguments JSON

```json
{
  "source": "google_search",
  "request_count": 3
}
```

### get_usage · arguments JSON

```json
{
  "source": "youtube_metadata",
  "from": "2026-09-21T00:00:00Z",
  "to": "2026-09-22T00:00:00Z"
}
```

<a id="client-example"></a>

## Sahkan dengan klien JavaScript

Klien ini menggunakan pejabat yang diverifikasi SDK 1.30.0 Phone untuk terhubung melalui Streamable HTTP dan daftar alat tanpa menjalankan pertanyaan yang terbayar. Simpan sebagai mcp-check.mjs, set FLASHDATA_API_KEY di lingkungan Anda, kemudian jalankan node mcp-check.mjs.

### npm

```bash
npm install @modelcontextprotocol/sdk@1.30.0
```

### mcp-check.mjs

```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: '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();
}
```
