Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Uji coba agen dan penautan akun

Cobalah Google cari sebelum pendaftaran, lalu hubungkan akun pemilik untuk tetap menggunakan yang sama CLI profil.

Di halaman ini

1. Periksa akses yang ada

Jalankan pemeriksaan gratis ini di lingkungan agenmu. Jika data.accessVerified adalah true dan Google Search diijinkan, gunakan kembali akses tersebut dan lewatkan untuk langkah 3. Tanpa profil tersimpan, lanjutkan langkah 2. Melanjutkan penundaan atau memblokir akses menggunakan bagian pemulihan di bawah ini.

Periksa profil ini
flashdata auth status --json --non-interactive

Pertahankan profil yang sama

Laporan akses data.accessVerified: true, access: ready dalam data.identity.identity, dan google_search dalam data.identity.permittedSources.

Perintah ini menggunakan profil baku dan bekerja di Bash atau PowerShell. Untuk profil yang sudah ada atau direktori keadaan gubahan, tambahkan yang sama --profile NAMA dan --state-dir ABSOLUTE_PATH untuk setiap perintah, termasuk mereka dalam terminal segar.

FLASHDATA_API_KEY didahulukan daripada kunci yang tersimpan. Biarkan variabel ini tidak disetel saat menguji uji coba dan penyerahan kredensial profil ini. Gunakan pengguna OS yang sama dan pertahankan direktori status privat; direktori ini menyimpan kredensial, bukti pendaftaran, dan riwayat eksekusi.

Inspeksi credentialProtection dalam auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan tanpa kepala Linux dapat menggunakan sebuah owner- hanya berkas kredensial. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.

Pakai kunci pemilik yang ada saja

Seseorang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah ini dan melewatkan pendaftaran pengadilan dan mengklaim. Para agen harus mensuplai di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; jangan pernah menaruh kunci dalam argumen atau percakapan.

Jika profil ini memiliki akses yang berbeda, periksa terlebih dahulu menggunakan auth login --replace. Mengimpor kunci lain bukan sebagai jawaban klaim. MCP OAuth juga merupakan sambungan host terpisah.

Prompt kunci tersembunyi
flashdata auth login
flashdata auth status --json --non-interactive

2. Mulai satu pengadilan yang memenuhi syarat

Jalankan discover dulu. Periksa data.onboardingAvailable dan uang saku dalam data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Pemeriksaan server eligibilitas; CLI menyimpan kunci sementara tanpa membuka pendaftaran atau mengirimkan permintaan.

Periksa ketersediaan
flashdata discover --json --non-interactive
Mulai akses sementara
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Periksa tanda terima registrasi

Diharapkan ok: true, data.status: trial dan google_search in data.connection.scopes. Baca data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. Jika data.currentBalanceAvailable adalah false, jalankan kembali pemeriksaan keseimbangan gratis sebelum kueri.

Jika setup sudah membuat akses, gunakan kembali. Untuk melabeli pendaftaran pertama agen, tambahkan --client codex --audience coding atau --client openclaw --audience personal. Simpan masukan yang tepat pada suatu coba ulang; label tidak memberikan izin.

Pembagian dan batas ujian

Permintaan ekuivalen berbagi saldo awal kredit yang sama; mereka tidak tersisa permintaan atau kuota independen. Pemilik - hanya sumber seperti YouTube Download tidak dapat menghabiskan kredit percobaan.

BatasApa yang harus diperiksa
Kredit / kadaluwarsaDefault saat ini: kredit 1 untuk jam 72. Baca penemuan untuk hibah dan seumur hidup; tanda terima memberikan habis dan sumber yang diberikan.
Pendaftaran3 registrasi per IP per jam 24, dibagikan oleh pengguna IP tersebut. Penutup percobaan global juga dapat menghentikan registrasi baru.
konkuenCity in Texas, United StatesPertahankan sekuensial percobaan: satu hal per batch dan satu pekerjaan yang tertunda. Periksa kembali batas sebelum mengirimkan lebih banyak.

3. Coba satu pencarian

Preview dulu. Perlu data.estimateAvailable, harga yang tersedia google_search dalam data.estimate.prices, dan availableCredits meliputi estimatedCredits. Berhenti jika cek gagal. Pratilik bebas; perintah selanjutnya menyerahkan pencarian.

Periksa saldo dan biaya
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Satu pencarian sampai lima hasil
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Periksa hasil

Diharapkan ok: true dan data.status: done. Baca judul, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik kosong valid. Sebelum mengklaim, mengulangi tugas ini dengan trial-search mengembalikan hasilnya. Menjaga profil dan negara, dan mempertahankan setiap hasil percobaan yang Anda butuhkan.

