Firecrawl MCP

आधिकारिक

LLM क्लाइंट जैसे Cursor और Claude में शक्तिशाली वेब स्क्रैपिंग और खोज क्षमताएँ जोड़ता है।

firecrawl.link पर देखें

Firecrawl MCP के साथ आप क्या कर सकते हैं?

वेब पर जानकारी खोजें — जब आपको नहीं पता कि किस साइट पर उत्तर है, तो प्रासंगिक पृष्ठ खोजने के लिए firecrawl_search का उपयोग करें।
ज्ञात URL से संरचित डेटा निकालें — एकल पृष्ठ से केवल आवश्यक फ़ील्ड निकालने के लिए JSON स्कीमा के साथ firecrawl_scrape को कॉल करें।
साइट पर सभी URL खोजें — स्क्रैप करने का निर्णय लेने से पहले अनुक्रमित पृष्ठों को सूचीबद्ध करने के लिए firecrawl_map चलाएँ।
स्वायत्त बहु-स्रोत अनुसंधान चलाएँ — जटिल, क्रॉस-साइट डेटा संग्रह के लिए firecrawl_agent कार्य प्रारंभ करें और firecrawl_agent_status को पोल करें।
डायनामिक पृष्ठों के साथ इंटरैक्ट करें — पृष्ठ पर क्लिक करने, टाइप करने या नेविगेट करने और परिणामी स्थिति लौटाने के लिए firecrawl_interact का उपयोग करें।
स्थानीय दस्तावेज़ पार्स करें — स्वच्छ मार्कडाउन या संरचित आउटपुट प्राप्त करने के लिए PDF, Word फ़ाइलें या स्प्रेडशीट firecrawl_parse के माध्यम से भेजें।

दस्तावेज़

Firecrawl MCP सर्वर

एक मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर जो Firecrawl को MCP-संगत AI एजेंटों तक लाता है — स्वच्छ, एजेंट-तैयार संदर्भ के लिए लाइव वेब पर खोजें, स्क्रैप करें और इंटरैक्ट करें।

प्रारंभिक कार्यान्वयन के लिए @vrknetha, @knacklabs का बहुत-बहुत धन्यवाद!

विशेषताएँ

वेब खोजें और पूर्ण पृष्ठ सामग्री प्राप्त करें
किसी भी URL को स्वच्छ, संरचित डेटा में स्क्रैप करें
पृष्ठों के साथ इंटरैक्ट करें — क्लिक करें, नेविगेट करें और संचालित करें
स्वायत्त एजेंट के साथ गहन शोध
स्वचालित पुनर्प्रयास और दर सीमित करना
क्लाउड और स्व-होस्टेड समर्थन
SSE समर्थन

MCP.so के प्लेग्राउंड पर हमारे MCP सर्वर या Klavis AI पर प्रयोग करें।

स्थापना

होस्टेड MCP (की-रहित मुफ़्त स्तर)

बिना किसी सेटअप के दूरस्थ होस्टेड सर्वर से कनेक्ट करें:

https://mcp.firecrawl.dev/v2/mcp

की-रहित मुफ़्त स्तर पर, scrape, search, और interact बिना API कुंजी के काम करते हैं (दर-सीमित)। crawl, map, agent, और extract जैसे अन्य उपकरणों को अभी भी एक कुंजी की आवश्यकता होती है।

जब भी मानव साइन अप कर सकता है, तब API कुंजी या OAuth को प्राथमिकता दें। यह पूर्ण उपकरण सेट और उच्च सीमाएँ अनलॉक करता है। एक कुंजी के साथ, उपयोग करें:

https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

सेटअप विवरण के लिए MCP सर्वर दस्तावेज़ और एजेंट ऑनबोर्डिंग गाइड देखें।

केवल-खोज एंडपॉइंट

एक केवल-पढ़ने योग्य, केवल-खोज सतह यहाँ भी होस्ट की गई है:

https://mcp.firecrawl.dev/v2/mcp-search

यह छह केवल-पढ़ने योग्य उपकरणों का एक निश्चित सेट उजागर करता है: firecrawl_search और पाँच firecrawl_research_* उपकरण। यह कोई पृष्ठ-सामग्री प्राप्त नहीं करता है और इसकी अपनी OAuth पहचान है; उपरोक्त पूर्ण एंडपॉइंट अपरिवर्तित है। पूर्ण अनुबंध के लिए docs/search-profile.md देखें।

npx के साथ चलाना

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

मैन्युअल स्थापना

npm install -g firecrawl-mcp

Cursor पर चलाना

Cursor कॉन्फ़िगर करना 🖥️ नोट: Cursor संस्करण 0.45.6+ आवश्यक है सबसे अद्यतित कॉन्फ़िगरेशन निर्देशों के लिए, कृपया MCP सर्वर कॉन्फ़िगर करने पर आधिकारिक Cursor दस्तावेज़ देखें: Cursor MCP सर्वर कॉन्फ़िगरेशन गाइड

Cursor v0.48.6 में Firecrawl MCP कॉन्फ़िगर करने के लिए

Cursor सेटिंग्स खोलें
सुविधाएँ > MCP सर्वर पर जाएँ
"+ नया वैश्विक MCP सर्वर जोड़ें" पर क्लिक करें

निम्नलिखित कोड दर्ज करें:

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Cursor v0.45.6 में Firecrawl MCP कॉन्फ़िगर करने के लिए

Cursor सेटिंग्स खोलें
सुविधाएँ > MCP सर्वर पर जाएँ
"+ नया MCP सर्वर जोड़ें" पर क्लिक करें
निम्नलिखित दर्ज करें:
- नाम: "firecrawl-mcp" (या आपका पसंदीदा नाम)
- प्रकार: "command"
- कमांड: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

यदि आप Windows का उपयोग कर रहे हैं और समस्याओं का सामना कर रहे हैं, तो cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp" आज़माएँ

your-api-key को अपनी Firecrawl API कुंजी से बदलें। यदि आपके पास अभी तक एक नहीं है, तो आप एक खाता बना सकते हैं और इसे https://www.firecrawl.dev/app/api-keys से प्राप्त कर सकते हैं

