हर्मेस एजेंट + स्क्रैपलेस MCP: एक वेब-जानकारी AI सहायक बनाएं
Scraping and Proxy Management Expert
TL;DR:
- हर्मेस एजेंट Scrapeless को एक स्थानीय stdio MCP सर्वर के रूप में लोड कर सकता है और प्रारंभ में इसके वेब उपकरण खोज सकता है।
- एक प्रमाणित सेटअप ने हर्मेस के लिए आठ चयनित उपकरणों को उजागर किया जबकि कनेक्शन परीक्षण ने सर्वर पर चौबीस उपकरणों की खोज की।
- उपकरण अलाउलिस्ट एजेंट की दृश्य सतह को खोज, निष्कर्षण, और एक सीमित ब्राउज़र कार्यप्रवाह पर केंद्रित रखती है।
- एक सफल MCP हैंडशेक बहालता और स्कीमा खोज को साबित करता है; लाइव वेब कॉल के लिए एक वैध Scrapeless कुंजी अभी भी आवश्यक है।
हर्मेस एजेंट पहले से ही उपकरणों के बारे में तर्क करना जानता है। उपयोगी एकीकरण प्रश्न संकीर्ण है: यह एजेंट के भीतर ब्राउज़र स्वचालन, खोज, और निष्कर्षण तर्क को बिना दबाए वर्तमान वेब साक्ष्य कैसे प्राप्त कर सकता है?
MCP सीमा प्रदान करता है। हर्मेस ग्राहक के रूप में कार्य करता है। Scrapeless उपकरण सर्वर के रूप में कार्य करता है। मॉडल एक छांटे हुए प्रकार के संचालन का सेट देखता है, और प्रमाण पत्र सर्वर वातावरण में रहते हैं न कि प्रांप्ट के भीतर।
What you can do with Hermes Agent and Scrapeless MCP
कनेक्शन एक व्यावहारिक सेट वेब-सचेत एजेंट नौकरियों का समर्थन करता है:
- गूगल पर खोज करें और संरचित परिणामों को एजेंट को वापस भेजें;
- अनुसंधान या संक्षिप्तता के लिए पृष्ठ सामग्री को Markdown के रूप में निकाले;
- जावास्क्रिप्ट-भारी पृष्ठों के लिए एक क्लाउड ब्राउज़र सत्र बनाएं;
- नेविगेट करें, इंटरएक्टिव तत्वों का निरीक्षण करें, क्लिक करें, टाइप करें, और दृश्य पाठ पढ़ें;
- वेब संचालन को मॉडल की व्याख्या से अलग रखें।
हर्मेस MCP उपकरणों को इसके नैतिक उपकरणों के साथ पंजीकृत करता है। इसका MCP गाइड स्थानीय stdio और दूरस्थ HTTP सर्वरों, स्वचालित खोज, और प्रति-सर्वर फ़िल्टरिंग का दस्तावेज करता है। इसका मतलब है कि एक सर्वर के लिए कोई कस्टम हर्मेस प्लगइन की आवश्यकता नहीं है जो पहले से MCP बोलता है।
Scrapeless MCP सर्वर का उपयोग क्यों करें?
एक सामान्य HTTP फेच स्थैतिक पृष्ठों के लिए काम करता है। एक एजेंट जो जीवित वेब पर शोध करता है, वह जल्द ही उन पृष्ठों का सामना करता है जो जावास्क्रिप्ट, इंटरएक्टिव नियंत्रणों, स्थान, या एक बनाए रखा सत्र पर निर्भर करते हैं। Scrapeless सर्वर खोज, निष्कर्षण, क्रॉलिंग, और ब्राउज़र क्रियाओं को एक MCP कनेक्शन के पीछे समूहित करता है।
आधिकारिक Scrapeless MCP Server रिपॉजिटरी stdio और स्ट्रीम करने योग्य HTTP परिवहन का दस्तावेज करता है। इस गाइड में stdio का उपयोग किया गया है क्योंकि यह हर्मेस को एक स्थानीय बाल प्रक्रिया देता है जिसमें स्पष्ट जीवनचक्र और छोटा कॉन्फ़िगरेशन फुटप्रिंट होता है।
CDP के माध्यम से सीधे ब्राउज़र कनेक्शन के लिए, MCP के बजाय अलग हर्मेस एजेंट और स्क्रैपिंग ब्राउज़र गाइड का उपयोग करें। दोनों दृष्टिकोण विभिन्न एकीकरण समस्याओं को हल करते हैं: CDP एक ब्राउज़र कनेक्शन का खुलासा करता है; MCP उन प्रकार के उपकरणों को उजागर करता है जिन्हें हर्मेस खोज और फ़िल्टर कर सकता है।
Prerequisites
हर्मेस कॉन्फ़िगरेशन को संपादित करने से पहले इन्हें तैयार करें:
- हर्मेस चलाने वाली मशीन पर Git, Node.js, और
npx; - वर्तमान हर्मेस रिलीज द्वारा समर्थित संस्करण रेंज में पायथन;
- एक Scrapeless खाता और API कुंजी;
- एक टर्मिनल जहां
hermesअपेक्षित स्थापना पर हल करता है।
API कुंजी को Markdown, शेल इतिहास, और एजेंट प्रांप्ट से बाहर रखें। Scrapeless दस्तावेज़ीकरण बताता है कि क्रेडेंशियल्स बनाने और प्रबंधित करने के लिए कहाँ जाना है।
Connect Hermes Agent to Scrapeless MCP
Install Hermes with MCP support
मानक हर्मेस इंस्टॉलर पहले से ही MCP समर्थन शामिल करता है। एक पृथक स्रोत स्थापना के लिए, निम्नलिखित अनुक्रम उपयोगी है क्योंकि यह चेकआउट और वर्चुअल वातावरण को एक निर्देशिका में पिन करता है।
bash
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
python3.12 -m venv .venv
./.venv/bin/pip install -e '.[mcp]'
./.venv/bin/hermes --version
यह अनुक्रम हर्मेस एजेंट v0.20.5 के खिलाफ पायथन 3.12.13 के साथ चलाया गया था। आधिकारिक स्थापना गाइड सामान्य अंतिम उपयोगकर्ता स्थापना के लिए पसंदीदा रास्ता बना रहता है क्योंकि यह लॉन्चर और सहायक निर्भरताओं का प्रबंधन करता है।
Configure the stdio server
सक्रिय हर्मेस config.yaml में mcp_servers के तहत एक scrapeless प्रविष्टि जोड़ें। हर्मेस शुरू करने से पहले वास्तविक कुंजी के साथ पूर्वापेक्षा मूल्य को पर्यावरण में बदलें।
yaml
mcp_servers:
scrapeless:
command: npx
args: ["-y", "scrapeless-mcp-server"]
env:
SCRAPELESS_KEY: "${SCRAPELESS_KEY}"
enabled: true
tools:
include:
- google_search
- scrape_markdown
- browser_create
- browser_goto
- browser_snapshot
- browser_click
- browser_get_text
- browser_close
resources: false
prompts: false
command, args, env, और tools कुंजी हर्मेस MCP कॉन्फ़िगरेशन संदर्भ का पालन करती हैं। अलाउलिस्ट जानबूझकर है। यह एक शोध सहायक को खोज, पठनीय निष्कर्षण, और एक सीमित ब्राउज़र लूप देता है बिना हर उपलब्ध संचालन को उजागर किए।
Scrapeless के साथ स्क्रैपिंग प्रारंभ करें
अपने वेब स्क्रैपिंग और स्वचालन कार्यप्रवाह को Scrapeless के साथ पावर अप करें!
आज ही साइन अप करें और $5 का मुफ्त क्रेडिट प्राप्त करें — कोई क्रेडिट कार्ड आवश्यक नहीं।
अपने मुफ्त क्रेडिट को Scrapeless Dashboard में अब ही दावा करें।
कनेक्शन और उपकरण खोज की पुष्टि करें
Hermes एक कनेक्शन परीक्षण शामिल करता है जो कॉन्फ़िगर की गई सर्वर को शुरू करता है, MCP हैंडशेक करता है, और खोजे गए उपकरणों की सूची बनाता है।
bash
hermes mcp list
hermes mcp test scrapeless
पुष्ट रन ने यह संक्षेप रिपोर्ट किया:
text
scrapeless node ... 8 selected enabled
Connected
Tools discovered: 24
दो गिनतियाँ भिन्न सतहों का वर्णन करती हैं। “आठ चयनित” वह अनुमति सूची है जो Hermes कॉन्फ़िगरेशन में संग्रहीत है। “चौबीस खोजे गए” वह पूरी उपकरण सूची है जो कनेक्शन परीक्षण के दौरान वापस आई। रन टाइम में, अनुमति सूची वह सतह है जो मॉडल के लिए निर्धारित है।
उपकरण के नाम Hermes में एक MCP नामस्थान के साथ प्रकट होते हैं जो सर्वर और स्थानीय उपकरण की पहचान करता है। सटीक प्रारूपण Hermes द्वारा संभाला जाता है; tools.include में सर्वर-स्थानीय नाम google_search, scrape_markdown, और ब्राउज़र संचालन नामों पर बने रहते हैं। अंतर्निहित प्रोटोकॉल विनिमय मॉडल कॉन्टेक्स्ट प्रोटोकॉल विशिष्टता का पालन करता है।
यदि Hermes चल रहा है जबकि कॉन्फ़िगरेशन बदलता है, तो सत्र के भीतर /reload-mcp का उपयोग करें। कनेक्शन परीक्षण और प्रमाण पत्र परीक्षण अलग हैं। हैंडशेक वैध योजनाओं के साथ सफल हो सकता है भले ही बाद की वेब कॉल प्रमाणीकृत नहीं हो सके, इसलिए असली कुंजी लोड करने के बाद एक केवल पढ़ने के लिए खोज करें।
आप वास्तव में इसका उपयोग कैसे करते हैं: अपने एजेंट को प्रॉम्प्ट करें
सर्वश्रेष्ठ प्रॉम्प्ट्स साक्ष्य मानक और अनुमत उपकरण पथ का वर्णन करते हैं, न कि क्लिक की एक भंगुर अनुक्रम की।
प्रॉम्प्ट जिसे आप पेस्ट कर सकते हैं
नामित परियोजना की वर्तमान स्थापना आवश्यकताओं के लिए वेब पर खोजें। आधिकारिक दस्तावेज़ परिणाम खोलें, प्रासंगिक अनुभाग को Markdown के रूप में निकालें, और एक संक्षिप्त चेकलिस्ट लौटाएं। स्रोत URL का उल्लेख करें और दस्तावेज़ित तथ्यों को आपकी व्याख्या से अलग करें। लिखने की क्षमता वाले उपकरणों का उपयोग न करें।
यह प्रॉम्प्ट Hermes को उपकरणों का चयन करने के लिए जगह देता है जबकि जांच करने योग्य परिणाम को बनाए रखता है। खोज आधिकारिक पृष्ठ का पता लगाती है। Markdown निकासी पढ़ने योग्य साक्ष्य प्रदान करती है। उत्तर में URL होता है और किसी भी व्याख्या को लेबल करता है।
एक ब्राउज़र-समर्थित प्रॉम्प्ट
सार्वजनिक उत्पाद पृष्ठ खोलें, इंटरैक्टिव पृष्ठ संरचना का निरीक्षण करें, और दृश्य योजनाओं के नाम और उनके प्रदर्शित इकाइयों की रिपोर्ट करें। साइन इन न करें, फ़ॉर्म सबमिट न करें, या खरीद नियंत्रण पर क्लिक न करें। अंतिम पृष्ठ का URL शामिल करें और केवल तालिका का समर्थन करने के लिए आवश्यक न्यूनतम पाठ तक उद्धरण करें।
यह संस्करण परिणामदायी कार्यों के चारों ओर नकारात्मक बाधाएँ स्थापित करता है। अनुमति सूची भी मदद करती है: कोई फ़ॉर्म सबमिशन उपकरण तब तक दिखाई नहीं देता जब तक चयनित ब्राउज़र संचालन इसे व्यक्त नहीं कर सकता, और प्रॉम्प्ट कार्रवाई को निषिद्ध करता है।
Scrapeless MCP उपकरण सतह
पुष्ट सर्वर निर्माण ने चार उपयोगी परिवारों में समूहित चौबीस उपकरण लौटाए:
| परिवार | उदाहरण | Hermes में उपयोग |
|---|---|---|
| खोज | google_search, google_trends |
वर्तमान स्रोतों और ट्रेंड डेटा का पता लगाएं |
| निकासी | scrape_markdown, scrape_html, scrape_screenshot |
एक सार्वजनिक URL को मॉडल-पठनीय साक्ष्य में बदलें |
| क्रॉल | crawl_start, crawl_result, crawl_cancel |
एक परिभाषित सार्वजनिक साइट दायरे में चलें |
| ब्राउज़र | सत्र, नेविगेशन, स्नैपशॉट, इनपुट, पढ़ाई, और बंद करने के उपकरण | उन पृष्ठों का संचालन करें जिनके लिए रेंडरिंग या इंटरैक्शन की आवश्यकता होती है |
आदत से पूरी सूची उजागर न करें। एक रिपोर्ट-लेखन एजेंट को केवल खोज और Markdown निकासी की आवश्यकता हो सकती है। एक ब्राउज़र कार्य को सत्र जीवन चक्र और पृष्ठ कार्यों की आवश्यकता होती है। जब उन अनुमति सेटों में महत्वपूर्ण अंतर होते हैं, तो अलग Hermes प्रोफ़ाइल या अलग सर्वर प्रविष्टियाँ रखें।
Scrapeless AI एजेंट सतह उत्पाद संदर्भ प्रदान करती है, और मूल्य निर्धारण अपेक्षित वेब संचालन को खाता योजना के साथ मानचित्रित करने में मदद करता है।
आपको क्या मिल रहा है
MCP उपकरण परिणाम संरचित संदेशों के रूप में रहते हैं न कि छिपी हुई ब्राउज़र स्थिति के रूप में। एक खोज परिणाम रिकॉर्ड ला सकती है; निकासी Markdown लौटा सकती है; ब्राउज़र स्नैपशॉट अगले मॉडल निर्णय के लिए उपयुक्त तत्व विवरण वापस ला सकते हैं। इसके बाद Hermes चयनित परिणाम को अपने कार्य संदर्भ में रखता है।
यह भिन्नता निदान में सुधार करती है। “सर्वर शुरू करने में विफल,” “उपकरण खोज विफल,” “प्रमाण पत्र अस्वीकृत,” और “पृष्ठ ने कोई उपयोगी सामग्री नहीं लौटाई” अलग-अलग घटनाएं हैं। हार्नेस सही जानकारी रिपोर्ट कर सकता है बजाय हर विफलता को एक अस्पष्ट मॉडल खेद में परिवर्तित करने के।
निष्कर्ष
हेर्मेस एजेंट और स्क्रेपलेस एमसीपी एक साफ सीमा पर फिट होते हैं: हेर्मेस तर्क और संचालन का मालिक है; एमसीपी सर्वर टाइप किए गए वेब संचालन का मालिक है। सत्यापित पथ है, एक stdio सर्वर स्थापित करें, कॉन्फ़िगर करें, एक संकीर्ण अनुमति सूची लागू करें, खोज का परीक्षण करें, और एक पढ़ने-के-लायक क्रेडेंशियल-गेटेड कॉल करें।
वेब-जन जागरूक हेर्मेस एजेंट बनाने के लिए तैयार हैं?
हमारे समुदाय में शामिल हों ताकि एक मुफ्त योजना का दावा करें और उन डेवलपर्स के साथ जुड़ें जो एजेंट शोध वर्कफ़्लोज़ बना रहे हैं: Discord · Telegram。
app.scrapeless.com पर साइन अप करें और हेर्मेस को सबसे छोटे उपयोगी वेब टूल सतह से जोड़ें।
सामान्य प्रश्न
प्रश्न: क्या हेर्मेस एजेंट एमसीपी सर्वरों का समर्थन करता है?
हाँ। हेर्मेस एजेंट स्थानीय stdio और दूरस्थ HTTP एमसीपी सर्वरों का समर्थन करता है, स्टार्टअप पर उनके उपकरणों को खोजता है, और सर्वर के अनुसार दिखाई देने वाले उपकरणों को फ़िल्टर कर सकता है।
प्रश्न: स्क्रेपलेस stdio सर्वर कौन सा पर्यावरण चर का उपयोग करता है?
दस्तावेजित stdio कॉन्फ़िगरेशन SCRAPELESS_KEY का उपयोग करता है। इसे सर्वर वातावरण में रखें और मूल्य को प्रॉम्प्ट और प्रतिबद्ध कॉन्फ़िगरेशन फ़ाइलों से बाहर रखें।
प्रश्न: कनेक्शन परीक्षण क्यों अनुमति सूची से अधिक उपकरण दिखाता है?
कनेक्शन परीक्षण सर्वर के खोजे गए कैटलॉग की रिपोर्ट करता है, जबकि अनुमति सूची उस उपसमुच्चय को परिभाषित करती है जिसे मॉडल के लिए लक्षित किया गया है। सत्यापित सेटअप में, सर्वर ने चौबीस टूल स्कीमाएँ लौटाईं और कॉन्फ़िगरेशन ने आठ का चयन किया।
प्रश्न: क्या सफल एमसीपी कनेक्शन API कुंजी काम करने को साबित करता है?
नहीं। सफल हैंडशेक यह साबित करता है कि हेर्मेस ने सर्वर को शुरू किया और इसके स्कीमाओं को खोजा। सेवा प्रमाणीकरण के लिए असली कुंजी लोड करने के बाद एक पढ़ने-के-लायक वेब संचालन चलाएँ।
प्रश्न: क्या हर स्क्रेपलेस एमसीपी उपकरण को सक्षम करना चाहिए?
नहीं। केवल उन संचालन को सक्षम करें जो एजेंट के काम के लिए आवश्यक हैं। छोटे उपकरण सेट चयन की अस्पष्टता को कम करते हैं और गलत कार्रवाई के प्रभाव को सीमित करते हैं।
प्रश्न: क्या हेर्मेस बिना किसी एआई एजेंट ढांचे के स्क्रेपलेस का उपयोग कर सकता है?
हेर्मेस इस सेटअप में स्वयं एजेंट रनटाइम है। यह सीधे स्क्रेपलेस एमसीपी सर्वर से जुड़ता है, इसलिए किसी अतिरिक्त एजेंट ढांचे की आवश्यकता नहीं है।
प्रश्न: क्या सेटअप stdio के बजाय HTTP का उपयोग कर सकता है?
हाँ। दोनों उत्पाद HTTP-सक्षम एमसीपी कनेक्शन को दस्तावेजित करते हैं। स्टडियो एक स्थानीय बाल प्रक्रिया के लिए सहायक है; दूरस्थ HTTP तब उपयोगी है जब सर्वर जीवनचक्र और क्रेडेंशियल को केंद्रित रूप से प्रबंधित किया जाता है।
प्रश्न: क्या एमसीपी वेबसाइट पहुँच नियमों को ओवरराइड करता है?
नहीं। एमसीपी परिभाषित करता है कि क्लाइंट और टूल सर्वर के बीच संवाद कैसे होता है। एजेंट को अभी भी लक्ष्य तक पहुँचने की अनुमति की आवश्यकता है, इसे सार्वजनिक या अधिकृत डेटा का उपयोग करना चाहिए, और इसे लागू नियमों और कानूनों का पालन करना चाहिए।
स्क्रैपलेस में, हम केवल सार्वजनिक रूप से उपलब्ध डेटा का उपयोग करते हैं, जबकि लागू कानूनों, विनियमों और वेबसाइट गोपनीयता नीतियों का सख्ती से अनुपालन करते हैं। इस ब्लॉग में सामग्री केवल प्रदर्शन उद्देश्यों के लिए है और इसमें कोई अवैध या उल्लंघन करने वाली गतिविधियों को शामिल नहीं किया गया है। हम इस ब्लॉग या तृतीय-पक्ष लिंक से जानकारी के उपयोग के लिए सभी देयता को कोई गारंटी नहीं देते हैं और सभी देयता का खुलासा करते हैं। किसी भी स्क्रैपिंग गतिविधियों में संलग्न होने से पहले, अपने कानूनी सलाहकार से परामर्श करें और लक्ष्य वेबसाइट की सेवा की शर्तों की समीक्षा करें या आवश्यक अनुमतियाँ प्राप्त करें।




