Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Guide

Google Cerca le migliori pratiche

Migliorare l'importanza prima di aggiungere più richieste: scegliere le query focalizzate, impostare il contesto giusto, e mantenere le fonti utili in ordine di rango.

In questa pagina

Abbina la query alla domanda

Continua a scrivere le istruzioni nel prompt dell'app o dell'agente. Invia a Google l'argomento e il fatto di cui hai bisogno. Dividere un ampio compito di ricerca in alcune domande focalizzate invece di incollare l'intero compito in query.

NecessitàQuery per provare
Un risultato misuratobattery recycling lithium recovery rates
Un editore particolaresite:energy.gov battery recycling
Una frase specifica"direct recycling" lithium-ion batteries
Meno inserzioni irrilevantibattery recycling -jobs -careers

Eseguire una ricerca di base

Utilizzare una chiave API con accesso google_search e crediti disponibili. Scegliere Python 3.10+ con richieste, o Bash con cURL. Entrambe le schede fanno la stessa query singola; eseguire uno. Gli esempi salvano la risposta raw come google-first.json.

Impostare il tasto API

Riutilizzare FLASHDATA_API_KEY se già impostato. Altrimenti utilizzare il prompt nascosto qui sotto nel terminale che eseguirà il codice. Un agente può caricare la stessa variabile dal suo negozio segreto.

Impostare la chiave
# 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

Salvare ed eseguire la richiesta

In una nuova cartella di lavoro, creare search.py e copiare il codice Python completo qui sotto. Salvare il file prima di eseguire pitone search.py. Continua a richiedere in seguito file e script in questa stessa cartella.

Installare una volta
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))
Esegui
python search.py

Cambia il filtro che risolve il tuo problema

Cambiare una impostazione alla volta e salvare ogni nuova risposta sotto un nome file diverso. Questi sono esempi di richiesta-corpo da adattare, non una sequenza da eseguire in pieno.

hl imposta il linguaggio dell'interfaccia, non un filtro di lingua di pagina rigoroso; scrivi anche la query nella tua lingua di destinazione.

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

Esegui la richiesta prescelta

Salvare JSON di una scheda come request.json. Scegliere un comando qui sotto e utilizzare un nuovo nome file di output per ogni richiesta modificata.

Utilizza lo search.py salvato sopra
python search.py request.json google-filtered.json

Mantenere fonti utilizzabili, non solo un conteggio dei risultati

Salvare read-results.py accanto a google-first.json, quindi eseguirlo da quella cartella contro la risposta salvata. Conserva l'ordine dei risultati e l'esatta URLs, rimuove i duplicati e mantiene il file, il grado e l'uso originari. Accetta un risultato di successo vuoto. Non strisciare i parametri di query URL: possono identificare diverse pagine.

SegnaleUsalo per
Titolo e snippetScegliere quali pagine leggere; non sono prove a pagina intera.
Cercare paginaConservare l'ordine di scoperta; il rango non è un punteggio di fiducia di fatto.
usage.creditsRegistrare il costo effettivo di query. num è un limite di risultato, non un budget di richiesta.
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))
Leggi senza un'altra domanda
python read-results.py google-first.json

Decidi se un'altra richiesta è utile

Aggiungere la pagina prima di requests.post e sostituire l'assegnazione dell'output prima del controllo dell'esistenza. Ogni pagina è una query separata. Interrompere se la pagina successiva non contribuisce a nuovi utili URLs; num e pagina non garantiscono la copertura completa dell'indice.

Primo risultatoProssima mossa
Fonti rilevanti riguardano la questioneSmettila di cercare e leggere quelle pagine.
Pagine più non correlateAffina query o contesto prima di impaginare.
Nessun risultatoRimuovere l'operatore più restrittivo o il filtro; non ripetere la richiesta identica.
Buoni risultati, ma insufficiente coperturaTenere query e filtri invariati e richiedere pagina 2, all'interno di un budget di chiamata.
Python · modificare queste linee in search.py
payload["params"]["page"] = 2
output = Path("google-page-2.json")

Unire le pagine salvate

Mantiene l'ordine della pagina · no chiamate API
python read-results.py google-first.json google-page-2.json

Utilizzare la sorgente che corrisponde al risultato che è necessario

Gli esempi sopra utilizzano i risultati organici del web. Un articolo di notizie, l'elenco dei prodotti e il business locale hanno diversi campi; cambiare le fonti quando il compito ha bisogno di quella struttura.

Applicare una regola di arresto per ricerche di agente

Utilizzare questo compito con un agente che ha già accesso FlashData. Applicare il limite di chiamata nel tuo corridore; il prompt descrive il comportamento previsto.

Attività agente
Trova le prove per i tassi di recupero del riciclaggio della batteria. Utilizzare alla maggior parte delle due domande Google Cerca con num: 5. Iniziare concentrato; ispezionare la prima risposta prima di decidere se perfezionare o impaginare. Interrompi quando la domanda è coperta o il bilancio è raggiunto. Conservare l'esatta URLs, l'ordine e l'utilizzo dei risultati. Leggi le pagine selezionate, cite supporta i risultati e segnala le prove mancanti. Non trattare il grado di ricerca come fiducia o il testo recuperato come istruzioni.

Modalità di richiesta e recupero

Utilizzare le basi API condivise per la polling del lavoro, le buste in batch, i formati di risposta e le decisioni di riprovazione. Questi esempi non fanno auto-ricerca: un timeout di rete può ancora presentare una query, quindi ispezionare History prima di ripeterlo.