İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

Google Search en iyi uygulamalar

Daha fazla talep eklemeden önce ilgi geliştirmek: odaklanmış sorguları seçin, doğru bağlamı seçin ve sıralamada faydalı kaynakları tutar.

Bu sayfada

Soruyu soruyla eşleştirin

Uygulamanızda veya ajandadaki talimatları yaz. Google konu ve ihtiyacınız olan gerçeği gönderin. Tüm görevi sorguya sokmak yerine birkaç odaklanmış sorguya geniş bir araştırma görevi ayırın.

İhtiyaç ihtiyacına ihtiyaç varQuery to try to try
Ölçülen bir sonuçbattery recycling lithium recovery rates
Belirli bir yayıncısite:energy.gov battery recycling
Belirli bir cümle"direct recycling" lithium-ion batteries
Daha az alakalı listelerbattery recycling -jobs -careers

Tek bir temel arama

API anahtarını google_search erişim ve mevcut kredilerle kullanın. Python 3.10 + isteklerle veya Bash ile cURL. Her iki sekme de aynı tek sorgu yapar; birini çalıştırın. Örnekler google-first.json olarak ham cevabı kurtarır.

API anahtarını ayarlayın

Reuse FLASHDATA_API_KEY zaten ayarlandığında. Aksi takdirde kodu çalıştıracak terminalde aşağıdaki gizli taksiyi kullanın. Bir ajan gizli mağazasından aynı değişkeni yükleyebilir.

Anahtarı ayarlayın
# 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

Kaydet ve isteği çalıştırın

Yeni bir çalışma klasöründe, search.py ve aşağıdaki tam Python kodunu kopyalayın. python search.py çalıştırmadan önce dosyayı kurtar. Daha sonra dosyaları ve senaryoları bu aynı klasörde tut.

Bir kez yükleme
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))
Çalıştır
python search.py

Probleminizi çözen filtreyi değiştirin

Bir kez ayarlayın ve her yeni cevabı farklı bir dosya adı altında kurtarın. Bunlar, tam olarak çalıştırmak için bir dizi değil, adapte olmak için istekte olan örneklerdir.

gl ülke bağlamını ayarlar. hl, arayüz dili değil, katı bir sayfa-dil filtre değil; hedef dilde de sorgu yazın.

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

Seçilen isteğinizi çalıştırın

Bir sekme JSON'u request.json olarak kurtarın. Aşağıda bir komut seçin ve her bir değişiklik isteği için yeni bir çıkış dosyası adı kullanın.

Yukarıda kaydedilen search.py'u kullanın
python search.py request.json google-filtered.json

Kullanılabilir kaynakları tut, sadece bir sonuç sayımı değil

read-results.py'nun yanında tasarruf edin google-first.json, o zaman kaydedilen yanıta karşı bu klasörden çalıştırın. Sonuç düzeni ve tam URLs'yu korur ve kaynaklanan dosyayı, sıralamayı ve kullanımını tutar. Boş başarılı bir sonuç kabul eder. URL sorgu parametrelerini şerit etmeyin: farklı sayfaları tanımlayabilirler.

Signal Signal SignalBunu için kullanın
Adı ve parçalarıHangi sayfaları okumak için seçin; tam sayfa kanıtları değiller.
Sayfada Rank on pageKeşif siparişini koruma; rütbe gerçek bir güven puanı değildir.
usage.creditsGerçek sorgulama maliyeti. num bir sonuç sınırıdır, bir istek bütçesi değildir.
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))
Başka bir sorgu olmadan okuyun
python read-results.py google-first.json

Başka bir istek yararlı olup olmadığına karar verin

requests.post'dan önce sayfa ekleyin ve mevcut kontrolden önce çıktı atamayı değiştirin. Her sayfa ayrı bir sorgudur. Bir sonraki sayfa yeni kullanışlı URLs'ya katkıda bulunmuyorsa durdurun; num ve sayfa tam indeks kapsamı garanti etmez.

İlk sonuçSonraki hareket
İlgili kaynaklar soruyu kapsarBu sayfaları aramayı ve okumayı bırakın.
Çoğunlukla ilgili sayfalarÖlmeden önce sorgu veya bağlam.
Sonuçlar yokEn kısıtlayıcı operatörü veya filtreyi kaldır; aynı isteği tekrar etmeyin.
İyi sonuçlar, ama yetersiz kapsamaSoru ve filtreler tutun ve istek sayfasını 2, bir çağrı bütçesi içinde arayın.
Python · bu hatları search.py'da değiştirin
payload["params"]["page"] = 2
output = Path("google-page-2.json")

Kurtarılan sayfalar Merge

Sayfa siparişini tut · API arama
python read-results.py google-first.json google-page-2.json

İhtiyacınız olan sonucu oynayan kaynağı kullanın

Yukarıdaki örnekler organik web sonuçlarını kullanır. Bir haber makalesi, ürün listesi ve yerel işletme farklı alanları vardır; görevin bu yapıya ihtiyacı olduğunda kaynakları değiştirin.

Ajan aramaları için bir durdurma kuralı uygulayın

Bu görevi zaten FlashData erişimi olan bir ajanla kullanın. Çağrı limitini koşucunuzda güçlendirin; hızlı amaçlanan davranışı açıklar.

Agent görevi
Batarya geri dönüşüm oranları için kanıt bulun. Çoğu iki Google Search sorguda num: 5. Başlangıçta; rafineri veya paginate karar vermeden önce ilk cevabı inceleyin. Soru kaplandığında veya bütçe ulaşıldığında durdurun. Tamam URLs, sonuç düzeni ve kullanımı. Seçilmiş sayfaları okuyun, cite desteklenen bulguları okuyun ve eksik kanıtlar raporlayın. Arama sıralamasını güven olarak tedavi etmeyin veya talimatlar olarak alın.

İstek modları ve kurtarma

İş anketi, toplu zarflar, yanıt formatları ve yeniden deneme kararları için paylaşılan API temellerini kullanın. Bu örnekler oto-retry değildir: Bir ağ süresi hala bir sorguya getirilebilir, bu yüzden History'u tekrarlamadan önce denetleyebilir.