जोड़ने के बाद, नए उपकरण देखने के लिए MCP सर्वर सूची को ताज़ा करें। कंपोज़र एजेंट उपयुक्त होने पर स्वचालित रूप से Firecrawl MCP का उपयोग करेगा, लेकिन आप अपनी वेब स्क्रैपिंग आवश्यकताओं का वर्णन करके स्पष्ट रूप से इसका अनुरोध कर सकते हैं। Command+L (Mac) के माध्यम से कंपोज़र तक पहुँचें, सबमिट बटन के बगल में "Agent" चुनें, और अपनी क्वेरी दर्ज करें।

Windsurf पर चलाना

इसे अपने ./codeium/windsurf/model_config.json में जोड़ें:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

स्ट्रीमेबल HTTP स्थानीय मोड के साथ चलाना

डिफ़ॉल्ट stdio परिवहन के बजाय स्थानीय रूप से स्ट्रीमेबल HTTP का उपयोग करके सर्वर चलाने के लिए:

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

url का उपयोग करें: http://localhost:3000/mcp

Smithery के माध्यम से स्थापित करना (विरासत)

Smithery के माध्यम से Claude Desktop के लिए स्वचालित रूप से Firecrawl स्थापित करने के लिए:

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

VS Code पर चलाना

एक-क्लिक स्थापना के लिए, नीचे दिए गए इंस्टॉल बटनों में से एक पर क्लिक करें...

मैन्युअल स्थापना के लिए, VS Code में अपनी उपयोगकर्ता सेटिंग्स (JSON) फ़ाइल में निम्नलिखित JSON ब्लॉक जोड़ें। आप Ctrl + Shift + P दबाकर और Preferences: Open User Settings (JSON) टाइप करके ऐसा कर सकते हैं।

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl API Key",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

वैकल्पिक रूप से, आप इसे अपने कार्यक्षेत्र में .vscode/mcp.json नामक फ़ाइल में जोड़ सकते हैं। यह आपको कॉन्फ़िगरेशन को दूसरों के साथ साझा करने की अनुमति देगा:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

कॉन्फ़िगरेशन

पर्यावरण चर

क्लाउड API के लिए आवश्यक

FIRECRAWL_API_KEY: आपकी Firecrawl API कुंजी
- क्लाउड API (डिफ़ॉल्ट) का उपयोग करते समय आवश्यक
- FIRECRAWL_API_URL के साथ स्व-होस्टेड इंस्टेंस का उपयोग करते समय वैकल्पिक
FIRECRAWL_API_URL (वैकल्पिक): स्व-होस्टेड इंस्टेंस के लिए कस्टम API एंडपॉइंट
- उदाहरण: https://firecrawl.your-domain.com
- यदि प्रदान नहीं किया गया है, तो क्लाउड API का उपयोग किया जाएगा (API कुंजी की आवश्यकता है)

MCP OAuth (बियरर एक्सेस टोकन)

होस्टेड Firecrawl firecrawl.dev पर प्राधिकरण सर्वर के माध्यम से OAuth एक्सेस टोकन (fco_…) जारी कर सकता है। यह MCP सर्वर जो भी क्रेडेंशियल हल करता है उसे Firecrawl API को Authorization: Bearer … के रूप में अग्रेषित करता है।

HTTP स्ट्रीम परिवहन (CLOUD_SERVICE=true, HTTP_STREAMABLE_SERVER=true, या SSE_LOCAL=true): क्लाइंट को MCP अनुरोधों पर Authorization: Bearer <fco_access_token> भेजना चाहिए। जब दोनों मौजूद हों तो OAuth बियरर टोकन x-firecrawl-api-key / x-api-key पर प्राथमिकता लेता है।
stdio: स्थिर एक्सेस टोकन के लिए FIRECRAWL_OAUTH_TOKEN का उपयोग करें, या API कुंजी के लिए FIRECRAWL_API_KEY का उपयोग करते रहें।

केवल एक्सेस टोकन (fco_…) का उपयोग करें। रिफ्रेश टोकन (fcr_…) को टोकन एंडपॉइंट पर एक्सचेंज किया जाना चाहिए, स्क्रैप/खोज API को पास नहीं किया जाना चाहिए।

केवल-खोज सतह (होस्टेड)

होस्टेड मोड (CLOUD_SERVICE=true) में एक दूसरा इन-प्रोसेस इंस्टेंस केवल-खोज एंडपॉइंट प्रदान करता है। बंडल की गई सेवा का एक निश्चित परिनियोजन अनुबंध है: nginx /v2/mcp-search को स्थानीय पोर्ट 3001 पर इंस्टेंस तक रूट करता है, और OAuth संरक्षित-संसाधन पहचानकर्ता https://mcp.firecrawl.dev/v2/mcp-search है।

FIRECRAWL_MCP_SEARCH_ENABLED (डिफ़ॉल्ट true) समर्थित परिचालन टॉगल है; खोज इंस्टेंस को शुरू होने से रोकने के लिए इसे false पर सेट करें। Node प्रक्रिया पृथक परीक्षणों के लिए FIRECRAWL_MCP_SEARCH_PORT, FIRECRAWL_MCP_SEARCH_ENDPOINT, और FIRECRAWL_MCP_SEARCH_RESOURCE_URL भी स्वीकार करती है। वे ओवरराइड बंडल किए गए nginx मार्गों या प्राधिकरण सर्वर अनुमति सूची को पुन: कॉन्फ़िगर नहीं करते हैं और होस्टेड परिनियोजन में स्वतंत्र रूप से उपयोग नहीं किए जाने चाहिए।

खोज इंस्टेंस को प्रत्येक अनुरोध (tools/list सहित) के लिए प्रमाणीकरण की आवश्यकता होती है और उन OAuth टोकन को अस्वीकार करता है जिनके ऑडियंस उसके अपने संसाधन से मेल नहीं खाते हैं।

कॉन्फ़िगरेशन उदाहरण

क्लाउड API उपयोग के लिए:

export FIRECRAWL_API_KEY=your-api-key

स्व-होस्टेड इंस्टेंस के लिए:

# Required for self-hosted
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com

# Optional authentication for self-hosted
export FIRECRAWL_API_KEY=your-api-key  # If your instance requires auth

Claude Desktop के साथ उपयोग