Periksa keseimbangan yang tersisa
flashdata account balance --json --non-interactive

4. Simpan akses dengan akun pemilik

Klaim sebelum percobaan berakhir bila anda ingin melanjutkan atau mengulangi penggunaan. Ketika pemiliknya siap, jalankan ini dalam profil asli. Berbagi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan tenggat waktu.

Taut berlangsung 15 menit, atau sampai sidang berakhir jika lebih cepat. Membuat link tidak menyetujui akses atau kredit pembelian.

Buat link klaim ketika pemilik siap
flashdata auth claim --json --non-interactive

Approve dalam peramban

  1. Pemilik membuka tautan dan tanda-tanda masuk, atau membuat akun baru dan memverifikasi email. Sebuah tanda tangan baru melanjutkan klaim setelah verifikasi.
  2. Periksa akun yang ditunjukkan pada halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban terpisah. Sign-in account adalah account yang akan membayar untuk permintaan kemudian.
  3. Masukkan kode delapan digit pada halaman itu, tinjau perizinan produk dan berbagi-keseimbangan akses, kemudian setuju. Pemilik menangani pendaftaran, penerimaan hukum, verifikasi email dan persetujuan.

Selesai di terminal asli

Setelah persetujuan, jalankan finish dalam profil asli dalam waktu 24 jam. CLI menyimpan kunci pemiliknya, memastikannya dalam proses baru dan mengakui instalasi. Tak ada kunci yang disalin dari peramban.

Simpan dan verifikasi akses pemilik
flashdata auth finish --wait --timeout 10m --json --non-interactive
Kemudian periksa dari terminal baru yang sama pengguna dan profil OS
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Konfirmasikan pemilik dan keseimbangan

Dalam auth status, verifikasi yang dimaksud accountId dan diberikan scopes, ditambah bidang di bawah ini. Baca keseimbangan baru secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tak digunakan tidak ditransfer. Sebuah akun baru mengikuti eligibilitas pendaftaran normal; mengklaim tidak menambahkan tambahan hibah pendaftaran.

Mengklaim perubahan akun tagihan. Untuk tugas baru di bawah pemilik, pilih run baru ID. Menggunakan percobaan ID mengembalikan run_account_mismatch tanpa mengirimkan kueri lain; itu tidak mentransfer yang ke pemilik.

Diharapkan bagian-bagian yang dikeluarkan
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

Pilih perizinan produk

Katalog izin HTTP membedakan trialEligible dan ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas Anda. requestedScopes berisi izin yang diminta; scopes menunjukkan akses kunci saat ini. Produk baru memerlukan pemberian izin secara eksplisit.

Persetujuan mengizinkan penggunaan saldo bersama pemilik, termasuk kredit yang dibeli. Pembatasan sumber tidak menetapkan batas pengeluaran per agen. MCP OAuth adalah koneksi terpisah dan tidak menautkan profil CLI ini ke akun.

Hanya perlu YouTube Download?

Gunakan kunci pemilik dengan izin youtube_download, impor, lalu konfigurasi penyimpanan tujuan. Unduh tidak menggunakan kredit percobaan sementara.

CLI 1.2.1 masih membutuhkan sumber yang memenuhi syarat untuk init. Untuk Download- hanya onboarding sebelum sign-up, gunakan aliran klaim HTTP dalam auth.md. Jangan tambahkan sumber percobaan hanya untuk melewati batasan klien.

Lanjutkan aliran berhenti

Apa yang berhentiAksi berikutnya
RegisterUntuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil yang sama, bukti, dan masukan yang tepat. Pertahankan keadaan yang ada; jangan menukar IP atau memulai percobaan pengganti.
CariInspeksi trial-search di bawah ini. Sebuah timeout tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan mengubah menjalankan ID untuk memaksa sebuah coba lagi.
Taut claimBila tautan berakhir tapi percobaan valid, buat sebuah tautan segar dalam profil yang sama ketika pemiliknya siap. Periksa sinyal pemilik sebelum persetujuan.
HandoffSetelah persetujuan, tayangan ulang auth finish dalam profil asli dalam waktu 24 jam. Persetujuan yang tertunda, menunggu yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru.
Keadaan terlama / hilangUntuk percobaan yang kadaluwarsa atau handoff, atau direktori keadaan privat yang hilang, gunakan koneksi ulang yang disetujui atau impor kunci pemilik.
Inspeksi pencarian tersimpan
flashdata runs show trial-search --json --non-interactive