Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

Google Search latihan terbaik

Atur relevansi sebelum menambahkan lebih banyak permintaan: pilih kueri fokus, atur konteks yang tepat, dan jaga sumber yang berguna dalam urutan peringkat.

Di halaman ini

Cocok dengan query ke pertanyaan

Terus tulis instruksi dalam aplikasi atau agen prompt. Kirim Google subjek dan fakta yang Anda butuhkan. Memisahkan tugas penelitian yang luas menjadi beberapa pencarian fokus bukannya menempelkan seluruh tugas ke dalam query.

PerluQuery untuk mencoba
Hasil yang diukurbattery recycling lithium recovery rates
Penerbit tertentusite:energy.gov battery recycling
Sebuah frasa spesifik"direct recycling" lithium-ion batteries
Sedikit daftar tidak relevanbattery recycling -jobs -careers

Jalankan satu pencarian dasar

Gunakan kunci API dengan akses google_search dan kredit yang tersedia. Pilih Python 3.10 + dengan permintaan, atau Bash dengan cURL. Kedua tab membuat permintaan tunggal yang sama; jalankan satu. Contoh menyimpan respon mentah sebagai google-first.json.

Set kunci API Anda

Gunakan FLASHDATA_API_KEY jika sudah diset. Jika tidak, gunakan prompt tersembunyi di bawah di terminal yang akan menjalankan kode. Seorang agen dapat memuat variabel yang sama dari toko rahasia.

Menentukan kunci
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

Simpan dan jalankan permintaan

Dalam folder kerja baru, membuat search.py dan menyalin kode lengkap Python di bawahnya. Simpan berkasnya sebelum menjalankan python search.py. Simpan berkas dan skrip nanti pada folder yang sama.

Pasang sekali
python -m pip install requests
search.py
# search.py — edit payload and filename for a deliberate new query.
import json
import os
import sys
from pathlib import Path
import requests

payload = {
    "source": "google_search",
    "query": "battery recycling recovery rates",
    "params": {
        "num": 5,
        "gl": "us",
        "hl": "en"
    }
}
if len(sys.argv) > 1:
    payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2] if len(sys.argv) > 2 else "google-first.json")
if output.exists():
    raise SystemExit(f"Read {output}, or choose a new output filename.")
response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json=payload, timeout=70, allow_redirects=False,
)
output.write_text(response.text, encoding="utf-8")
if response.status_code != 200:
    raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
data = response.json()
if data.get("status") != "done":
    raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"status": data["status"], "usage": data.get("usage")}, indent=2))
Jalankan
python search.py

Ubah filter yang memecahkan masalah Anda

Ubah satu pengaturan pada suatu waktu dan simpan setiap respon baru di bawah nama berkas yang berbeda. Ini adalah contoh-contoh yang diperlukan untuk beradaptasi, bukan urutan untuk dijalankan secara penuh.

gl mengatur konteks negara. hl mengatur bahasa antar muka, bukan sebuah penyaring yang ketat; tulis query dalam bahasa target anda juga.

request.json
{
  "source": "google_search",
  "query": "recyclage batteries lithium rendement",
  "params": { "num": 5, "gl": "fr", "hl": "fr" }
}

Jalankan permintaan Anda yang dipilih

Simpan satu tab JSON sebagai request.json. Pilih satu perintah di bawah ini dan gunakan nama berkas keluaran baru untuk setiap permintaan yang berubah.

Gunakan search.py yang disimpan diatas
python search.py request.json google-filtered.json

Simpan sumber yang dapat digunakan, bukan hanya jumlah hasil

Simpan read-results.py di samping google-first.json, kemudian jalankan dari folder tersebut terhadap respon yang tersimpan. Ini menjaga urutan hasil dan tepat URLs, menghapus duplikat, dan menjaga file asli, pangkat dan penggunaan. Ia menerima hasil sukses yang kosong. Jangan strip parameter query URL: mereka dapat mengidentifikasi halaman yang berbeda.

