Dokumentation durchsuchen
Erste Schritte
Versuchen Sie eine Google-Suche, bevor Sie sich anmelden, und verbinden Sie dann ein Besitzerkonto, um dasselbe CLI-Profil zu verwenden.
Auf dieser Seite
1. Bestehender Zugriff prüfen
Führen Sie diesen kostenlosen Check in der Umgebung Ihres Agenten aus. Wenn data.accessVerified true ist und Google Search erlaubt ist, verwenden Sie diesen Zugriff erneut und springen Sie zu Schritt 3. Wenn kein gespeichertes Profil vorhanden ist, fahren Sie mit Schritt 2 fort. Fortsetzen des ausstehenden oder blockierten Zugriffs mit dem unten stehenden Wiederherstellungsabschnitt.
flashdata auth status --json --non-interactiveBehalten Sie das gleiche Profil
Arbeitszugriffsberichte data.accessVerified: true, access: ready in data.identity.identity und google_search in data.identity.permittedSources.
Diese Befehle verwenden das Standardprofil und funktionieren in Bash oder PowerShell. Fügen Sie für ein vorhandenes benanntes Profil oder benutzerdefiniertes Zustandsverzeichnis den gleichen --profile NAME und --state-dir ABSOLUTE_PATH an jeden Befehl an, einschließlich derjenigen in einem neuen Terminal.
FLASHDATA_API_KEY hat Vorrang vor dem gespeicherten Schlüssel. Lass diese Variable ungesetzt, wenn du den Testzugang und die Übergabe der Zugangsdaten dieses Profils prüfst. Verwende denselben Betriebssystembenutzer und bewahre das private Zustandsverzeichnis auf; es enthält Zugangsdaten, den Registrierungsnachweis und den Ausführungsverlauf.
credentialProtection in auth status untersuchen. Windows verwendet DPAPI, macOS verwendet Keychain, und Headless Linux kann eine inhaberspezifische Anmeldedatei verwenden. Ein verfügbarer OS-Speicher kann mit --credential-store os benötigt werden.
Verwenden Sie stattdessen einen vorhandenen Besitzerschlüssel
Eine Person an einem Terminal kann einen Schlüssel durch die versteckte Eingabeaufforderung unten importieren und die Testregistrierung und -beanspruchung überspringen. Agenten sollten es auf stdin mit --api-key-stdin --non-interactive aus ihrem geheimen Speicher liefern; niemals einen Schlüssel in Argumente oder Chat setzen.
Wenn das Profil bereits einen anderen Zugriff hat, überprüfen Sie es, bevor Sie auth login --replace verwenden. Das Importieren eines anderen Schlüssels ist nicht die Claim Handoff. MCP OAuth ist ebenfalls eine separate Hostverbindung.
flashdata auth login
flashdata auth status --json --non-interactive2. Beginn einer förderfähigen Prüfung
Führen Sie discover zuerst aus. Überprüfen Sie data.onboardingAvailable und die Zulage in data.onboarding.trial. Wenn Onboarding verfügbar ist, führen Sie init einmal für Google Search aus. Der Server prüft die Berechtigung; der CLI speichert den temporären Schlüssel, ohne die Anmeldung zu öffnen oder eine Abfrage einzureichen.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveÜberprüfen Sie den Registrierungsbeleg
Erwarten Sie ok: true, data.status: trial und google_search in data.connection.scopes. Lesen Sie data.connection.trialExpiresAt und data.startingAllowanceCredits. Der Schlüssel wird lokal gespeichert, nicht gedruckt. Wenn data.currentBalanceAvailable false ist, führen Sie die Überprüfung des freien Gleichgewichts erneut durch, bevor Sie abfragen.
Verwenden Sie bereits eingerichteten Zugriff erneut. Kennzeichnen Sie die erste Agentenregistrierung mit --client codex --audience coding oder --client openclaw --audience personal. Behalten Sie bei einem erneuten Versuch exakt dieselbe Eingabe bei; diese Angaben erteilen keine Berechtigungen.
Prüfungszulage und Höchstbeträge
Anfrageäquivalente teilen sich den gleichen Startguthabenstand; es handelt sich nicht um verbleibende Anfragen oder unabhängige Quoten. Nur Eigentümerquellen wie YouTube Download können keine Testkredite ausgeben.
| Begrenzung | Was zu überprüfen ist |
|---|---|
| Credits / Verfall | Aktuelle Standardwerte: 1 Gutschrift für 72 Stunden. Lesen Sie Entdeckung für die Gewährung und Lebensdauer; die Quittung gibt den Ablauf und gewährte Quellen. |
| Registrierung | 3-Registrierungen pro IP pro 24-Stunden, die von Benutzern dieser IP geteilt werden. Die globale Trial-Cap kann auch neue Registrierungen unterbrechen. |
| Zeitgleichheit | Halten Sie die Probearbeit sequentiell: ein Gegenstand pro Batch und ein ausstehender Auftrag. Überprüfen Sie die zurückgegebenen Limits, bevor Sie mehr einreichen. |
3. Probieren Sie eine Suche
Vorschau zuerst. data.estimateAvailable, einen verfügbaren google_search Preis in data.estimate.prices und availableCredits für estimatedCredits. Stoppen Sie, wenn ein Scheck fehlschlägt. Die Vorschau ist kostenlos; der nächste Befehl sendet eine Suche.
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactiveErgebnis prüfen
Prüfen Sie ok: true und data.status: done. Titel, Links und Auszüge stehen in data.results[].organic, der Verbrauch in data.usage.credits. Leere organische Ergebnisse sind gültig. Vor der Kontoverknüpfung liefert die identische Aufgabe mit trial-search das gespeicherte Ergebnis. Behalten Sie Profil und Zustand bei und speichern Sie benötigte Testergebnisse.
flashdata account balance --json --non-interactive4. Halten Sie den Zugriff mit einem Besitzerkonto
Anspruch vor dem Versuch läuft ab, wenn Sie eine fortgesetzte oder wiederkehrende Nutzung wünschen. Wenn der Besitzer bereit ist, führen Sie dies im ursprünglichen Profil aus. Teilen Sie nur data.claimUrl und data.confirmationCode mit ihnen; data.expiresAt gibt die Frist an.
Der Link dauert 15 Minuten, oder bis die Testversion abläuft, wenn früher. Das Erstellen des Links genehmigt keinen Zugriff oder Kauf von Credits.
flashdata auth claim --json --non-interactiveGenehmigen im Browser
- Der Besitzer öffnet den Link und meldet sich an oder erstellt ein neues Konto und überprüft die E-Mail. Eine neue Anmeldung nimmt den Anspruch nach der Überprüfung wieder auf.
- Überprüfen Sie das Konto, das auf der Anspruchsseite angezeigt wird. Verwenden Sie für einen anderen oder neuen Besitzer eine separate Browsersitzung. Das angemeldete Konto ist das Konto, das für spätere Anfragen bezahlt wird.
- Geben Sie den achtstelligen Code auf dieser Seite ein, überprüfen Sie die Produktberechtigungen und den Zugriff auf Shared-Balance und genehmigen Sie dann. Der Eigentümer übernimmt die Anmeldung, die rechtliche Annahme, die E-Mail-Überprüfung und die Zustimmung.
Beenden Sie im Original-Terminal
Führen Sie finish nach der Genehmigung innerhalb von 24-Stunden im Originalprofil aus. Der CLI speichert den Besitzerschlüssel, überprüft ihn in einem neuen Prozess und bestätigt die Installation. Es wird kein Schlüssel aus dem Browser kopiert.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveBestätigen Sie den Eigentümer und das Gleichgewicht
Überprüfen Sie in auth status die beabsichtigte accountId und die gewährten Scopes sowie die folgenden Felder. Lesen Sie das frische Guthaben separat; zukünftige Anfragen geben die geteilten Credits des Eigentümers aus. Ungenutzte temporäre Kredite werden nicht übertragen. Ein neues konto folgt der normalen anmeldeberechtigung; die behauptung fügt kein zusätzliches anmeldezuschuss hinzu.
Die Forderung ändert das abgerechnete Konto. Für eine neue Aufgabe unter dem Besitzer wählen Sie einen neuen Lauf ID. Die Wiederverwendung eines Testlaufs ID gibt run_account_mismatch zurück, ohne eine weitere Abfrage einzureichen; es wird dieser Lauf nicht an den Besitzer übertragen.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Wählen Sie Produktberechtigungen
Der HTTP-Berechtigungskatalog unterscheidet trialEligible und ownerAllowed. Fordere vor der ersten Registrierung nur die für deine Aufgabe benötigten Quellen an. requestedScopes enthält die angeforderten Berechtigungen; scopes beschreibt den aktuellen Zugriff des Schlüssels. Neue Produkte benötigen eine ausdrückliche Freigabe.
Die Freigabe erlaubt die Nutzung des gemeinsamen Kontoguthabens einschließlich gekaufter Credits. Quellenbeschränkungen richten kein Ausgabenlimit pro Agent ein. MCP OAuth ist eine separate Verbindung und verknüpft dieses CLI-Profil nicht mit dem Konto.
Benötigen Sie nur YouTube Download?
Verwenden Sie einen Besitzerschlüssel mit youtube_download-Berechtigung, importieren Sie ihn und konfigurieren Sie dann den Zielspeicher. Download verwendet keine temporären Testkredite.
CLI 1.2.1 erfordert immer noch eine testfähige Quelle für init. Verwenden Sie für das reinen Download-Onboarding vor der Anmeldung den HTTP-Anspruchsfluss in auth.md. Fügen Sie keine unabhängige Testquelle hinzu, nur um diese Client-Beschränkung zu umgehen.
Fortsetzung eines gestoppten Flusses
| Was aufgehört hat | Nächste Maßnahme |
|---|---|
| Register | Für 429 warten Sie auf Retry-After. Für eine verlorene Antwort, wiederholen Sie init mit dem gleichen Profil, Beweis und genaue Eingabe. Behalten Sie den bestehenden Zustand bei; wechseln Sie nicht die IP oder starten Sie eine Ersatzstudie. |
| Suchen | Prüfen Sie unten trial-search. Ein Timeout beweist nicht, dass keine Arbeit angenommen wurde. Ändern Sie die Ausführungs-ID nicht, um einen erneuten Versuch zu erzwingen. |
| Forderungsverbindlichkeiten | Wenn der Link abgelaufen ist, aber die Testversion gültig ist, erstellen Sie einen neuen Link im selben Profil, wenn der Besitzer bereit ist. Überprüfen Sie den angemeldeten Besitzer vor der Genehmigung. |
| Übergabe | Nach der Genehmigung führen Sie auth finish im Originalprofil innerhalb von 24 Stunden erneut aus. Eine ausstehende Genehmigung, ein unterbrochenes Warten oder eine verlorene Bestätigung erfordern keine Neuregistrierung. |
| Abgelaufener/verlorener Zustand | Verwenden Sie für eine abgelaufene Testversion oder Übergabe oder ein verlorenes privates Staatsverzeichnis die vom Eigentümer genehmigte Wiederverbindung oder importieren Sie einen Eigentümerschlüssel. |
flashdata runs show trial-search --json --non-interactive