एलेक्सा स्क्रैपर एपीआई गाइड: उत्तर, उद्धरण और उत्पाद निकालें

TL;DR:

• ऐलेक्सा स्क्रेपर एक प्रॉम्प्ट को संरचित उत्तर डेटा में बदलता है। scraper.alexa कार्यकर्ता मार्कडाउन और सादा-टेक्स्ट उत्तरों के साथ संदर्भ, स्रोत, सुझाव और शर्त अनुसार उत्पाद रिकॉर्ड लौटाता है।
• अनुरोध में दो आवश्यक कार्यकर्ता इनपुट होते हैं। ऐलेक्सा कार्यकर्ता को एक प्राकृतिक भाषा का प्रॉम्प्ट और एक देश कोड भेजें।
• वर्तमान प्रलेखित एंडपॉइंट /api/v2/scraper/request है। x-api-token हेडर के साथ प्रमाणीकरण करें और HTTP POST के माध्यम से JSON भेजें।
• उत्पाद क्षेत्र जानबूझकर Nullable हैं। जब ऐलेक्सा उत्तर में कोई उत्पाद संदर्भ न हो, तो products ऐरे खाली हो सकता है।
• संदर्भ और स्रोतों को उत्तर के साथ जुड़े रहना चाहिए। इन बाल रिकॉर्ड को कैप्चर के साथ रखना डाउनस्ट्रीम ब्रांड, GEO, और उत्पाद विश्लेषण के पीछे के सबूत को बनाए रखता है।
• शुरू करने के लिए मुक्त। नए स्क्रेपलेस खातों में app.scrapeless.com पर एक मुफ्त योजना तक पहुंच शामिल है।

परिचय: ऐलेक्सा उत्तरों को एक स्थिर डेटा इंटरफेस की आवश्यकता है

एक ऐलेक्सा उत्तर में एक वाक्य से अधिक होता है। इसमें मार्कडाउन, सादा टेक्स्ट, संदर्भ, स्रोत लिंक, सुझाए गए फॉलो-अप प्रश्न, वार्तालाप पहचानकर्ता, प्रसंस्करण निर्देश और उत्पाद रिकॉर्ड हो सकते हैं। दृश्य उत्तर की नकल करने से उस संरचना का बहुत कुछ खो जाता है।

स्क्रेपलेस ऐलेक्सा स्क्रेपर उत्तर को scraper.alexa कार्यकर्ता के माध्यम से उजागर करता है। एक ग्राहक प्रॉम्प्ट और देश भेजता है, और कार्यकर्ता ऐसे क्षेत्र लौटाता है जिन्हें बिना किसी वॉयस-असिस्टेंट इंटरफेस को पार्स किए स्टोर किया जा सकता है। इससे GEO निगरानी, उत्तर-गुणवत्ता समीक्षा, स्रोत विश्लेषण, और उत्पाद दृश्यता के काम के लिए एक ही अनुरोध आकार उपयोगी हो जाता है।

यह गाइड वर्तमान ऐलेक्सा स्क्रेपर प्रलेखन का उपयोग करती है। यह एंडपॉइंट, प्रमाणीकरण, अनुरोध पैरामीटर, प्रतिक्रिया क्षेत्रों, एक cURL अनुरोध, एक पायथन ग्राहक, और संरचित आउटपुट के लिए एक भंडारण पैटर्न को कवर करती है।

आप ऐलेक्सा स्क्रेपर के साथ क्या कर सकते हैं

ऐलेक्सा स्क्रेपर उन कार्य प्रक्रियाओं का समर्थन करता है जिन्हें उत्तर और उसके चारों ओर के सबूत को एक रिकॉर्ड में देखने की आवश्यकता होती है।