इसे अपने claude_desktop_config.json में जोड़ें:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

उपकरण कैसे चुनें

अपने कार्य के लिए सही उपकरण चुनने हेतु इस गाइड का उपयोग करें:

यदि आपको सटीक URL पता है जो आप चाहते हैं: scrape का उपयोग करें (संरचित डेटा के लिए JSON प्रारूप के साथ)
यदि आपके पास कई ज्ञात URL हैं: प्रत्येक URL के लिए scrape कॉल करें। यदि आपको विशेष रूप से एक बल्क API ऑपरेशन की आवश्यकता है, तो MCP के बाहर Firecrawl API बैच एंडपॉइंट का उपयोग करें।
यदि आपको किसी साइट पर URL खोजने की आवश्यकता है: map का उपयोग करें
यदि आप जानकारी के लिए वेब खोजना चाहते हैं: search का उपयोग करें
यदि आपको कई अज्ञात स्रोतों पर जटिल शोध की आवश्यकता है: agent का उपयोग करें
यदि आप पूरी साइट या अनुभाग का विश्लेषण करना चाहते हैं: crawl का उपयोग करें (सीमाओं के साथ!)
यदि आपको इंटरैक्टिव ब्राउज़र स्वचालन (क्लिक, टाइप, नेविगेट) की आवश्यकता है: ताज़ा पृष्ठ के लिए URL के साथ interact का उपयोग करें, या जब आपने पहले ही पृष्ठ स्क्रैप कर लिया हो या कड़े स्क्रैप नियंत्रण की आवश्यकता हो तो scrape + interact का उपयोग करें

त्वरित संदर्भ तालिका

उपकरण	के लिए सर्वोत्तम	रिटर्न
scrape	एकल पृष्ठ सामग्री	JSON (पसंदीदा) या मार्कडाउन
interact	URL या स्क्रैप किए गए पृष्ठ के साथ इंटरैक्ट करें	निष्पादन परिणाम + URL मोड के लिए scrapeId
map	किसी साइट पर URL खोजना	URL[]
crawl	बहु-पृष्ठ निष्कर्षण (सीमाओं के साथ)	आंतरिक मतदान के बाद अंतिम क्रॉल स्थिति/डेटा
parse	फ़ाइलें और होस्टेड अपलोड संदर्भ	मार्कडाउन, JSON, या दस्तावेज़ आउटपुट
extract	URL से संरचित निष्कर्षण	JSON संरचित डेटा
search	जानकारी के लिए वेब खोज	results[]
agent	जटिल बहु-स्रोत शोध	JSON (संरचित डेटा)
monitor	आवर्ती पृष्ठ जाँच	मॉनिटर/जाँच मेटाडेटा और अंतर
research	पेपर और GitHub रिपॉजिटरी शोध	शोध परिणाम और रिपो मिलान

प्रारूप चयन गाइड

scrape का उपयोग करते समय, सही प्रारूप चुनें:

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

उपलब्ध उपकरण

1. स्क्रैप उपकरण (`firecrawl_scrape`)

उन्नत विकल्पों के साथ एकल URL से सामग्री स्क्रैप करें।

इसके लिए सर्वोत्तम:

एकल पृष्ठ सामग्री निष्कर्षण, जब आपको ठीक-ठीक पता हो कि किस पृष्ठ में जानकारी है।

इसके लिए अनुशंसित नहीं:

एकाधिक पृष्ठों से सामग्री निकालना (ज्ञात URL के लिए बार-बार स्क्रैप कॉल का उपयोग करें, या पहले URL खोजने के लिए map + scrape, या पूर्ण पृष्ठ सामग्री के लिए crawl)
जब आप अनिश्चित हों कि किस पृष्ठ में जानकारी है (search का उपयोग करें)

सामान्य गलतियाँ:

एक स्क्रैप कॉल में URL की सूची पास करना। MCP में प्रति URL एक बार स्क्रैप कॉल करें। यदि आपको विशेष रूप से एक बल्क API ऑपरेशन की आवश्यकता है, तो MCP के बाहर Firecrawl API बैच एंडपॉइंट का उपयोग करें।
डिफ़ॉल्ट रूप से मार्कडाउन प्रारूप का उपयोग करना (केवल वही निकालने के लिए JSON प्रारूप का उपयोग करें जो आपको चाहिए)।

सही प्रारूप चुनना:

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

प्रॉम्प्ट उदाहरण:

"https://example.com/product. से उत्पाद विवरण प्राप्त करें"

उपयोग उदाहरण (JSON प्रारूप - पसंदीदा):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/product",
    "formats": [
      {
        "type": "json",
        "prompt": "Extract the product information",
        "schema": {
          "type": "object",
          "properties": {
            "name": { "type": "string" },
            "price": { "type": "number" },
            "description": { "type": "string" }
          },
          "required": ["name", "price"]
        }
      }
    ]
  }
}

उपयोग उदाहरण (मार्कडाउन प्रारूप - जब पूर्ण सामग्री की आवश्यकता हो):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/article",
    "formats": ["markdown"],
    "onlyMainContent": true
  }
}

उपयोग उदाहरण (ब्रांडिंग प्रारूप - ब्रांड पहचान निकालें):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formats": ["branding"]
  }
}

ब्रांडिंग प्रारूप: डिज़ाइन विश्लेषण या शैली प्रतिकृति के लिए व्यापक ब्रांड पहचान (रंग, फ़ॉन्ट, टाइपोग्राफी, रिक्ति, लोगो, UI घटक) निकालता है। गोपनीयता: व्यक्तिगत रूप से पहचान योग्य जानकारी को संशोधित करके सामग्री वापस करने के लिए redactPII: true सेट करें।

रिटर्न:

JSON संरचित डेटा, मार्कडाउन, ब्रांडिंग प्रोफ़ाइल, या निर्दिष्ट अनुसार अन्य प्रारूप।

2. मैप उपकरण (`firecrawl_map`)

साइट पर सभी अनुक्रमित URL खोजने के लिए एक वेबसाइट का मानचित्रण करें।

इसके लिए सर्वोत्तम:

क्या स्क्रैप करना है यह तय करने से पहले किसी वेबसाइट पर URL खोजना
किसी वेबसाइट के विशिष्ट अनुभाग ढूँढना

