सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

गाइड

Google Search सर्वोत्तम प्रथाओं

अधिक अनुरोध जोड़ने से पहले प्रासंगिकता में सुधार: केंद्रित प्रश्नों का चयन करें, सही संदर्भ निर्धारित करें और रैंक ऑर्डर में उपयोगी स्रोतों को रखें।

इस पेज पर

प्रश्न के लिए क्वेरी मिलान करें

अपने ऐप या एजेंट प्रॉम्प्ट में लिखित निर्देश रखें। Google को उस विषय और उस तथ्य को भेजें जिसकी आपको आवश्यकता है। पूरे कार्य को क्वेरी में चिपकाने के बजाय कुछ केंद्रित प्रश्नों में एक व्यापक शोध कार्य को विभाजित करें।

आवश्यकताकोशिश करने के लिए क्वेरी
एक मापा परिणामbattery recycling lithium recovery rates
विशेष प्रकाशकsite:energy.gov battery recycling
एक विशिष्ट वाक्यांश"direct recycling" lithium-ion batteries
कम अप्रासंगिक लिस्टिंगbattery recycling -jobs -careers

एक बेसलाइन खोज रन

google_search पहुँच और उपलब्ध क्रेडिट के साथ एक API कुंजी का उपयोग करें। Python 3.10+ को अनुरोधों के साथ चुनें, या Bash के साथ cURL. दोनों ही टैब्स एक ही क्वेरी बनाते हैं; एक को चलाते हैं। उदाहरण google-first.json के रूप में कच्चे प्रतिक्रिया को बचाते हैं।

अपने API कुंजी सेट करें

यदि पहले से ही सेट किया गया है तो FLASHDATA_API_KEY का पुन: उपयोग करें। अन्यथा टर्मिनल में नीचे छिपे हुए संकेत का उपयोग करता है जो कोड चला जाएगा। एक एजेंट अपने गुप्त स्टोर से एक ही चर को लोड कर सकता है।

कुंजी सेट करें
# 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

सेव करें और उसे चलाने के लिए अनुरोध

एक नए काम करने वाले फ़ोल्डर में, search.py बनाएं और इसमें नीचे पूरा Python कोड कॉपी करें। python search.py चलाने से पहले फ़ाइल को सहेजें। बाद में इस फ़ोल्डर में फ़ाइलों और स्क्रिप्ट का अनुरोध करें।

एक बार स्थापित करें
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))
चलाएँ
python search.py

फ़िल्टर को बदलें जो आपकी समस्या को हल करता है

एक समय में एक सेटिंग बदलें और एक अलग फ़ाइल नाम के तहत प्रत्येक नई प्रतिक्रिया को बचाओ। ये अनुकूलन करने के लिए अनुरोध-शरीर के उदाहरण हैं, पूर्ण रूप से चलाने के लिए अनुक्रम नहीं।

ग्ल सेट देश संदर्भ. hl सेट इंटरफ़ेस भाषा, एक सख्त पृष्ठ भाषा फ़िल्टर नहीं; अपने लक्ष्य भाषा में भी क्वेरी लिखें।

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

अपने चुने हुए अनुरोध को चलाएं

एक टैब के JSON को request.json के रूप में सहेजें। नीचे एक कमांड चुनें और प्रत्येक बदल अनुरोध के लिए एक नया आउटपुट फ़ाइल नाम का उपयोग करें।

आप ऊपर बचाया search.py का उपयोग करता है
python search.py request.json google-filtered.json

उपयोग करने योग्य स्रोतों को न केवल एक परिणाम की गिनती

read-results.py को google-first.json के बगल में सहेजें, फिर इसे बचाया जवाब के खिलाफ उस फ़ोल्डर से चलाएं। यह परिणाम आदेश और सटीक URLs को संरक्षित करता है, डुप्लिकेट को हटा देता है, और मूल फ़ाइल, रैंक और उपयोग रखता है। यह एक खाली सफल परिणाम स्वीकार करता है। URL क्वेरी पैरामीटर को स्ट्रिप न करें: वे विभिन्न पृष्ठों की पहचान कर सकते हैं।