• उत्तर पाठ कैप्चर करें। प्रस्तुत सामग्री के लिए md_text और सादा-टेक्स्ट प्रसंस्करण के लिए raw_text स्टोर करें।
• उद्धरणों का निरीक्षण करें। references से संदर्भ आईडी, शीर्षक, और URL पढ़ें।
• स्रोत लिंक मानचित्रित करें। sources से स्रोत प्रदर्शन पाठ, URL, प्रकार, और लघु URI स्टोर करें।
• फॉलो-अप प्रॉम्प्ट खोजें। suggestions में ऐलेक्सा द्वारा प्रस्तुत पाठ और संदेश मान एकत्र करें।
• प्रतिक्रिया संदर्भ को ट्रैक करें। पूर्णता स्थिति, उत्तर संशोधन, संवाद अनुरोध आईडी, एंडपॉइंट आईडी, लघु संख्या, और वार्तालाप आईडी को बनाए रखें।
• उत्पाद प्रस्तुति का विश्लेषण करें। जब उत्पाद डेटा लागू होता है, तो उत्पाद पहचानकर्ताओं, उद्धरण लिंक, शीर्षक, छवियां, URLs, मूल्य, डिलीवरी पाठ, विवरण, और उद्देश्य पढ़ें।

कार्यकर्ता कैप्चर डेटा लौटाता है। उल्लेख दर, स्रोत सघनता, उत्तर सहितता, और उत्पाद उपस्थिति दर जैसे मेट्रिक्स डेटा का उपयोग करने वाली टीम द्वारा परिभाषित डाउनस्ट्रीम गणनाएं हैं।

क्यों स्क्रेपलेस ऐलेक्सा स्क्रेपर

स्क्रेपलेस ऐलेक्सा स्क्रेपर विभिन्न बाजारों में ऐलेक्सा प्रतिक्रियाओं को कैप्चर करने के लिए एक प्रलेखित कार्यकर्ता इंटरफेस प्रदान करता है।

क्रियान्वयन का मूल्य उत्तर के आकार से आता है:

• उत्तर पाठ मार्कडाउन और सादा-टेक्स्ट प्रारूपों में आता है।
• उद्धरणों और स्रोत लिंक को केवल गद्य में एम्बेडेड लिंक के बजाय अलग ऐरे के रूप में प्रस्तुत किया गया है।
• सुझाए गए प्रॉम्प्ट को संरचित रिकॉर्ड के रूप में लौटाया जाता है।
• उत्पाद जानकारी एक शर्त अनुसार ऐरे के रूप में उपलब्ध है।
• देश मार्केट-विशिष्ट कैप्चर के लिए स्पष्ट अनुरोध इनपुट है।
• ट्रेसबिलिटी के लिए वार्तालाप और उत्तर पहचानों को बनाए रखा जा सकता है।

स्क्रेपलेस LLM चैट स्क्रेपर यूनिवर्सल स्क्रेपिंग API लाइन का एक हिस्सा है। यूनिवर्सल स्क्रेपिंग API उत्पाद पृष्ठ उत्पाद का घर है, और वर्तमान योजना विवरण स्क्रेपलेस मूल्य निर्धारण पृष्ठ पर सूचीबद्ध हैं।

पूर्वापेक्षाएँ

आपको आवश्यकता है:

• app.scrapeless.com से एक स्क्रेपलेस खाता और API कुंजी
• शेल उदाहरण के लिए cURL
• पायथन और पायथन उदाहरण के लिए requests पैकेज
• उस बाजार के लिए एक समर्थित देश कोड जिसे आप कैप्चर करना चाहते हैं

country इनपुट एक छोटे देश कोड का उपयोग करता है। ISO 3166 देश-कोड मानक सामान्य अल्फा-2 प्रारूप को स्पष्ट करता है; विशिष्ट कोड के लिए उत्पाद उपलब्धता की पुष्टि करने के लिए स्क्रेपलेस समर्थित-देश सूची का उपयोग करें।

नोट: नीचे दिए गए प्रमाणित अनुरोधों के लिए एक वास्तविक Scrapeless API कुंजी और पहुँच योग्य वेबहुक की आवश्यकता होती है। इन क्रेडेंशियल के बिना, ब्लॉकों को सिंटैक्स-जांच किया जा सकता है, लेकिन लाइव एलेक्सा परिणाम उत्पन्न नहीं कर सकते।

एलेक्सा स्क्रैपर एपीआई कैसे काम करता है

एलेक्सा स्क्रैपर अनुरोध एक HTTP POST है जो अभिनेता का नाम देता है, प्रॉम्प्ट और देश प्रदान करता है, और एक वेबहुक गंतव्य प्रदान करता है।