इसके लिए अनुशंसित नहीं:

जब आपको पहले से ही पता हो कि आपको किस विशिष्ट URL की आवश्यकता है (scrape का उपयोग करें)
जब आपको पृष्ठों की सामग्री की आवश्यकता हो (मैपिंग के बाद scrape का उपयोग करें)

सामान्य गलतियाँ:

मैप के बजाय URL खोजने के लिए crawl का उपयोग करना

प्रॉम्प्ट उदाहरण:

"example.com पर सभी URL सूचीबद्ध करें।"

उपयोग उदाहरण:

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}

रिटर्न:

साइट पर पाए गए URL की सरणी

3. खोज उपकरण (`firecrawl_search`)

वेब खोजें और वैकल्पिक रूप से खोज परिणामों से सामग्री निकालें।

इसके लिए सर्वोत्तम:

कई वेबसाइटों पर विशिष्ट जानकारी ढूँढना, जब आपको नहीं पता कि किस वेबसाइट के पास जानकारी है।
जब आपको किसी क्वेरी के लिए सबसे प्रासंगिक सामग्री की आवश्यकता हो

इसके लिए अनुशंसित नहीं:

जब आपको पहले से ही पता हो कि किस वेबसाइट को स्क्रैप करना है (scrape का उपयोग करें)
जब आपको एक ही वेबसाइट की व्यापक कवरेज की आवश्यकता हो (map या crawl का उपयोग करें)

सामान्य गलतियाँ:

ओपन-एंडेड प्रश्नों के लिए crawl या map का उपयोग करना (इसके बजाय search का उपयोग करें)

उपयोग उदाहरण:

{
  "name": "firecrawl_search",
  "arguments": {
    "query": "latest AI research papers 2023",
    "highlights": true,
    "limit": 5,
    "lang": "en",
    "country": "us",
    "scrapeOptions": {
      "formats": ["markdown"],
      "onlyMainContent": true,
      "redactPII": true
    }
  }
}

highlights को true पर सेट करें ताकि क्वेरी-संबंधित हाइलाइट्स का अनुरोध किया जा सके या false पर सेट करें ताकि मूल खोज स्निपेट्स को बनाए रखा जा सके। API के डिफ़ॉल्ट व्यवहार का उपयोग करने के लिए इसे छोड़ दें।

यह लौटाता है:

खोज परिणामों की सारणी (वैकल्पिक स्क्रैप की गई सामग्री के साथ), साथ ही एक id फ़ील्ड। परिणामों का उपयोग करने के बाद उस id को firecrawl_search_feedback में पास करें ताकि 1 क्रेडिट वापस किया जा सके (खोज की लागत 2 है) और खोज गुणवत्ता में सुधार हो सके।

प्रॉम्प्ट उदाहरण:

"2023 में प्रकाशित AI पर नवीनतम शोध पत्र खोजें।"

3b. खोज प्रतिक्रिया उपकरण (`firecrawl_search_feedback`)

पिछले firecrawl_search परिणाम पर संरचित प्रतिक्रिया भेजता है। प्रति खोज आईडी पहली प्रतिक्रिया 1 क्रेडिट वापस करती है और Firecrawl की खोज गुणवत्ता में सुधार करती है। प्रति खोज आईडी अद्वितीय।

प्रत्येक खोज के बाद इसे कॉल करें जिसका आप वास्तव में उपयोग करते हैं (या जिसने मदद नहीं की)। missingContent के साथ खराब/आंशिक प्रतिक्रिया उतनी ही मूल्यवान है जितनी अच्छी प्रतिक्रिया।

ऑप्ट आउट: MCP सर्वर शुरू करते समय वातावरण में FIRECRAWL_NO_SEARCH_FEEDBACK=1 (या FIRECRAWL_DISABLE_SEARCH_FEEDBACK=1) सेट करें। firecrawl_search_feedback उपकरण पंजीकृत नहीं होगा, इसलिए एजेंट इसे कॉल नहीं कर सकते। टीम व्यवस्थापक सर्वर-साइड पर भी प्रतिक्रिया अक्षम कर सकते हैं; उस स्थिति में उपकरण पंजीकृत होता है लेकिन हमेशा feedbackErrorCode: "TEAM_OPTED_OUT" लौटाता है।

सबसे महत्वपूर्ण फ़ील्ड: missingContent। यह विशिष्ट सामग्री के टुकड़ों की एक सारणी है जिसे एजेंट खोजने की उम्मीद करता था लेकिन नहीं मिला। प्रति अनुपलब्ध विषय एक प्रविष्टि — ये टीमों में एकत्रित होते हैं और हमें बताते हैं कि आगे क्या अनुक्रमित करना है।

दैनिक धनवापसी सीमा (प्रति टीम, प्रति UTC दिन, डिफ़ॉल्ट 100 क्रेडिट)। एक बार जब किसी टीम का creditsRefundedToday dailyRefundCap तक पहुँच जाता है, तो आगे के सबमिशन अभी भी प्रतिक्रिया दर्ज करते हैं लेकिन अब क्रेडिट वापस नहीं करते। प्रतिक्रिया dailyCapReached: true सेट करती है। एजेंटों को उस ध्वज को देखने पर शेष UTC दिन के लिए इस उपकरण को कॉल करना बंद कर देना चाहिए।

उपयोग उदाहरण:

{
  "name": "firecrawl_search_feedback",
  "arguments": {
    "searchId": "0193f6c5-1234-7890-abcd-1234567890ab",
    "rating": "good",
    "valuableSources": [
      {
        "url": "https://docs.firecrawl.dev/features/search",
        "reason": "Most up-to-date description of /search."
      }
    ],
    "missingContent": [
      {
        "topic": "Pricing for the search endpoint",
        "description": "No pricing tier table for /search specifically."
      },
      { "topic": "Per-team rate limits" }
    ],
    "querySuggestions": "Boost docs.firecrawl.dev for queries that mention 'firecrawl'"
  }
}

यह लौटाता है:

{ success, feedbackId, creditsRefunded, alreadySubmitted? } JSON।

3c. सामान्य प्रतिक्रिया उपकरण (`firecrawl_feedback`)