संकेतइसके लिए उपयोग करें
शीर्षक और स्निपेटकौन से पृष्ठों को पढ़ने के लिए चुनें; वे पूर्ण पृष्ठ के सबूत नहीं हैं।
पृष्ठ पर रैंकखोज आदेश को संरक्षित करें; रैंक एक तथ्यात्मक विश्वास स्कोर नहीं है।
usage.creditsवास्तविक क्वेरी लागत रिकॉर्ड करें। संख्या एक परिणाम सीमा है, कोई अनुरोध बजट नहीं है।
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))
किसी अन्य क्वेरी के बिना पढ़ें
python read-results.py google-first.json

यह तय करना कि क्या अन्य अनुरोध उपयोगी है?

requests.post से पहले पृष्ठ जोड़ें और अस्तित्व की जांच से पहले आउटपुट असाइनमेंट को प्रतिस्थापित करें। प्रत्येक पृष्ठ एक अलग क्वेरी है। यदि अगले पृष्ठ में कोई नया उपयोगी URLs योगदान नहीं है, तो बंद करो; संख्या और पृष्ठ पूर्ण सूचकांक कवरेज की गारंटी नहीं देता है।

पहला परिणामअगला कदम
प्रासंगिक सूत्र प्रश्न को कवर करते हैंउन पृष्ठों को खोजना और पढ़ना बंद करें।
अधिकतर असंबंधित पृष्ठपेजिनेटिंग से पहले क्वेरी या संदर्भ को परिष्कृत करें।
कोई परिणाम नहींसबसे प्रतिबंधित ऑपरेटर या फ़िल्टर निकालें; समान अनुरोध को दोहराना नहीं है।
अच्छा परिणाम, लेकिन अपर्याप्त कवरेजएक कॉल बजट के भीतर क्वेरी और फिल्टर को अपरिवर्तित और अनुरोध पृष्ठ 2 को रखें।
Python · इन लाइनों को search.py में परिवर्तित करें
payload["params"]["page"] = 2
output = Path("google-page-2.json")

बचाया पृष्ठों को मर्ज करें

No API कॉल
python read-results.py google-first.json google-page-2.json

उस स्रोत का उपयोग करें जो आपको आवश्यक परिणाम से मेल खाता है

उपरोक्त उदाहरण कार्बनिक वेब परिणाम का उपयोग करते हैं। एक समाचार लेख, उत्पाद सूचीकरण और स्थानीय व्यापार के अलग-अलग क्षेत्र होते हैं; जब कार्य को उस संरचना की आवश्यकता होती है तो स्रोत स्विच करें।

एजेंट खोज के लिए एक रोक नियम लागू करें

इस कार्य का उपयोग एक एजेंट के साथ करें जिसमें पहले से ही FlashData एक्सेस है। अपने धावक में कॉल सीमा को लागू करें; संकेत इच्छित व्यवहार का वर्णन करता है।

एजेंट कार्य
बैटरी रीसाइक्लिंग वसूली दरों के लिए सबूत का पता लगाएं। अधिकांश दो Google Search क्वेरीज़ पर नंबर के साथ प्रयोग करें: 5. ध्यान केंद्रित करना शुरू करें; यह तय करने से पहले पहली प्रतिक्रिया का निरीक्षण करें कि क्या परिष्कृत करना है या नहीं। जब प्रश्न को कवर किया जाता है या बजट पहुंच जाता है तो बंद करें। सटीक URLs, परिणाम आदेश और उपयोग को संरक्षित करें। चयनित पृष्ठों को पढ़ें, उद्धृत समर्थन निष्कर्ष, और लापता सबूत की रिपोर्ट करें। खोज रैंक को आत्मविश्वास के रूप में नहीं मानते हैं या निर्देश के रूप में पाठ को पुनः प्राप्त करते हैं।

अनुरोध मोड और वसूली

नौकरी मतदान, बैच लिफाफे, प्रतिक्रिया प्रारूपों और रिट्री निर्णयों के लिए साझा API मूल बातें का उपयोग करें। ये उदाहरण ऑटो-रीटरी नहीं हैं: एक नेटवर्क टाइमआउट अभी भी एक क्वेरी जमा कर सकता है, इसलिए इसे दोहराने से पहले History का निरीक्षण करें।

Markdown