वर्तमान में प्रलेखित एंडपॉइंट है:

https://api.scrapeless.com/api/v2/scraper/request

HTTP अनुरोध विधियों और हेडर फ़ील्ड को HTTP अर्थशास्त्र मानक के माध्यम से परिभाषित करता है। इस अनुरोध में, Content-Type: application/json शरीर के प्रारूप का वर्णन करता है और x-api-token Scrapeless API कुंजी ले जाता है।

इस API कुंजी को स्रोत कोड के बजाय एक रहस्य भंडार या सुरक्षित परिवर्ती में रखें। OWASP रहस्य-प्रबंधन मार्गदर्शिका संग्रहण, घुमाव और पहुंच के लिए व्यावहारिक नियंत्रणों की रूपरेखा तैयार करती है।

अनुरोध पैरामीटर

प्रॉम्प्ट और देश को लौटाए गए उत्तर के साथ उसी डेटाबेस रिकॉर्ड में रखें। ये दो इनपुट अवलोकन को परिभाषित करते हैं और बाद की तुलनाओं को पुनरुत्पादित करते हैं।

cURL के साथ त्वरित कैप्चर

अनुरोध चलाने से पहले शेल में SCRAPELESS_API_KEY और SCRAPELESS_WEBHOOK_URL सेट करें।

नोट: यह ब्लॉक एक क्रेडेंशियल-गेटेड अनुरोध है। इसे एक वास्तविक Scrapeless API कुंजी और एक सार्वजनिक वेबहुक URL की आवश्यकता है।

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
  --header 'Content-Type: application/json' \
  --header "x-api-token: ${SCRAPELESS_API_KEY}" \
  --data-binary @- <<JSON
{
  "actor": "scraper.alexa",
  "input": {
    "prompt": "New York में अनुशंसित आकर्षण",
    "country": "US"
  },
  "webhook": {
    "url": "${SCRAPELESS_WEBHOOK_URL}"
  }
}
JSON

पेलोड JSON है, जिसकी इंटरऑपरेबल व्याकरण RFC 8259 द्वारा परिभाषित है। स्ट्रिंग मानों को उद्धरण में रखें और दर्ज की गई सामग्री के अंदर टिप्पणियों से बचें।

प्रतिक्रिया फ़ील्ड

अभिनेता का परिणाम उत्तर सामग्री, पहचानकर्ताओं, निर्देशों, संदर्भों, स्रोतों, सुझावों और उत्पादों के फ़ील्ड को समूहित करता है।

निम्नलिखित JSON एक विस्तृत आकार है जो प्रलेखित फ़ील्ड सूची से बनाया गया है। मान उदाहरण हैं, न कि एक कैप्चर किए गए अभिनेता के चलने से।

{
  "user_text": "कौन सा कॉफी मेकर एक छोटे रसोई घर के लिए सूट करता है?",
  "md_text": "एक कॉम्पैक्ट कॉफी मेकर को फ़ुटप्रिंट और क्षमता संतुलित करना चाहिए।",
  "raw_text": "एक कॉम्पैक्ट कॉफी मेकर को फ़ुटप्रिंट और क्षमता संतुलित करना चाहिए।",
  "completed": true,
  "answer_revision": 1,
  "conversation": {
    "id": "illustrative-conversation-id"
  },
  "references": [
    {
      "id": "cite_example",
      "title": "विस्तृत खरीदने की गाइड",
      "url": "https://example.com/illustrative-buying-guide"
    }
  ],
  "sources": [
    {
      "text": "विस्तृत स्रोत",
      "url": "https://example.com/illustrative-buying-guide",
      "type": "OpenURL",
      "fragment_uri": "illustrative-source-fragment"
    }
  ],
  "suggestions": [
    {
      "text": "कॉम्पैक्ट मॉडल की तुलना करें",
      "message": "कॉम्पैक्ट कॉफी मेकर की तुलना करें",
      "type": "TextMessage",
      "fragment_uri": "illustrative-suggestion-fragment"
    }
  ],
  "products": []
}

खाली उत्पाद सूची जानबूझकर है। उत्पाद जानकारी वैकल्पिक है, इसलिए पार्सर को एक खाली सूची स्वीकार करनी चाहिए।

