Przeglądaj dokumentację
Pierwsze kroki
Podaj agentowi narzędzia Google Search i YouTube. Połącz hosta, a następnie poproś o swój pierwszy wynik.
Na tej stronie
1. Podłącz i podpisz
Wybrać Codex lub OpenClaw dla przeglądarki opartej na OAuth. Dla innego hosta, wybierz Zdalny / API jeśli obsługuje Streamable HTTP i niestandardowe nagłówki, lub Local / stdio jeśli uruchamia procesy MCP. Serwer hostowany nie wymaga lokalnej instalacji.
Połącz poniższy plik konfiguracyjny w ~ /.codex/config.toml, a następnie uruchom polecenie logowania. Wypełnij FlashData logowanie lub logowanie i wyrażaj zgodę w przeglądarce. Po zalogowaniu rozpocząć nową sesję 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:researchUruchom te polecenia w profilu OpenClaw, którego używa Twój agent. Pełna rejestracja lub logowanie i zgoda w przeglądarce, a następnie rozpocząć nową sesję. Sonda lekarska sprawdziła uratowane połączenie.
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 --probeUtwórz klucz za zgodą Google Search lub ponownie go użyj. Dodaj serwer w ustawieniach MCP hosta za pomocą pól poniżej. Umieścić klucz w chronionym polu nagłówka i ponownie połączyć; nie jest potrzebne polecenie OAuth.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYWymaga Node.js 22.18 + i klawisza API z pozwoleniem Google Search. Połącz to z hostem, który obsługuje mcpServers JSON. Zastąp YOUR_API_KEY w swojej lokalnej konfiguracji chronionej, a następnie ponownie uruchom hosta. Użyj npx.cmd na Windows, jeśli host wymaga nazwy pliku wykonywalnego.
Pakiet npm jest obsługiwany przez lokalny serwer MCP. Samodzielny FlashData CLI jest oddzielnym wykonywalnym.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Sprawdź połączenie
Wyślij to na świeżą sesję agentów. Oczekuj udanych połączeń get_pricing i get_balance, dostępnej ceny za google_search i dostępnego salda kredytowego. Bilans zerowy oznacza, że potrzebne są kredyty do wyszukiwania; nie oznacza to, że uwierzytelnienie nie powiodło się.
Użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_pricing z {"source":"google_search","request_count":1}.
Zadzwoń do get_balance z {}.
Proszę podać, czy oba połączenia zakończyły się sukcesem, czy źródło ma dostępną cenę,
oraz dostępne saldo kredytowe. Saldo zerowe nie jest wadą uwierzytelniania.
Nie uruchamiaj wyszukiwania ani pobierania, nie twórz prób ani nie zmieniaj referencji.3. Poproś o pierwsze zadanie
Wklej to swojemu powiązanemu agentowi. Saldo i kontrola cen są darmowe; w wyszukiwarce wykorzystuje się kredyty na konto.
Użyj FlashData, aby sprawdzić moje saldo i cenę jednego wyszukiwania Google. Jeśli jest wystarczająco dużo kredytów, zadzwoń raz do google_search z zapytaniem "battery recycling research", num 5 i tryb "realtime". Zwróć tytuły, źródło URLs, krótkie fragmenty i rzeczywiste kredyty używane. Przestań po tym zadaniu.Sprawdź wynik
Twój agent powinien zwrócić linki źródłowe i fragmenty, plus rzeczywiste kredyty używane. Podstawowy wynik wyszukiwania ma status: done i results[].organic. Pusty wynik jest ważny; agent powinien go zgłosić. Poniższy przykład jest ilustrujący.
Ukończył jedno wyszukiwanie Google.
1. Badania recyklingu baterii - https://example.org/recycling
Przykład wyszukiwanie fragmentu.
Używane zasługi: 0.02Dostępne narzędzia
API-key połączenia korzystać z uprawnień przyznanych do tego klucza. Odkryj narzędzia serwera i schematy wejściowe dla pełnego bieżącego katalogu.
| Zadanie | Narzędzie | Dostęp |
|---|---|---|
| Szukaj Google | google_search | mcp:research / API key |
| Znajdź filmy YouTube | youtube_search | mcp:research / API key |
| Odczytywanie metadanych wideo | youtube_metadata | mcp:research / API key |
| Odzyskiwanie istniejących zapisów | youtube_transcript | mcp:research / API key |
| Pobierz wideo lub audio | youtube_download | Właściciel API klucz + miejsce przeznaczenia |
| Sprawdź rachunek i ustalanie cen | get_balance, get_pricing, get_limits, get_usage | Bezpłatne czytanie konta |
O OAuth, uprawnienia i próby
OAuth łączy zweryfikowane konto właściciela i pozwala na przechowywanie i odświeżenie żetonów. Dotacja mcp:research obejmuje cztery wyżej wymienione źródła badawcze. API-key połączenia używać chronionego nagłówka X-API-Key i może zawierać inne autoryzowane źródła.
Aby wypróbować FlashData przed utworzeniem konta, użyj przepływu próbnego CLI. MCP OAuth łączy konto właściciela; nie rejestruje się ani nie wnosi o przeprowadzenie procesu. Profil CLI nie jest automatycznie udostępniany z hostem MCP.
Rozwiązywanie problemów
| Problem | Spróbuj tego |
|---|---|
| Brak narzędzi FlashData | Zakończ zgodę, ponownie połącz się i rozpocznij nową sesję. Sprawdź transport URL i Streamable HTTP. |
| invalid_client / callback error | W przypadku Codex lub OpenClaw, użyj jego dokładnej konfiguracji klienta i przeglądarki, która może dotrzeć do lokalnego połączenia zwrotnego. Dla innego hosta, użyj obsługiwanego klucza API- lub stdio powyżej. |
| 401 | Uzyskiwanie dostępu do OAuth wygasło lub cofnięto go lub sprawdź klucz API dostarczony hostowi. Powtórzyć bezpłatny czek. |
| 403 | Sprawdź wymagane prawa źródłowe i klucze. YouTube Download wymaga właściciela klucza API z youtube_download i miejsca przeznaczenia; mcp:research nie zawiera go. |
| 402 | Sprawdź Billing i bieżącą cenę. Utworzenie ważnego kredytu nie dodaje kredytów. |
| 429 | Podążaj za Retry-After. Przed podjęciem decyzji o ponownym wykonaniu zadania należy zachować dotychczasowe zadanie lub wynik ID. |
| Czas lub niekompletna odpowiedź | Należy zachować zapytanie ID i sprawdzić History. Czytaj kontinuacje wyników dużych wyników za pomocą get_result zamiast powtarzania wyszukiwania. |