/v2/feedback के माध्यम से पूर्ण v2 एंडपॉइंट कार्य के लिए संरचित प्रतिक्रिया भेजता है। scrape, parse, map, या search कार्यों पर एंडपॉइंट-स्तरीय प्रतिक्रिया के लिए इसका उपयोग करें। विशेष रूप से खोज-परिणाम गुणवत्ता के लिए, firecrawl_search_feedback को प्राथमिकता दें क्योंकि इसमें खोज-विशिष्ट मार्गदर्शन शामिल है।

प्रतिक्रिया संक्षिप्त रखें: समस्या कोड, टैग, छोटे नोट्स, URL, पृष्ठ संख्याएँ, और छोटे मेटाडेटा ऑब्जेक्ट का उपयोग करें। कच्चे स्क्रैप/पार्स आउटपुट शामिल न करें।

ऑप्ट आउट: MCP सर्वर शुरू करते समय वातावरण में FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 (या FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1) सेट करें। firecrawl_feedback उपकरण पंजीकृत नहीं होगा, इसलिए एजेंट इसे कॉल नहीं कर सकते।

उपयोग उदाहरण:

{
  "name": "firecrawl_feedback",
  "arguments": {
    "endpoint": "scrape",
    "jobId": "0193f6c5-1234-7890-abcd-1234567890ab",
    "rating": "partial",
    "issues": ["missing_markdown"],
    "tags": ["docs"],
    "note": "The pricing table was missing from the markdown output.",
    "url": "https://example.com/pricing",
    "pageNumbers": [1],
    "metadata": {
      "format": "markdown"
    }
  }
}

यह लौटाता है:

{ success, feedbackId, creditsRefunded, creditsRefundedToday?, dailyRefundCap?, dailyCapReached?, alreadySubmitted?, warning? } JSON।

4. क्रॉल उपकरण (`firecrawl_crawl`)

एक क्रॉल कार्य शुरू करता है, तब तक मतदान करता है जब तक यह एक अंतिम स्थिति तक नहीं पहुँच जाता, और अंतिम क्रॉल स्थिति/डेटा लौटाता है।

इसके लिए सर्वोत्तम:

कई संबंधित पृष्ठों से सामग्री निकालना, जब आपको व्यापक कवरेज की आवश्यकता हो।

इसके लिए अनुशंसित नहीं:

एकल पृष्ठ से सामग्री निकालना (स्क्रैप का उपयोग करें)
जब टोकन सीमाएँ चिंता का विषय हों (कड़े नियंत्रण के लिए मैप + स्क्रैप का उपयोग करें)
जब आपको तेज़ परिणाम चाहिए (क्रॉलिंग धीमी हो सकती है)

चेतावनी: क्रॉल प्रतिक्रियाएँ बहुत बड़ी हो सकती हैं और टोकन सीमा से अधिक हो सकती हैं। क्रॉल गहराई और पृष्ठों की संख्या सीमित करें, या कड़े नियंत्रण के लिए मैप + स्क्रैप का उपयोग करें।

सामान्य गलतियाँ:

सीमा या maxDiscoveryDepth बहुत अधिक सेट करना (टोकन ओवरफ्लो का कारण बनता है)
एकल पृष्ठ के लिए क्रॉल का उपयोग करना (इसके बजाय स्क्रैप का उपयोग करें)

प्रॉम्प्ट उदाहरण:

"example.com/blog के पहले दो स्तरों से सभी ब्लॉग पोस्ट प्राप्त करें।"

उपयोग उदाहरण:

{
  "name": "firecrawl_crawl",
  "arguments": {
    "url": "https://example.com/blog/*",
    "maxDiscoveryDepth": 2,
    "limit": 100,
    "allowExternalLinks": false,
    "deduplicateSimilarURLs": true
  }
}

यह लौटाता है:

आंतरिक मतदान के बाद अंतिम क्रॉल स्थिति और डेटा, जिसमें id, status, completed, total, creditsUsed, expiresAt, next, और data शामिल हैं। यदि आपको बाद में कार्य की पुनः जाँच करने की आवश्यकता हो तो लौटाए गए id का उपयोग firecrawl_check_crawl_status के साथ करें।

5. क्रॉल स्थिति जाँचें (`firecrawl_check_crawl_status`)

आईडी द्वारा मौजूदा क्रॉल कार्य की स्थिति और परिणाम जाँचें।