अपने API कुंजी को स्वतंत्र योजना पर प्राप्त करें: app.scrapeless.com

पायथन में एलेक्सा स्क्रैपर को एकीकृत करना

एक पायथन क्लाइंट प्रलेखित अनुरोध प्रस्तुत कर सकता है और अनुरोध-कार्यप्रवाह प्रतिक्रिया को प्रिंट कर सकता है। अंतिम एलेक्सा अभिनेता का परिणाम कॉन्फ़िगर किए गए कार्यप्रवाह के माध्यम से वितरित किया जाता है और इसे अनुरोध के बाद दिखाए गए सामान्यीकरण कार्य में पारित किया जाना चाहिए।
इंस्टॉल करें केवल तीसरी पक्ष की निर्भरता। यह सेटअप चरण एक पायथन पैकेज इंडेक्स तक पहुंच की आवश्यकता होती है।

python -m pip install requests

नोट: नीचे वाला अनुरोध ब्लॉक एक क्रेडेंशियल-गेटेड उदाहरण है। इसे SCRAPELESS_API_KEY और SCRAPELESS_WEBHOOK_URL पर्यावरण चर की आवश्यकता होती है।

import os
import requests

API_URL = "https://api.scrapeless.com/api/v2/scraper/request"

api_key = os.environ["SCRAPELESS_API_KEY"]
webhook_url = os.environ["SCRAPELESS_WEBHOOK_URL"]

payload = {
    "actor": "scraper.alexa",
    "input": {
        "prompt": "न्यूयॉर्क में अनुशंसित आकर्षण",
        "country": "US",
    },
    "webhook": {
        "url": webhook_url,
    },
}

response = requests.post(
    API_URL,
    headers={
        "Content-Type": "application/json",
        "x-api-token": api_key,
    },
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())

API कुंजी को एक पर्यावरण चर में रखें। इसे स्रोत नियंत्रण, नोटबुक, स्क्रीनशॉट, या कैप्चर की गई वेबहुक पेलोड में न रखें।

भंडारण के लिए एलेक्सा आउटपुट को सामान्य बनाना

एक सामान्यीकृत एलेक्सा रिकॉर्ड उत्तर को माता स्तर पर रखता है और दोहराने वाले ऐरे को बाल रिकॉर्ड के रूप में संग्रहीत करता है।

एक माता captures तालिका का उपयोग करें जिसमें:

• आंतरिक कैप्चर आईडी
• प्रस्तुत किया गया प्रॉम्प्ट
• प्रस्तुत किया गया देश
• user_text, md_text, और raw_text
• completed और answer_revision
• बातचीत और संवाद पहचानकर्ता
• आपके सिस्टम द्वारा उत्पन्न कैप्चर टाइमस्टैम्प

references, sources, suggestions, directives, और products को अलग तालिकाओं में संग्रहीत करें जो कैप्चर आईडी पर कुजित हों। यह हर स्रोत या उत्पाद के लिए पूर्ण उत्तर को दोहराने से बचाता है।

स्रोत संबंधों को स्पष्ट और क्वेरी करने योग्य रहना चाहिए। अभिनेता पहले से ही उद्धरण आईडी, स्रोत यूआरएल, और फ्रैगमेंट यूआरआई के माध्यम से उन संबंधों का प्रदर्शन करता है। उन्हें संरक्षित करें, बजाय इसके कि उन्हें एक असंरचित पाठ क्षेत्र में समतल किया जाए।

उत्पाद पंक्तियों के लिए, citation_id को तब भी रखें जब यह शून्य हो। जब उपस्थित हो, तो यह उत्पाद को एक प्रलेखित संदर्भ के साथ जोड़ सकता है। जब अनुपस्थित हो, तो शून्य मान सही ढंग से रिकॉर्ड करता है कि उस क्षेत्र में कोई प्रत्यक्ष उद्धरण लिंक नहीं लौटाया गया था।

सामान्य एकीकरण समस्याओं से बचने के लिए

