ドキュメントを探す
はじめに
Google Search と YouTube ツールをエージェントに提供します。 ホストを接続し、最初の結果を尋ねます。
このページの内容
1. 接続と署名
Codex または OpenClaw をブラウザベース OAuth で選択します。 別のホストのために、リモート/ API ストリーム可能をサポートするキー HTTP とカスタムヘッダ、またはローカル/ stdio を起動すると MCP プロセス。 ホストされているサーバーはローカルインストールを必要としません。
下記の設定を ~/.codex/config.toml にマージし、ログインコマンドを実行します。 FlashData のサインアップまたはサインインおよび同意をブラウザで完了します。 ログイン後に新しいCodexセッションを開始します。
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"
[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"codex mcp login flashdata --scopes mcp:researchエージェントが使用する OpenClaw プロファイルでこれらのコマンドを実行します。 ブラウザでサインアップまたはサインインおよび同意を完了し、その後、新鮮なセッションを開始します。 ドクタープローブは、保存された接続を確認します。
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeGoogle Search 権限でキーを作成するか、または 1 つを再使用して下さい。 ホストの MCP 設定にサーバーを下フィールドで追加します。 保護されたヘッダフィールドにキーを置き、再接続します。OAuthコマンドは必要ありません。
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYNode.js 22.18+ と API キーを Google Search 権限で要求します。 mcpServers JSONをサポートするホストにこれをマージします。 YOUR_API_KEYをローカルで保護された設定に置換し、ホストを再起動します。 npx.cmdをホストが実行可能ファイル名を必要とする場合は、Windowsで使用してください。
npmパッケージはローカルMCPサーバーを実行します。 スタンドアローンFlashData CLIは別の実行可能です。
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. 接続を確認する
エージェントのセッションで送信してください。 get_pricing と get_balance コールの成功を期待します。, google_search と利用可能なクレジット残高の利用可能な価格. ゼロバランスとは、検索にクレジットが必要なことを意味します。認証が失敗したわけではありません。
既存の Flashdata MCP 接続を使用してください。
get_pricing と {"source":"google_search","request_count":1} を呼び出します。
get_balance と {} を呼び出します。
ソースが利用可能な価格を持っているかどうか、両方の呼び出しが成功しているかどうかを報告します。
利用可能なクレジット残高。 ゼロバランスは認証障害ではありません。
検索を実行したり、ダウンロードしたり、トライアルを作成したり、資格情報を変更したりしないでください。3. 最初のタスクを尋ねる
接続されたエージェントに貼り付けます。 残高と価格設定のチェックは無料です。検索はアカウントクレジットを使用します。
FlashDataを使用して、残高と1つのGoogle検索の価格を確認します。 十分なクレジットがある場合, コール google_search クエリで一度 "battery recycling research", 数字 5 モードとモード "realtime". タイトル、ソース URLs、短納期、実際のクレジットが使用される。 このタスクの後に停止します。結果を確認
あなたのエージェントは、ソースリンクと抜粋を返し、実際のクレジットを使用する必要があります。 根本的な検索結果は、status: doneとresults[].organic.を持っています 空の結果は有効です。エージェントはそれを報告する必要があります。 以下は、イラストです。
Google検索完了
1. バッテリーリサイクル研究 — https://example.org/recycling
たとえば、検索結果は抜粋。
使用されるクレジット: 0.02利用可能なツール
API-keyは、そのキーに付与されたパーミッションを使用します。 サーバのツールやスキーマの入力を全現カタログでご確認いただけます。
| タスク | ツール | アクセス |
|---|---|---|
| Googleの検索 | google_search | mcp:research / API key |
| YouTube動画を探す | youtube_search | mcp:research / API key |
| ビデオメタデータを読む | youtube_metadata | mcp:research / API key |
| 既存のキャプションを取得する | youtube_transcript | mcp:research / API key |
| ビデオやオーディオをダウンロード | youtube_download | 所有者 API キー + 宛先ストレージ |
| アカウントと価格をチェックする | get_balance, get_pricing, get_limits, get_usage | 無料アカウントの読み込み |
OAuth、パーミッション、トライアルについて
OAuthは、検証済みの所有者アカウントを接続し、ホストストアとリフレッシュトークンを割り当てます。 mcp:research付与は、上記の4つの研究ソースをカバーしています。 APIキー接続は、保護されたX-API-Keyヘッダーを使用し、他の認証されたソースを含めることができます。
アカウントを作成する前に FlashData を試してみるには、CLI の試用フローを使用します。 MCP OAuthは、所有者アカウントを接続します。それは、トライアルを登録または請求しません。 CLI プロファイルは、MCP ホストと自動的に共有されません。
トラブルシューティング
| 問題の問題 | ぜひお試しください。 |
|---|---|
| FlashDataツールはありません | 同意をクリアし、新しいセッションを再接続し、開始します。 URL とストリーミング可能な HTTP トランスポートを確認します。 |
| invalid_client / callback error | Codex または OpenClaw では、ローカルコールバックに到達できる、クライアントの構成とブラウザを正確に使用してください。 別のホストでは、サポートされている API-key または stdio セットアップを使用してください。 |
| 401 | 期限切れまたは再発解除の解除 OAuth アクセス、または確認 API ホストに供給されるキー。 無料チェックを繰り返します。 |
| 403 | 要求されたソースとキーのパーミッションを確認してください。 YouTube Downloadは、youtube_downloadと宛先ストレージの所有者APIキーが必要です。 mcp:researchには含まれていません。 |
| 402 | Billingと現在の価格を確認してください。 有効なクレデンシャルを再接続すると、クレジットが加算されません。 |
| 429 | Retry-Afterをフォローしてください。 タスクを再試行するかどうかを決定する前に、既存のジョブまたは結果の ID を保持します。 |
| タイムアウトまたは不完全な応答 | ID のリクエストを保ち、History をチェックしてください。 検索を繰り返す代わりに、get_resultで大規模な結果の継続を読みます。 |