{
  "name": "firecrawl_check_crawl_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

यह लौटाता है:

प्रतिक्रिया में क्रॉल कार्य की स्थिति शामिल है:

6. पार्स उपकरण (`firecrawl_parse`)

Firecrawl के /v2/parse एंडपॉइंट के साथ स्थानीय फ़ाइलों या होस्टेड अपलोड संदर्भों को पार्स करें।

इसके लिए सर्वोत्तम: PDF, Word दस्तावेज़, स्प्रेडशीट, HTML फ़ाइलें, और अन्य दस्तावेज़ जिन्हें मार्कडाउन या संरचित JSON आउटपुट की आवश्यकता होती है। होस्टेड MCP दो-चरणीय अपलोड-रेफ प्रवाह का समर्थन करता है; स्थानीय प्रत्यक्ष फ़ाइल पठन के लिए स्व-होस्टेड FIRECRAWL_API_URL की आवश्यकता होती है।

इसके लिए अनुशंसित नहीं: दूरस्थ URL (स्क्रैप का उपयोग करें), एक कॉल में कई फ़ाइलें (प्रति फ़ाइल एक बार पार्स कॉल करें), या केवल-ब्राउज़र क्रियाएँ जैसे स्क्रीनशॉट और क्लिक।

होस्टेड MCP प्रवाह: होस्टेड MCP कॉलर के फ़ाइल सिस्टम को सीधे नहीं पढ़ सकता। filePath के साथ firecrawl_parse को कॉल करें ताकि एक अल्पकालिक अपलोड कमांड और nextToolCall प्राप्त हो, फ़ाइल को स्थानीय रूप से अपलोड करें, फिर लौटाए गए uploadRef के साथ firecrawl_parse को फिर से कॉल करें। होस्टेड अपलोड URL बनाने के लिए Firecrawl प्रमाणीकरण या कीलेस पात्रता की आवश्यकता होती है। स्थानीय npx firecrawl-mcp मोड में, प्रत्यक्ष फ़ाइल पार्सिंग के लिए वर्तमान में FIRECRAWL_API_URL की आवश्यकता होती है जो स्व-होस्टेड Firecrawl API की ओर इशारा करता है; एक सादा क्लाउड API-कुंजी-केवल स्थानीय सर्वर इस उपकरण के माध्यम से फ़ाइलों को पढ़ और अपलोड नहीं कर सकता।

उपयोग उदाहरण:

{
  "name": "firecrawl_parse",
  "arguments": {
    "filePath": "/absolute/path/to/document.pdf",
    "formats": ["markdown"],
    "parsers": ["pdf"],
    "zeroDataRetention": true
  }
}

यह लौटाता है: पार्स की गई दस्तावेज़ सामग्री या nextToolCall के साथ होस्टेड अपलोड निर्देश।

7. निष्कर्षण उपकरण (`firecrawl_extract`)

LLM क्षमताओं का उपयोग करके वेब पृष्ठों से संरचित जानकारी निकालें। क्लाउड AI और स्व-होस्टेड LLM निष्कर्षण दोनों का समर्थन करता है।

इसके लिए सर्वोत्तम:

कीमतों, नामों, विवरणों जैसे विशिष्ट संरचित डेटा निकालना।

इसके लिए अनुशंसित नहीं:

जब आपको किसी पृष्ठ की पूरी सामग्री चाहिए (स्क्रैप का उपयोग करें)
जब आप विशिष्ट संरचित डेटा की तलाश नहीं कर रहे हों

तर्क:

urls: जानकारी निकालने के लिए URL की सारणी
prompt: LLM निष्कर्षण के लिए कस्टम प्रॉम्प्ट
systemPrompt: LLM का मार्गदर्शन करने के लिए सिस्टम प्रॉम्प्ट
schema: संरचित डेटा निष्कर्षण के लिए JSON स्कीमा
allowExternalLinks: बाहरी लिंक से निष्कर्षण की अनुमति दें
enableWebSearch: अतिरिक्त संदर्भ के लिए वेब खोज सक्षम करें
includeSubdomains: निष्कर्षण में उपडोमेन शामिल करें

स्व-होस्टेड इंस्टेंस का उपयोग करते समय, निष्कर्षण आपके कॉन्फ़िगर किए गए LLM का उपयोग करेगा। क्लाउड API के लिए, यह Firecrawl की प्रबंधित LLM सेवा का उपयोग करता है। प्रॉम्प्ट उदाहरण:

"इन उत्पाद पृष्ठों से उत्पाद का नाम, मूल्य और विवरण निकालें।"

उपयोग उदाहरण:

{
  "name": "firecrawl_extract",
  "arguments": {
    "urls": ["https://example.com/page1", "https://example.com/page2"],
    "prompt": "Extract product information including name, price, and description",
    "systemPrompt": "You are a helpful assistant that extracts product information",
    "schema": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "price": { "type": "number" },
        "description": { "type": "string" }
      },
      "required": ["name", "price"]
    },
    "allowExternalLinks": false,
    "enableWebSearch": false,
    "includeSubdomains": false
  }
}

यह लौटाता है:

आपके स्कीमा द्वारा परिभाषित निकाला गया संरचित डेटा

{
  "content": [
    {
      "type": "text",
      "text": {
        "name": "Example Product",
        "price": 99.99,
        "description": "This is an example product description"
      }
    }
  ],
  "isError": false
}

8. एजेंट उपकरण (`firecrawl_agent`)

स्वायत्त वेब अनुसंधान एजेंट। यह एक अलग AI एजेंट परत है जो स्वतंत्र रूप से इंटरनेट ब्राउज़ करती है, जानकारी खोजती है, पृष्ठों के माध्यम से नेविगेट करती है, और आपकी क्वेरी के आधार पर संरचित डेटा निकालती है।

यह कैसे काम करता है:

एजेंट वेब खोज करता है, लिंक का अनुसरण करता है, पृष्ठ पढ़ता है, और स्वायत्त रूप से डेटा एकत्र करता है। यह अतुल्यकालिक रूप से चलता है - यह तुरंत एक कार्य आईडी लौटाता है, और आप पूर्ण होने पर जाँचने और परिणाम प्राप्त करने के लिए firecrawl_agent_status का मतदान करते हैं।

अतुल्यकालिक कार्यप्रवाह:

अपने प्रॉम्प्ट/स्कीमा के साथ firecrawl_agent को कॉल करें → कार्य आईडी लौटाता है
जबकि एजेंट शोध करता है, अन्य कार्य करें (जटिल प्रश्नों के लिए मिनट लग सकते हैं)
प्रगति की जाँच करने के लिए कार्य आईडी के साथ firecrawl_agent_status का मतदान करें
जब स्थिति "completed" हो, तो प्रतिक्रिया में निकाला गया डेटा शामिल होता है

इसके लिए सर्वोत्तम:

जटिल शोध कार्य जहाँ आप सटीक URL नहीं जानते
बहु-स्रोत डेटा संग्रहण
वेब पर बिखरी जानकारी ढूँढना
ऐसे कार्य जहाँ आप परिणामों की प्रतीक्षा करते समय अन्य कार्य कर सकते हैं

इसके लिए अनुशंसित नहीं:

सरल एकल-पृष्ठ स्क्रैपिंग जहाँ आप URL जानते हैं (JSON प्रारूप के साथ स्क्रैप का उपयोग करें - तेज़ और सस्ता)

तर्क:

prompt: आपके इच्छित डेटा का प्राकृतिक भाषा विवरण (आवश्यक, अधिकतम 10,000 वर्ण)
urls: एजेंट को विशिष्ट पृष्ठों पर केंद्रित करने के लिए URL की वैकल्पिक सारणी
schema: संरचित आउटपुट के लिए वैकल्पिक JSON स्कीमा

प्रॉम्प्ट उदाहरण:

"Firecrawl के संस्थापकों और उनकी पृष्ठभूमि का पता लगाएं"

उपयोग उदाहरण (एजेंट शुरू करें, फिर परिणामों के लिए मतदान करें):