एलेक्सा स्क्रेपर एकीकरण तब तक अनुमानित रहते हैं जब तक कि शून्य करने योग्य फ़ील्ड, देश का दायरा, और उत्तर साक्ष्य को स्पष्ट रूप से संभाला गया हो।

स्थितिगत ऐरे को खाली संग्रह के रूप में मानें

products ऐरे खाली हो सकता है जब उत्पाद की जानकारी लागू नहीं होती है। समान रक्षात्मक पैटर्न references, sources, suggestions, और directives के लिए उपयोगी है: ट्रांसफॉर्मेशन परत में एक गायब या शून्य ऐरे को खाली संग्रह के रूप में पढ़ें, जबकि ऑडिट के लिए मूल पेलोड को बनाए रखें।

मार्कडाउन और सामान्य पाठ को बनाए रखें

md_text और raw_text विभिन्न कार्यों का समर्थन करते हैं। मार्कडाउन दृश्य संरचना को रेंडर और बनाए रखने के लिए उपयोगी है। सामान्य पाठ को टोकनाइज़ करना, तुलना करना, और खोज करना आसान है। दोनों को संग्रहीत करने से बाद की पाइपलाइन को एक प्रारूप को दूसरे से फिर से बनाने से रोकता है।

प्रत्येक रिकॉर्ड में देश को स्थिर करें

डाउनस्ट्रीम भंडारण में डिफ़ॉल्ट मार्केट पर भरोसा न करें। प्रॉम्प्ट और परिणाम के बगल में सही प्रस्तुत किया गया देश सहेजें। मार्केट तुलना विफल होती है जब कैप्चर को अनुरोध संदर्भ में वापस नहीं जोड़ा जा सकता।

समूह के डोमेन द्वारा समूह बनाने से पहले उद्धरण आईडी को बनाए रखें

डोमेन स्तर की रिपोर्टिंग उपयोगी होती है, लेकिन इसे मूल संदर्भ और स्रोत रिकॉर्ड से निकाला जाना चाहिए। समूह के डोमेन फ़ील्ड को जोड़ने से पहले उद्धरण आईडी, शीर्षक, पूर्ण यूआरएल, स्रोत प्रकार, और फ्रैगमेंट यूआरआई को बनाए रखें।

अभिनेता के आउटपुट को व्युत्पन्न स्कोर से अलग करें

अभिनेता उत्तर और संदर्भ क्षेत्रों को लौटाता है। उल्लेख दर, उद्धरण दर, स्रोत विविधता, दावा सटीकता, और उत्पाद उपस्थिति कैप्चर के बाद निर्मित विश्लेषण होते हैं। व्युत्पन्न स्कोर को एक अलग तालिका या नामस्थान में संग्रहीत करें ताकि एक समीक्षक API आउटपुट को टीम की व्याख्या से अलग कर सके।

उत्तर-इंजिन डेटा के लिए सहायक पढ़ाई

एलेक्सा स्क्रेपर एक LLM उत्तर सतह को कवर करता है। गूगल एआई ओवरव्यू स्क्रेपर API गाइड एक खोज-नेतृत्वित उत्तर अनुभव के लिए एक संबंधित अभिनेता पैटर्न को दिखाता है जिसमें उसका अपना फ़ील्ड मॉडल है।

अभिनेताओं के बीच साझा भंडारण अनुबंध केवल उन फ़ील्ड्स के लिए उपयोग करें जो वास्तव में मेल खाते हैं: प्रस्तुत किया गया प्रॉम्प्ट, देश, उत्तर पाठ, स्रोत यूआरएल, कैप्चर आईडी, और कैप्चर समय। अभिनेता-विशिष्ट फ़ील्ड को अपनी तालिकाओं में रखें ताकि उत्पाद फ्रैगमेंट, सुझाव संदेश, और प्लेटफ़ॉर्म पहचानकर्ता एक सबसे सामान्य सीमांकन योजना में गायब न हों।

निष्कर्ष: उत्तर और इसके साक्ष्य को बनाए रखें