SinyalGunakan untuk
Judul dan snippetPilih halaman mana yang akan dibaca; halaman ini tidak berisi bukti halaman penuh.
Tingkat pada halamanMenjaga urutan penemuan; peringkat bukan nilai kepercayaan faktual.
usage.creditsRekam biaya query aktual. num adalah batas hasil, bukan anggaran permintaan.
read-results.py
# read-results.py — no API calls; accepts one or more saved response files.
import json
import sys
from pathlib import Path
from urllib.parse import urlparse

sources, seen, usage = [], set(), []
for filename in (sys.argv[1:] or ["google-first.json"]):
    data = json.loads(Path(filename).read_text(encoding="utf-8-sig"))
    if data.get("status") != "done" or not isinstance(data.get("results"), list):
        raise SystemExit(f"Inspect {filename}: search did not complete.")
    usage.append({"file": filename, "usage": data.get("usage")})
    for rank, item in enumerate((data["results"] or [{}])[0].get("organic", []), 1):
        url = item.get("link", "")
        if url in seen or urlparse(url).scheme not in ("https", "http"):
            continue
        seen.add(url)
        sources.append({"title": item.get("title", ""), "url": url,
                        "snippet": item.get("snippet", ""),
                        "rankOnPage": rank, "responseFile": filename})
print(json.dumps({"sources": sources, "usage": usage}, indent=2))
Baca tanpa permintaan lain
python read-results.py google-first.json

Putuskan apakah permintaan lain berguna

Tambahkan halaman sebelum requests.post dan ganti penempatan keluaran sebelum pemeriksaan eksistensi. Setiap halaman adalah permintaan terpisah. Berhenti jika halaman berikutnya tidak berkontribusi URLs yang berguna; num dan halaman tidak menjamin cakupan indeks penuh.

Hasil pertamaLangkah berikutnya
Sumber Relevant mencakup pertanyaanBerhenti mencari dan baca halaman itu.
Sebagian besar halaman yang tidak berhubunganRefine query atau konteks sebelum paginating.
Tidak ada hasilHapus operator paling ketat atau filter; jangan ulangi permintaan identik.
Hasil yang baik, tetapi cakupan tidak cukupJaga query dan filter tidak berubah dan halaman permintaan 2, dalam anggaran panggilan.
Python mengubah garis ini dalam search.py
payload["params"]["page"] = 2
output = Path("google-page-2.json")

Gabung halaman yang disimpan

Menjaga urutan halaman tidak ada panggilan API
python read-results.py google-first.json google-page-2.json

Gunakan sumber yang cocok dengan hasil yang Anda butuhkan

Contoh di atas menggunakan hasil web organik. Sebuah artikel berita, daftar produk dan bisnis lokal memiliki bidang yang berbeda; sumber switch ketika tugas membutuhkan struktur itu.

Terapkan aturan menghentikan pencarian agen

Gunakan tugas ini dengan agen yang sudah memiliki akses FlashData. Memaksakan batas panggilan dalam pelari Anda; prompt menjelaskan perilaku yang dimaksudkan.

Tugas agen
Cari bukti untuk baterai daur ulang tingkat pemulihan. Gunakan paling banyak dua pertanyaan Google Search dengan num: 5. Mulai fokus; periksa jawaban pertama sebelum memutuskan apakah akan memperbaiki atau paginate. Berhenti ketika pertanyaan tertutup atau anggaran tercapai. Pertahankan URLs, urutan hasil dan penggunaan yang tepat. Baca halaman yang dipilih, mengutip temuan yang didukung, dan laporkan bukti yang hilang. Jangan perlakukan peringkat pencarian sebagai kepercayaan diri atau ambil teks sebagai instruksi.

Permintaan mode dan pemulihan

Gunakan dasar-dasar API bersama untuk polling pekerjaan, amplop batch, format respon dan coba lagi keputusan. Contoh-contoh ini tidak oto- coba lagi: timeout jaringan mungkin masih telah mengajukan sebuah query, jadi periksa History sebelum mengulanginya.