{
  "name": "firecrawl_agent",
  "arguments": {
    "prompt": "Find the top 5 AI startups founded in 2024 and their funding amounts",
    "schema": {
      "type": "object",
      "properties": {
        "startups": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "funding": { "type": "string" },
              "founded": { "type": "string" }
            }
          }
        }
      }
    }
  }
}

फिर लौटाए गए कार्य आईडी का उपयोग करके firecrawl_agent_status के साथ मतदान करें।

उपयोग उदाहरण (URL के साथ - एजेंट विशिष्ट पृष्ठों पर ध्यान केंद्रित करता है):

{
  "name": "firecrawl_agent",
  "arguments": {
    "urls": ["https://docs.firecrawl.dev", "https://firecrawl.dev/pricing"],
    "prompt": "Compare the features and pricing information from these pages"
  }
}

यह लौटाता है:

स्थिति जाँच के लिए कार्य आईडी। परिणामों के लिए मतदान करने हेतु firecrawl_agent_status का उपयोग करें।

9. एजेंट स्थिति जाँचें (`firecrawl_agent_status`)

एजेंट कार्य की स्थिति जाँचें और पूर्ण होने पर परिणाम प्राप्त करें। एजेंट शुरू करने के बाद परिणामों के लिए मतदान करने हेतु इसका उपयोग करें।

मतदान पैटर्न: एजेंट अनुसंधान में जटिल प्रश्नों के लिए मिनट लग सकते हैं। स्थिति "completed" या "failed" होने तक समय-समय पर (जैसे, हर 10-30 सेकंड में) इस एंडपॉइंट का मतदान करें।

{
  "name": "firecrawl_agent_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

संभावित स्थितियाँ:

processing: एजेंट अभी भी शोध कर रहा है - बाद में जाँचें
completed: शोध समाप्त - प्रतिक्रिया में निकाला गया डेटा शामिल है
failed: एक त्रुटि हुई

10. इंटरैक्ट उपकरण (`firecrawl_interact`)

एक ताज़ा URL के साथ या firecrawl_scrape द्वारा पहले से खोले गए पृष्ठ के साथ इंटरैक्ट करें।

इसके लिए सर्वोत्तम: पदावनत ब्राउज़र उपकरणों को पुनर्स्थापित किए बिना गतिशील पृष्ठों से क्लिक करना, टाइप करना, नेविगेट करना और स्थिति निकालना।

उपयोग विकल्प:

एक MCP कॉल में इंटरैक्शन के लिए पृष्ठ को स्क्रैप और खोलने हेतु url पास करें।
मौजूदा स्क्रैप किए गए पृष्ठ के साथ इंटरैक्ट करना जारी रखने के लिए scrapeId पास करें।
url या scrapeId में से ठीक एक पास करें, साथ ही prompt या code में से कोई एक।

उपयोग उदाहरण:

{
  "name": "firecrawl_interact",
  "arguments": {
    "url": "https://example.com",
    "prompt": "Click the pricing link and summarize the visible plans"
  }
}

यह लौटाता है: इंटरैक्शन परिणाम और, URL मोड के लिए, अनुवर्ती या सफाई के लिए व्युत्पन्न scrapeId।

11. इंटरैक्ट रोकें उपकरण (`firecrawl_interact_stop`)

जब आप इंटरैक्ट करना समाप्त कर लें तो स्क्रैप किए गए पृष्ठ के लिए एक इंटरैक्ट सत्र रोकें।

{
  "name": "firecrawl_interact_stop",
  "arguments": {
    "scrapeId": "scrape-id-here"
  }
}

12. अनुसंधान उपकरण (`firecrawl_research_*`)

अनुसंधान MCP उपकरणों के माध्यम से पेपर और GitHub रिपॉजिटरी खोजें और उनका निरीक्षण करें।

उपलब्ध अनुसंधान उपकरण:

firecrawl_research_search_papers: शोध पत्र खोजें।
firecrawl_research_inspect_paper: एक पेपर का निरीक्षण करें।
firecrawl_research_related_papers: संबंधित पेपर खोजें।
firecrawl_research_read_paper: पेपर सामग्री पढ़ें।
firecrawl_research_search_github: GitHub रिपॉजिटरी खोजें।

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

13. मॉनिटर उपकरण (`firecrawl_monitor_*`)

आवर्ती पृष्ठ मॉनिटर बनाएँ और प्रबंधित करें। मॉनिटर निर्धारित स्क्रैप या क्रॉल चलाते हैं, प्रत्येक परिणाम की तुलना अंतिम बनाए रखे गए स्नैपशॉट से करते हैं, और वेबहुक या ईमेल द्वारा सूचित कर सकते हैं।

इसके लिए सर्वोत्तम:

समय के साथ एक पृष्ठ या कुछ पृष्ठों पर नज़र रखना
सादे-अंग्रेजी लक्ष्य का उपयोग करके सार्थक परिवर्तनों पर सचेत करना
जाँच इतिहास और पृष्ठ-स्तरीय अंतरों पर नज़र रखना

अनुशंसित निर्माण पैटर्न:

page या pages और goal का उपयोग करें। MCP सर्वर 30-मिनट के शेड्यूल के साथ मॉनिटर अनुरोध बनाता है और API स्वचालित रूप से सार्थक-परिवर्तन निर्णयन सक्षम करता है।

जब goal सेट होता है तो सार्थक-परिवर्तन निर्णयन स्वचालित रूप से चलता है। पृष्ठ वेबहुक monitor.page घटनाओं पर isMeaningful और judgment को उजागर करते हैं।

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

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "page": "https://example.com/pricing",
    "goal": "Alert when pricing, packaging, or launch messaging changes."
  }
}

वेबहुक के साथ एकाधिक पृष्ठ:

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "pages": ["https://example.com/pricing", "https://example.com/changelog"],
    "goal": "Alert when pricing, packaging, or launch messaging changes.",
    "webhookUrl": "https://example.com/webhooks/firecrawl"
  }
}

उन्नत निर्माण अनुरोध:

जब आपको क्रॉल लक्ष्य, JSON परिवर्तन ट्रैकिंग, कस्टम अवधारण, या स्पष्ट judgeEnabled नियंत्रण की आवश्यकता हो तो body पास करें।

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "body": {
      "name": "Docs monitor",
      "schedule": { "text": "hourly", "timezone": "UTC" },
      "goal": "Alert when docs pages add, remove, or materially change API behavior.",
      "targets": [{ "type": "crawl", "url": "https://example.com/docs" }]
    }
  }
}

अन्य मॉनिटर उपकरण:

firecrawl_monitor_list: मॉनिटरों की सूची बनाएँ।
firecrawl_monitor_get: एक मॉनिटर प्राप्त करें।
firecrawl_monitor_update: goal, judgeEnabled, webhook, और notification सहित फ़ील्ड अपडेट करें।
firecrawl_monitor_run: अभी जाँच शुरू करें।
firecrawl_monitor_delete: मॉनिटर हटाएँ (विनाशकारी; केवल तभी कॉल करें जब उपयोगकर्ता इसे हटाना चाहता हो)।
firecrawl_monitor_checks: जाँचों की सूची बनाएँ, वैकल्पिक रूप से स्थिति के अनुसार फ़िल्टर की गई।
firecrawl_monitor_check: diff, snapshot, judgment.meaningful, और judgment.meaningfulChanges सहित पृष्ठ-स्तरीय परिणाम प्राप्त करें।

लॉगिंग प्रणाली

सर्वर में व्यापक लॉगिंग शामिल है:

संचालन की स्थिति और प्रगति
प्रदर्शन मीट्रिक
दर सीमा ट्रैकिंग
त्रुटि स्थितियाँ

उदाहरण लॉग संदेश:

[INFO] Firecrawl MCP Server initialized successfully
[INFO] Starting scrape for URL: https://example.com
[ERROR] Rate limit exceeded

त्रुटि प्रबंधन

सर्वर मजबूत त्रुटि प्रबंधन प्रदान करता है:

API दर-सीमा त्रुटियाँ MCP क्लाइंट को दिखाई जाती हैं
विस्तृत त्रुटि संदेश
नेटवर्क लचीलापन

उदाहरण त्रुटि प्रतिक्रिया:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Rate limit exceeded"
    }
  ],
  "isError": true
}

विकास

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

योगदान करना

रिपॉजिटरी को फोर्क करें
अपनी सुविधा शाखा बनाएँ
परीक्षण चलाएँ: npm test
पुल अनुरोध सबमिट करें

योगदानकर्ताओं को धन्यवाद

प्रारंभिक कार्यान्वयन के लिए @vrknetha, @cawstudios का धन्यवाद!

होस्टिंग के लिए MCP.so और Klavis AI का तथा हमारे सर्वर को एकीकृत करने के लिए @gstarwd, @xiangkaiz और @zihaolin96 का धन्यवाद।

लाइसेंस

MIT लाइसेंस - विवरण के लिए LICENSE फ़ाइल देखें

Firecrawl MCP

Firecrawl MCP के साथ आप क्या कर सकते हैं?

दस्तावेज़

Firecrawl MCP सर्वर

विशेषताएँ

स्थापना

होस्टेड MCP (की-रहित मुफ़्त स्तर)

केवल-खोज एंडपॉइंट

npx के साथ चलाना

मैन्युअल स्थापना

Cursor पर चलाना

Windsurf पर चलाना

स्ट्रीमेबल HTTP स्थानीय मोड के साथ चलाना

Smithery के माध्यम से स्थापित करना (विरासत)

VS Code पर चलाना

कॉन्फ़िगरेशन

पर्यावरण चर

क्लाउड API के लिए आवश्यक

MCP OAuth (बियरर एक्सेस टोकन)

केवल-खोज सतह (होस्टेड)

कॉन्फ़िगरेशन उदाहरण

Claude Desktop के साथ उपयोग

उपकरण कैसे चुनें

त्वरित संदर्भ तालिका

प्रारूप चयन गाइड

उपलब्ध उपकरण

1. स्क्रैप उपकरण (firecrawl_scrape)

2. मैप उपकरण (firecrawl_map)

3. खोज उपकरण (firecrawl_search)

3b. खोज प्रतिक्रिया उपकरण (firecrawl_search_feedback)

3c. सामान्य प्रतिक्रिया उपकरण (firecrawl_feedback)

4. क्रॉल उपकरण (firecrawl_crawl)

5. क्रॉल स्थिति जाँचें (firecrawl_check_crawl_status)

6. पार्स उपकरण (firecrawl_parse)

7. निष्कर्षण उपकरण (firecrawl_extract)

8. एजेंट उपकरण (firecrawl_agent)

9. एजेंट स्थिति जाँचें (firecrawl_agent_status)

10. इंटरैक्ट उपकरण (firecrawl_interact)

11. इंटरैक्ट रोकें उपकरण (firecrawl_interact_stop)

12. अनुसंधान उपकरण (firecrawl_research_*)

13. मॉनिटर उपकरण (firecrawl_monitor_*)

लॉगिंग प्रणाली

त्रुटि प्रबंधन

विकास

योगदान करना

योगदानकर्ताओं को धन्यवाद

लाइसेंस

1. स्क्रैप उपकरण (`firecrawl_scrape`)

2. मैप उपकरण (`firecrawl_map`)

3. खोज उपकरण (`firecrawl_search`)

3b. खोज प्रतिक्रिया उपकरण (`firecrawl_search_feedback`)

3c. सामान्य प्रतिक्रिया उपकरण (`firecrawl_feedback`)

4. क्रॉल उपकरण (`firecrawl_crawl`)

5. क्रॉल स्थिति जाँचें (`firecrawl_check_crawl_status`)

6. पार्स उपकरण (`firecrawl_parse`)

7. निष्कर्षण उपकरण (`firecrawl_extract`)

8. एजेंट उपकरण (`firecrawl_agent`)

9. एजेंट स्थिति जाँचें (`firecrawl_agent_status`)

10. इंटरैक्ट उपकरण (`firecrawl_interact`)

11. इंटरैक्ट रोकें उपकरण (`firecrawl_interact_stop`)

12. अनुसंधान उपकरण (`firecrawl_research_*`)

13. मॉनिटर उपकरण (`firecrawl_monitor_*`)