एलेक्सा स्क्रेपर एकीकरण का एक छोटा अनुरोध सतह है: अभिनेता, प्रॉम्प्ट, देश, प्रमाणीकरण हेडर, और वेबहुक कार्यप्रवाह। उत्तर मॉडल व्यापक है क्योंकि यह उत्तर, संदर्भ, स्रोत, सुझाव, निर्देश, बातचीत का संदर्भ, और शर्तात्मक उत्पादों को संरक्षित करता है।
कच्चे पे लोड और एक मानकीकृत मूल कैप्चर को संग्रहित करने से शुरू करें। दोहराए गए रिकॉर्ड के लिए चाइल्ड टेबल्स जोड़ें, शून्य मान वाले उत्पाद क्षेत्रों को बनाए रखें, और व्युत्पन्न विश्लेषणों को अभिनेता के परिणामों से अलग रखें। यह संरचना भविष्य के ब्रांड, जीईओ, उत्पाद और बाजार उपयोग के मामलों का समर्थन करती है बिना संग्रहण परत को फिर से लिखे।

क्या आप एलेक्सा स्क्रैपर के साथ निर्माण के लिए तैयार हैं?

हमारे समुदाय में शामिल हों, एक मुफ्त योजना का दावा करें और उन डेवलपर्स के साथ संपर्क करें जो एलएलएम-उत्तर डेटा पाइपलाइनों का निर्माण कर रहे हैं: डिस्कॉर्ड · टेलीग्राम।

app.scrapeless.com पर साइन अप करें और एक प्रॉम्प्ट, एक समर्थित देश, और एक वेबहुक एंडपॉइंट के साथ अभिनेता का परीक्षण करें जिसे आप नियंत्रित करते हैं।

सामान्य प्रश्न

प्रश्न: एलेक्सा स्क्रैपर कौन सा एंडपॉइंट उपयोग करता है?

एलेक्सा स्क्रैपर वर्तमान अभिनेता दस्तावेज़ीकरण में POST https://api.scrapeless.com/api/v2/scraper/request का उपयोग करता है। अनुरोध में scraper.alexa को अभिनेता मान के रूप में उपयोग किया जाता है।

प्रश्न: एलेक्सा स्क्रैपर इनपुट में कौन से अनिवार्य हैं?

अभिनेता को input ऑब्जेक्ट के अंदर एक प्रॉम्प्ट और देश कोड की आवश्यकता होती है। दस्तावेजीकृत अनुरोध उदाहरण में अनुरोध कार्यप्रवाह के लिए एक वेबहुक यूआरएल भी शामिल है।

प्रश्न: md_text और raw_text के बीच अंतर क्या है?

md_text एलेक्सा उत्तर को मार्कडाउन-फॉरमेट में प्रस्तुत करता है, जबकि raw_text सामान्य पाठ उत्तर है। जब पाइपलाइन की सटीक रेंडरिंग और पाठ विश्लेषण की आवश्यकता होती है, तो दोनों को संग्रहित करें।

प्रश्न: क्या एलेक्सा स्क्रैपर हमेशा संदर्भ लौटाता है?

एलेक्सा स्क्रैपर references और sources एरेज़ को उजागर करता है, लेकिन डाउनस्ट्रीम कोड को उन एरेज़ को खाली रखने की अनुमति देनी चाहिए। संदर्भ की उपस्थिति लौटाए गए उत्तर पर निर्भर करती है।

प्रश्न: क्या एलेक्सा स्क्रैपर हमेशा उत्पाद लौटाता है?

नहीं। उत्पाद जानकारी शर्तात्मक है, और जब यह लागू नहीं होता है तो products एरे खाली हो सकता है।

प्रश्न: क्या एलेक्सा स्क्रैपर को बिना पायथन के उपयोग किया जा सकता है?

हां। कोई भी क्लाइंट जो प्रामाणित JSON POST भेज सकता है और अनुरोध कार्यप्रवाह का उत्तर प्राप्त कर सकता है, अभिनेता का उपयोग कर सकता है। cURL उदाहरण सीधे एकीकृत परीक्षण के लिए पर्याप्त है।

प्रश्न: API कुंजी को कैसे संग्रहित किया जाना चाहिए?

Scrapeless API कुंजी को एक वातावरण चर या प्रबंधित गुप्त भंडार में संग्रहित करें। कुंजी को स्रोत नियंत्रण में जमा न करें या इसे वेबहुक लॉग में शामिल न करें।