FireCrawl
FireCrawl 爬取并转换任何网站为 LLM 就绪数据。 它爬取所有可访问的子页面，并为每个页面提供干净的 Markdown 和元数据。 不需要站点地图。
FireCrawl 处理复杂的任务，如反向代理、缓存、速率限制和由 JavaScript 阻止的内容。 由 mendable.ai 团队构建。
概述
集成细节
| 类 | 包 | 本地 | 可序列化 | JS 支持 |
|---|---|---|---|---|
| FireCrawlLoader | langchain_community | ✅ | ❌ | ✅ |
加载器功能
| 来源 | 文档延迟加载 | 原生异步支持 |
|---|---|---|
| FireCrawlLoader | ✅ | ❌ |
设置
凭据
您需要获取自己的 API 密钥。 转到 此页面 了解更多信息。
import getpass
import os
if "FIRECRAWL_API_KEY" not in os.environ:
os.environ["FIRECRAWL_API_KEY"] = getpass.getpass("Enter your Firecrawl API key: ")
安装
您需要安装 langchain_community 和 firecrawl-py 包。
%pip install -qU firecrawl-py==0.0.20 langchain_community
初始化
模式
scrape：抓取单个 URL 并返回 Markdown。crawl：爬取 URL 和所有可访问的子页面，并返回每个页面的 Markdown。
from langchain_community.document_loaders import FireCrawlLoader
loader = FireCrawlLoader(url="https://firecrawl.dev", mode="crawl")
API 参考：FireCrawlLoader
加载
docs = loader.load()
docs[0]
Document(metadata={'ogUrl': 'https://www.firecrawl.dev/', 'title': 'Home - Firecrawl', 'robots': 'follow, index', 'ogImage': 'https://www.firecrawl.dev/og.png?123', 'ogTitle': 'Firecrawl', 'sitemap': {'lastmod': '2024-08-12T00:28:16.681Z', 'changefreq': 'weekly'}, 'keywords': 'Firecrawl,Markdown,Data,Mendable,Langchain', 'sourceURL': 'https://www.firecrawl.dev/', 'ogSiteName': 'Firecrawl', 'description': 'Firecrawl crawls and converts any website into clean markdown.', 'ogDescription': 'Turn any website into LLM-ready data.', 'pageStatusCode': 200, 'ogLocaleAlternate': []}, page_content='Introducing [Smart Crawl!](https://www.firecrawl.dev/smart-crawl)\n Join the waitlist to turn any website into an API with AI\n\n\n\n[🔥 Firecrawl](/)\n\n* [Playground](/playground)\n \n* [Docs](https://docs.firecrawl.dev)\n \n* [Pricing](/pricing)\n \n* [Blog](/blog)\n \n* Beta Features\n\n[Log In](/signin)\n[Log In](/signin)\n[Sign Up](/signin/signup)\n 8.9k\n\n[💥 Get 2 months free with yearly plan](/pricing)\n\nTurn websites into \n_LLM-ready_ data\n=====================================\n\nPower your AI apps with clean data crawled from any website. It\'s also open-source.\n\nStart for free (500 credits)Start for free[Talk to us](https://calendly.com/d/cj83-ngq-knk/meet-firecrawl)\n\nA product by\n\n[Mendable](https://mendable.ai)\n\n\n\nCrawl, Scrape, Clean\n--------------------\n\nWe crawl all accessible subpages and give you clean markdown for each. No sitemap required.\n\n \n [\\\n {\\\n "url": "https://www.firecrawl.dev/",\\\n "markdown": "## Welcome to Firecrawl\\\n Firecrawl is a web scraper that allows you to extract the content of a webpage."\\\n },\\\n {\\\n "url": "https://www.firecrawl.dev/features",\\\n "markdown": "## Features\\\n Discover how Firecrawl\'s cutting-edge features can \\\n transform your data operations."\\\n },\\\n {\\\n "url": "https://www.firecrawl.dev/pricing",\\\n "markdown": "## Pricing Plans\\\n Choose the perfect plan that fits your needs."\\\n },\\\n {\\\n "url": "https://www.firecrawl.dev/about",\\\n "markdown": "## About Us\\\n Learn more about Firecrawl\'s mission and the \\\n team behind our innovative platform."\\\n }\\\n ]\n \n\nNote: The markdown has been edited for display purposes.\n\nTrusted by Top Companies\n------------------------\n\n[](https://www.zapier.com)\n\n[](https://gamma.app)\n\n[](https://www.nvidia.com)\n\n[](https://www.teller.io)\n\n[](https://www.stack-ai.com)\n\n[](https://www.palladiumdigital.co.uk)\n\n[](https://www.worldwide-casting.com)\n\n[](https://www.open.gov.sg)\n\n[](https://www.bain.com)\n\n[](https://www.demand.io)\n\n[](https://www.nocodegarden.io)\n\n[](https://www.cyberagent.co.jp)\n\nIntegrate today\n---------------\n\nEnhance your applications with top-tier web scraping and crawling capabilities.\n\n#### Scrape\n\nExtract markdown or structured data from websites quickly and efficiently.\n\n#### Crawling\n\nNavigate and retrieve data from all accessible subpages, even without a sitemap.\n\nNode.js\n\nPython\n\ncURL\n\n1\n\n2\n\n3\n\n4\n\n5\n\n6\n\n7\n\n8\n\n9\n\n10\n\n// npm install @mendable/firecrawl-js \n \nimport FirecrawlApp from \'@mendable/firecrawl-js\'; \n \nconst app \\= new FirecrawlApp({ apiKey: "fc-YOUR\\_API\\_KEY" }); \n \n// Scrape a website: \nconst scrapeResult \\= await app.scrapeUrl(\'firecrawl.dev\'); \n \nconsole.log(scrapeResult.data.markdown)\n\n#### Use well-known tools\n\nAlready fully integrated with the greatest existing tools and workflows.\n\n[](https://docs.llamaindex.ai/en/stable/examples/data_connectors/WebPageDemo/#using-firecrawl-reader/)\n[](https://python.langchain.ac.cn/docs/integrations/document_loaders/firecrawl/)\n[](https://dify.ai/blog/dify-ai-blog-integrated-with-firecrawl/)\n[](https://www.langflow.org/)\n[](https://flowiseai.com/)\n[](https://crewai.com/)\n\n#### Start for free, scale easily\n\nKick off your journey for free and scale seamlessly as your project expands.\n\n[Try it out](/signin/signup)\n\n#### Open-source\n\nDeveloped transparently and collaboratively. Join our community of contributors.\n\n[Check out our repo](https://github.com/mendableai/firecrawl)\n\nWe handle the hard stuff\n------------------------\n\nRotating proxies, caching, rate limits, js-blocked content and more\n\n#### Crawling\n\nFirecrawl crawls all accessible subpages, even without a sitemap.\n\n#### Dynamic content\n\nFirecrawl gathers data even if a website uses javascript to render content.\n\n#### To Markdown\n\nFirecrawl returns clean, well formatted markdown - ready for use in LLM applications\n\n#### Crawling Orchestration\n\nFirecrawl orchestrates the crawling process in parallel for the fastest results.\n\n#### Caching\n\nFirecrawl caches content, so you don\'t have to wait for a full scrape unless new content exists.\n\n#### Built for AI\n\nBuilt by LLM engineers, for LLM engineers. Giving you clean data the way you want it.\n\nOur wall of love\n\nDon\'t take our word for it\n--------------------------\n\n\n\nGreg Kamradt\n\n[@GregKamradt](https://twitter.com/GregKamradt/status/1780300642197840307)\n\nLLM structured data via API, handling requests, cleaning, and crawling. Enjoyed the early preview.\n\n\n\nAmit Naik\n\n[@suprgeek](https://twitter.com/suprgeek/status/1780338213351035254)\n\n#llm success with RAG relies on Retrieval. Firecrawl by @mendableai structures web content for processing. 👏\n\n\n\nJerry Liu\n\n[@jerryjliu0](https://twitter.com/jerryjliu0/status/1781122933349572772)\n\nFirecrawl is awesome 🔥 Turns web pages into structured markdown for LLM apps, thanks to @mendableai.\n\n\n\nBardia Pourvakil\n\n[@thepericulum](https://twitter.com/thepericulum/status/1781397799487078874)\n\nThese guys ship. I wanted types for their node SDK, and less than an hour later, I got them. Can\'t recommend them enough.\n\n\n\nlatentsauce 🧘🏽\n\n[@latentsauce](https://twitter.com/latentsauce/status/1781738253927735331)\n\nFirecrawl simplifies data preparation significantly, exactly what I was hoping for. Thank you for creating Firecrawl ❤️❤️❤️\n\n\n\nGreg Kamradt\n\n[@GregKamradt](https://twitter.com/GregKamradt/status/1780300642197840307)\n\nLLM structured data via API, handling requests, cleaning, and crawling. Enjoyed the early preview.\n\n\n\nAmit Naik\n\n[@suprgeek](https://twitter.com/suprgeek/status/1780338213351035254)\n\n#llm success with RAG relies on Retrieval. Firecrawl by @mendableai structures web content for processing. 👏\n\n\n\nJerry Liu\n\n[@jerryjliu0](https://twitter.com/jerryjliu0/status/1781122933349572772)\n\nFirecrawl is awesome 🔥 Turns web pages into structured markdown for LLM apps, thanks to @mendableai.\n\n\n\nBardia Pourvakil\n\n[@thepericulum](https://twitter.com/thepericulum/status/1781397799487078874)\n\nThese guys ship. I wanted types for their node SDK, and less than an hour later, I got them. Can\'t recommend them enough.\n\n\n\nlatentsauce 🧘🏽\n\n[@latentsauce](https://twitter.com/latentsauce/status/1781738253927735331)\n\nFirecrawl simplifies data preparation significantly, exactly what I was hoping for. Thank you for creating Firecrawl ❤️❤️❤️\n\n\n\nMichael Ning\n\n[](#)\n\nFirecrawl is impressive, saving us 2/3 the tokens and allowing gpt3.5turbo use over gpt4. Major savings in time and money.\n\n\n\nAlex Reibman 🖇️\n\n[@AlexReibman](https://twitter.com/AlexReibman/status/1780299595484131836)\n\nMoved our internal agent\'s web scraping tool from Apify to Firecrawl because it benchmarked 50x faster with AgentOps.\n\n\n\nMichael\n\n[@michael\\_chomsky](#)\n\nI really like some of the design decisions Firecrawl made, so I really want to share with others.\n\n\n\nPaul Scott\n\n[@palebluepaul](https://twitter.com/palebluepaul)\n\nAppreciating your lean approach, Firecrawl ticks off everything on our list without the cost prohibitive overkill.\n\n\n\nMichael Ning\n\n[](#)\n\nFirecrawl is impressive, saving us 2/3 the tokens and allowing gpt3.5turbo use over gpt4. Major savings in time and money.\n\n\n\nAlex Reibman 🖇️\n\n[@AlexReibman](https://twitter.com/AlexReibman/status/1780299595484131836)\n\nMoved our internal agent\'s web scraping tool from Apify to Firecrawl because it benchmarked 50x faster with AgentOps.\n\n\n\nMichael\n\n[@michael\\_chomsky](#)\n\nI really like some of the design decisions Firecrawl made, so I really want to share with others.\n\n\n\nPaul Scott\n\n[@palebluepaul](https://twitter.com/palebluepaul)\n\nAppreciating your lean approach, Firecrawl ticks off everything on our list without the cost prohibitive overkill.\n\nFlexible Pricing\n----------------\n\nStart for free, then scale as you grow\n\nYearly (17% off)Yearly (2 months free)Monthly\n\nFree Plan\n---------\n\n500 credits\n\n$0/month\n\n* Scrape 500 pages\n* 5 /scrape per min\n* 1 /crawl per min\n\nGet Started\n\nHobby\n-----\n\n3,000 credits\n\n$16/month\n\n* Scrape 3,000 pages\n* 10 /scrape per min\n* 3 /crawl per min\n\nSubscribe\n\nStandardMost Popular\n--------------------\n\n100,000 credits\n\n$83/month\n\n* Scrape 100,000 pages\n* 50 /scrape per min\n* 10 /crawl per min\n\nSubscribe\n\nGrowth\n------\n\n500,000 credits\n\n$333/month\n\n* Scrape 500,000 pages\n* 500 /scrape per min\n* 50 /crawl per min\n* Priority Support\n\nSubscribe\n\nEnterprise Plan\n---------------\n\nUnlimited credits. Custom RPMs.\n\nTalk to us\n\n* Top priority support\n* Feature Acceleration\n* SLAs\n* Account Manager\n* Custom rate limits volume\n* Custom concurrency limits\n* Beta features access\n* CEO\'s number\n\n\\* a /scrape refers to the [scrape](https://docs.firecrawl.dev/api-reference/endpoint/scrape)\n API endpoint.\n\n\\* a /crawl refers to the [crawl](https://docs.firecrawl.dev/api-reference/endpoint/crawl)\n API endpoint.\n\nScrape Credits\n--------------\n\nScrape credits are consumed for each API request, varying by endpoint and feature.\n\n| Features | Credits per page |\n| --- | --- |\n| Scrape(/scrape) | 1 |\n| Crawl(/crawl) | 1 |\n| Search(/search) | 1 |\n| Scrape + LLM extraction (/scrape) | 50 |\n\n[🔥](/)\n\nReady to _Build?_\n-----------------\n\nStart scraping web data for your AI apps today. \nNo credit card needed.\n\n[Get Started](/signin)\n\n[Talk to us](https://calendly.com/d/cj83-ngq-knk/meet-firecrawl)\n\nFAQ\n---\n\nFrequently asked questions about Firecrawl\n\n#### General\n\nWhat is Firecrawl?\n\nFirecrawl turns entire websites into clean, LLM-ready markdown or structured data. Scrape, crawl and extract the web with a single API. Ideal for AI companies looking to empower their LLM applications with web data.\n\nWhat sites work?\n\nFirecrawl is best suited for business websites, docs and help centers. We currently don\'t support social media platforms.\n\nWho can benefit from using Firecrawl?\n\nFirecrawl is tailored for LLM engineers, data scientists, AI researchers, and developers looking to harness web data for training machine learning models, market research, content aggregation, and more. It simplifies the data preparation process, allowing professionals to focus on insights and model development.\n\nIs Firecrawl open-source?\n\nYes, it is. You can check out the repository on GitHub. Keep in mind that this repository is currently in its early stages of development. We are in the process of merging custom modules into this mono repository.\n\n#### Scraping & Crawling\n\nHow does Firecrawl handle dynamic content on websites?\n\nUnlike traditional web scrapers, Firecrawl is equipped to handle dynamic content rendered with JavaScript. It ensures comprehensive data collection from all accessible subpages, making it a reliable tool for scraping websites that rely heavily on JS for content delivery.\n\nWhy is it not crawling all the pages?\n\nThere are a few reasons why Firecrawl may not be able to crawl all the pages of a website. Some common reasons include rate limiting, and anti-scraping mechanisms, disallowing the crawler from accessing certain pages. If you\'re experiencing issues with the crawler, please reach out to our support team at [email protected].\n\nCan Firecrawl crawl websites without a sitemap?\n\nYes, Firecrawl can access and crawl all accessible subpages of a website, even in the absence of a sitemap. This feature enables users to gather data from a wide array of web sources with minimal setup.\n\nWhat formats can Firecrawl convert web data into?\n\nFirecrawl specializes in converting web data into clean, well-formatted markdown. This format is particularly suited for LLM applications, offering a structured yet flexible way to represent web content.\n\nHow does Firecrawl ensure the cleanliness of the data?\n\nFirecrawl employs advanced algorithms to clean and structure the scraped data, removing unnecessary elements and formatting the content into readable markdown. This process ensures that the data is ready for use in LLM applications without further preprocessing.\n\nIs Firecrawl suitable for large-scale data scraping projects?\n\nAbsolutely. Firecrawl offers various pricing plans, including a Scale plan that supports scraping of millions of pages. With features like caching and scheduled syncs, it\'s designed to efficiently handle large-scale data scraping and continuous updates, making it ideal for enterprises and large projects.\n\nDoes it respect robots.txt?\n\nYes, Firecrawl crawler respects the rules set in a website\'s robots.txt file. If you notice any issues with the way Firecrawl interacts with your website, you can adjust the robots.txt file to control the crawler\'s behavior. Firecrawl user agent name is \'FirecrawlAgent\'. If you notice any behavior that is not expected, please let us know at [email protected].\n\nWhat measures does Firecrawl take to handle web scraping challenges like rate limits and caching?\n\nFirecrawl is built to navigate common web scraping challenges, including reverse proxies, rate limits, and caching. It smartly manages requests and employs caching techniques to minimize bandwidth usage and avoid triggering anti-scraping mechanisms, ensuring reliable data collection.\n\nDoes Firecrawl handle captcha or authentication?\n\nFirecrawl avoids captcha by using stealth proxyies. When it encounters captcha, it attempts to solve it automatically, but this is not always possible. We are working to add support for more captcha solving methods. Firecrawl can handle authentication by providing auth headers to the API.\n\n#### API Related\n\nWhere can I find my API key?\n\nClick on the dashboard button on the top navigation menu when logged in and you will find your API key in the main screen and under API Keys.\n\n#### Billing\n\nIs Firecrawl free?\n\nFirecrawl is free for the first 500 scraped pages (500 free credits). After that, you can upgrade to our Standard or Scale plans for more credits.\n\nIs there a pay per use plan instead of monthly?\n\nNo we do not currently offer a pay per use plan, instead you can upgrade to our Standard or Growth plans for more credits and higher rate limits.\n\nHow many credit does scraping, crawling, and extraction cost?\n\nScraping costs 1 credit per page. Crawling costs 1 credit per page.\n\nDo you charge for failed requests (scrape, crawl, extract)?\n\nWe do not charge for any failed requests (scrape, crawl, extract). Please contact support at [email protected] if you have any questions.\n\nWhat payment methods do you accept?\n\nWe accept payments through Stripe which accepts most major credit cards, debit cards, and PayPal.\n\n[🔥](/)\n\n© A product by Mendable.ai - All rights reserved.\n\n[StatusStatus](https://firecrawl.betteruptime.com)\n[Terms of ServiceTerms of Service](/terms-of-service)\n[Privacy PolicyPrivacy Policy](/privacy-policy)\n\n[Twitter](https://twitter.com/mendableai)\n[GitHub](https://github.com/mendableai)\n[Discord](https://discord.gg/gSmWdAkdwd)\n\n###### Helpful Links\n\n* [Status](https://firecrawl.betteruptime.com/)\n \n* [Pricing](/pricing)\n \n* [Blog](https://www.firecrawl.dev/blog)\n \n* [Docs](https://docs.firecrawl.dev)\n \n\nBacked by\n\n\n\n###### Resources\n\n* [Community](#0)\n \n* [Terms of service](#0)\n \n* [Collaboration features](#0)\n \n\n###### Legals\n\n* [Refund policy](#0)\n \n* [Terms & Conditions](#0)\n \n* [Privacy policy](#0)\n \n* [Brand Kit](#0)')
print(docs[0].metadata)
{'ogUrl': 'https://www.firecrawl.dev/', 'title': 'Home - Firecrawl', 'robots': 'follow, index', 'ogImage': 'https://www.firecrawl.dev/og.png?123', 'ogTitle': 'Firecrawl', 'sitemap': {'lastmod': '2024-08-12T00:28:16.681Z', 'changefreq': 'weekly'}, 'keywords': 'Firecrawl,Markdown,Data,Mendable,Langchain', 'sourceURL': 'https://www.firecrawl.dev/', 'ogSiteName': 'Firecrawl', 'description': 'Firecrawl crawls and converts any website into clean markdown.', 'ogDescription': 'Turn any website into LLM-ready data.', 'pageStatusCode': 200, 'ogLocaleAlternate': []}
延迟加载
您可以使用延迟加载来最大程度地减少内存需求。
pages = []
for doc in loader.lazy_load():
pages.append(doc)
if len(pages) >= 10:
# do some paged operation, e.g.
# index.upsert(page)
pages = []
len(pages)
8
print(pages[0].page_content[:100])
print(pages[0].metadata)
Introducing [Smart Crawl!](https://www.firecrawl.dev/smart-crawl)
Join the waitlist to turn any web
{'ogUrl': 'https://www.firecrawl.dev/blog/introducing-fire-engine-for-firecrawl', 'title': 'Introducing Fire Engine for Firecrawl', 'robots': 'follow, index', 'ogImage': 'https://www.firecrawl.dev/images/blog/fire-engine-launch.png', 'ogTitle': 'Introducing Fire Engine for Firecrawl', 'sitemap': {'lastmod': '2024-08-06T00:00:00.000Z', 'changefreq': 'weekly'}, 'keywords': 'firecrawl,fireengine,web crawling,dashboard,web scraping,LLM,data extraction', 'sourceURL': 'https://www.firecrawl.dev/blog/introducing-fire-engine-for-firecrawl', 'ogSiteName': 'Firecrawl', 'description': 'The most scalable, reliable, and fast way to get web data for Firecrawl.', 'ogDescription': 'The most scalable, reliable, and fast way to get web data for Firecrawl.', 'pageStatusCode': 200, 'ogLocaleAlternate': []}
爬虫选项
您还可以将 params 传递给加载器。 这是一个字典，其中包含要传递给爬虫的选项。 有关更多信息，请参阅 FireCrawl API 文档。
API 参考
有关所有 FireCrawlLoader 功能和配置的详细文档，请访问 API 参考： https://python.langchain.ac.cn/api_reference/community/document_loaders/langchain_community.document_loaders.firecrawl.FireCrawlLoader.html