بداية سريعة
This guide covers every Firecrawl feature:
- ابدء — Create a firecrawl account and set your api key
- How to Use Scrape — Pull llm ready data from single web pages
- How to Use Crawl — Crawl entire websites and follow every link
- كيفية استخدام البحث — Search the web for real time web data
- How to Use Map — Run url discovery across individual pages
- How to Use Extract — Extract structured data with natural language prompts
الوقت اللازم: خمس دقائق لكل فقرة
يتضمن هذا الدليل أيضًا ما يلي: نصائح احترافية | الأخطاء الشائعة | استكشاف الأخطاء وإصلاحها | التسعير | البدائل
لماذا تثق بهذا الدليل؟
I have used Firecrawl for over a year and tested every feature covered here.
This tutorial on how to use Firecrawl comes from real hands-on web scraping work.
Firecrawl is an ai powered web crawler that turns websites into clean, llm ready data.
But most users only scratch the surface of what this versatile tool can do.
This guide shows you how to use every major feature, step by step, with screenshots.
Firecrawl Tutorial
This complete Firecrawl tutorial walks you through every feature, from your first api key to advanced batch operations that make you a power user.
فايركراول
Turn any website into clean, structured data with a single api. Firecrawl handles javascript rendering, rate limits, and url discovery so you get llm ready data fast. Start on the free plan — no credit card needed.
Getting Started with Firecrawl
قبل استخدام أي ميزة، أكمل هذا الإعداد لمرة واحدة.
يستغرق الأمر حوالي 3 دقائق.
شاهد هذا العرض الموجز أولاً:
والآن دعونا نستعرض كل خطوة.
الخطوة الأولى: إنشاء حسابك
Go to the Firecrawl website at https://www.firecrawl.dev.
Click “Sign Up” to open a firecrawl account on the free plan.
أدخل بريدك الإلكتروني وأنشئ كلمة مرور.
✓ نقطة تفتيش: تحقق من صندوق الوارد للحصول على رسالة تأكيد عبر البريد الإلكتروني.
Step 2: Install and Set Your API Key
Run pip install firecrawl-py to add the api service to your project.
Copy your api key, then save it as an environment variable for حماية.
هذا هو شكل لوحة التحكم:
✓ نقطة تفتيش: You should see the main dashboard with your usage and api key.
Step 3: Make Your First Call
Import the FirecrawlApp class and create a firecrawl instance with your key.
Every request hits the base endpoint at https://api.firecrawl.dev/v2.
✅ تم: You’re ready to scrape, crawl, search, map, and extract data.
How to Use Firecrawl Scraper
Scrape lets you pull clean, llm ready data from a single page with one single api call.
Scrape mode targets individual pages and is ideal for extracting specific details fast.
إليك كيفية استخدامه خطوة بخطوة.
والآن دعونا نحلل كل خطوة على حدة.
الخطوة 1: الحصول على مفتاح API الخاص بك
Create a firecrawl account, then copy your api key from the dashboard.
Store it as an environment variable so your api key stays out of your raw code.
Step 2: Call the Scrape Endpoint
Pass a single url to the .scrape_url() method on your firecrawl instance.
You can request markdown format, raw html, or structured json as the output.
هذا ما يبدو عليه الأمر:
✓ نقطة تفتيش: You should see clean markdown for the current page, ready for ai applications.
Step 3: Read the Clean Output
Firecrawl returns clean data with readable نص, stripped of junk html tags.
✅ النتيجة: You turned one of the web pages into structured web data with a single api.
💡 نصيحة احترافية: Set the max_age parameter to cache results and skip re-scraping a page that has not changed.
How to Use Firecrawl Crawler
Crawl lets you crawl entire websites and follow links automatically without a sitemap.
Crawl mode lets you crawl websites across multiple pages and collect every reachable page.
إليك كيفية استخدامه خطوة بخطوة.
والآن دعونا نحلل كل خطوة على حدة.
Step 1: Point at a Root URL
Give the crawl endpoint a starting url such as https://example.com.
Firecrawl handles web crawling through links and follows pages on its own.
Step 2: Start the Crawl Job
Launch the crawl job and grab the returned job id to track progress.
Use the job id to poll status and pull crawled data as each page finishes.
هذا ما يبدو عليه الأمر:
✓ نقطة تفتيش: You should see scraped pages from across the site building into web data.
الخطوة 3: تصدير النتائج
Collect every page as markdown or structured json for your data pipelines.
✅ النتيجة: You captured an entire site, even complex websites with dynamic content.
💡 نصيحة احترافية: Firecrawl uses batch processing and concurrent browsers, so large crawl operations stay fast.
How to Use Firecrawl Search Engine
يبحث lets you search the web and return clean results you can feed straight into ai agents.
Search lets you query the web and pull back real time web data as readable text.
إليك كيفية استخدامه خطوة بخطوة.
والآن دعونا نحلل كل خطوة على حدة.
Step 1: Send a Query
Call the search endpoint with a plain natural language query.
Firecrawl can search the web across news websites, job boards, and review sites.
الخطوة الثانية: اختيار تنسيق الإخراج
Ask for markdown format or structured json for each result.
Every result arrives as clean data, not noisy raw html.
هذا ما يبدو عليه الأمر:
✓ نقطة تفتيش: You should see ranked web pages returned as structured web data.
Step 3: Pipe Into Your App
Feed the structured data into مساعدون يعملون بالذكاء الاصطناعي or ai workflows.
✅ النتيجة: You added live web content to your ai applications in a single api call.
💡 نصيحة احترافية: Pair search with extract to gather news articles for market research or competitive intelligence.
How to Use Firecrawl Advanced Map
Map lets you run url discovery and turn one domain into a full map of individual pages.
Map mode retrieves every url on a site quickly for fast url discovery.
إليك كيفية استخدامه خطوة بخطوة.
والآن دعونا نحلل كل خطوة على حدة.
Step 1: Submit the Domain
Pass a single root url to the map endpoint.
Firecrawl returns every link without needing a sitemap.
Step 2: Review the URL List
Scan the returned individual pages before you scrape them.
Save the list to a csv file to plan your data extraction.
هذا ما يبدو عليه الأمر:
✓ نقطة تفتيش: You should see a full sitemap of web pages from one single url.
Step 3: Select What to Scrape
Pick the pages you want, then send them to scrape or crawl.
✅ النتيجة: You mapped the whole site, ready for targeted web scraping.
💡 نصيحة احترافية: Map first on dynamic websites and web apps to avoid wasting credits on pages you do not need.
How to Use Firecrawl Extractor
يستخرج lets you extract structured data from any page using natural language prompts.
Extract uses ai powered parsing to pull exactly the fields you describe.
إليك كيفية استخدامه خطوة بخطوة.
والآن دعونا نحلل كل خطوة على حدة.
Step 1: Define a Schema
Write a Pydantic model with: from pydantic import BaseModel.
Schema based extraction tells Firecrawl which fields to return as structured json.
Step 2: Describe the Data
Add natural language prompts for fields a schema cannot capture.
This is how you extract data from web pages without writing parsing rules.
هذا ما يبدو عليه الأمر:
✓ نقطة تفتيش: You should see tidy structured data instead of messy html tags.
Step 3: Receive Structured JSON
Firecrawl returns clean structured json ready for training data.
✅ النتيجة: You replaced fragile scrapers with one extract call and less data cleaning.
💡 نصيحة احترافية: Use only_main_content, include_tags, and exclude_tags to keep the extracted web data focused.
Firecrawl Pro Tips and Shortcuts
After testing Firecrawl for over a year, here are my best tips for cleaner data extraction.
اختصارات لوحة المفاتيح
| فعل | اختصار |
|---|---|
| Run scrape in playground | Ctrl + Enter |
| Copy api key | Ctrl + C |
| Open docs | Ctrl + K |
| Switch output format | فاتورة غير مدفوعة |
ميزات خفية يغفل عنها معظم الناس
- max_age caching: Reuse recent crawled data for faster, cheaper repeat scraping.
- Browser actions: Click, scroll, and type to reach content behind javascript rendering.
- Async batching: Process thousands of urls with batch processing without blocking your web apps.
Firecrawl Common Mistakes to Avoid
Mistake #1: Hardcoding your API key
❌ خطأ: Pasting your api key directly into shared code or a public repo.
✅ يمين: Load the key from an environment variable so it stays private.
Mistake #2: Crawling before mapping
❌ خطأ: Crawling entire websites blindly and burning credits on junk pages.
✅ يمين: Run url discovery with map first, then crawl only the pages you need.
Mistake #3: Parsing raw html yourself
❌ خطأ: Writing brittle rules to clean raw html and strip html tags by hand.
✅ يمين: Use schema based extraction to get clean structured json directly.
Firecrawl Troubleshooting
Problem: 401 unauthorized errors
سبب: Your api key is missing or not loaded from the environment variable.
يصلح: Re-export the key, then recreate your firecrawl instance and retry.
Problem: Timeout errors on complex websites
سبب: Heavy javascript rendering or dynamic content takes longer to load.
يصلح: Add a wait action so the current page finishes loading before capture.
Problem: Hitting rate limits
سبب: Too many requests at once on the free plan or a lower tier.
يصلح: Slow batch operations or upgrade for more concurrent browsers.
📌 ملحوظة: If none of these fix your issue, contact Firecrawl support.
ما هو فايركراول؟
فايركراول is an ai powered web scraping tool that turns websites into clean, structured data.
Think of it as a web crawler that hands ai agents readable text instead of messy raw html.
Firecrawl was developed by Mendable.ai to reduce token waste for ai applications.
شاهد هذه النظرة العامة السريعة:
يتضمن هذا المنتج الميزات الرئيسية التالية:
- كشط: Extract data from single web pages as markdown format or structured json.
- الزحف: Crawl entire websites and follow links without a sitemap.
- يبحث: Search the web and return clean data from news websites and review sites.
- رسم خريطة: Fast url discovery that turns one domain into a full sitemap.
- Extract: Pull structured web data using natural language prompts and Pydantic schemas.
Firecrawl beats traditional web scraping by handling proxies, rate limits, and javascript rendering for you.
Unlike traditional tools that need Selenium, it serves data scientists and developers through one api service.
للاطلاع على مراجعة كاملة، راجع Firecrawl review.
أسعار لعبة Firecrawl
Here’s what Firecrawl costs in 2026:
| يخطط | سعر | الأفضل لـ |
|---|---|---|
| حر | حر | Testing scrape and crawl on a few pages |
| هواية | 16 دولارًا شهريًا | Solo developers and small data pipelines |
| معيار | 83 دولارًا شهريًا | Teams running regular web crawling jobs |
| نمو | 333 دولارًا شهريًا | High-volume market research and monitoring |
تجربة مجانية: Yes — the free plan lets you scrape a limited number of pages.
ضمان استرداد الأموال: No formal guarantee, but you can downgrade anytime.
💰 أفضل قيمة: Standard — best balance of credits and concurrent browsers for most teams.
فايركراول مقابل البدائل
How does Firecrawl compare? Here’s the competitive landscape:
| أداة | الأفضل لـ | سعر | تصنيف |
|---|---|---|---|
| فايركراول | AI-ready clean data | 16 دولارًا شهريًا | ⭐ 3.5 |
| أبيفي | Prebuilt actors | 49 دولارًا شهريًا | ⭐ 4.5 |
| بيانات برايت | Proxy scale | $ Custom | ⭐ 4.6 |
| Crawl4AI | المصادر المفتوحة | حر | ⭐ 4.4 |
| سكرابي | Python control | حر | ⭐ 4.5 |
| ScrapeGraphai | LLM graph scraping | 20 دولارًا شهريًا | ⭐ 4.3 |
اختيارات سريعة:
- الأفضل إجمالاً: Firecrawl — cleanest llm ready data from a single api.
- أفضل ميزانية: Crawl4AI — free and open source for hands-on data scientists.
- الأفضل للمبتدئين: Firecrawl — natural language prompts hide the hard parts.
- Best for proxy scale: Bright Data — huge proxy pool for complex websites.
🎯 Firecrawl Alternatives
هل تبحث عن بدائل للعبة Firecrawl؟ إليك أفضل الخيارات:
- 🚀 أبيفي: Marketplace of prebuilt actors for web scraping, good when you want ready-made scrapers over a single api.
- 🏢 بيانات برايت: Enterprise proxy network for huge crawl jobs and content monitoring at scale across dynamic websites.
- 💰 Crawl4AI: Free, open source crawler that outputs llm ready data, ideal for budget ai workflows and local runs.
- 🔧 سكرابي: Battle-tested Python framework giving developers full control over crawling, parsing, and data pipelines.
- 🧠 ScrapeGraphAI: Graph-based, ai powered extraction that maps page structure for schema based extraction of structured data.
للاطلاع على القائمة الكاملة، راجع Firecrawl alternatives مرشد.
⚔️ مقارنة بين فايركراول
إليكم كيف يقارن Firecrawl بكل منافسيه:
- فايركراول ضد أبيفي: Firecrawl wins on clean, llm ready output; Apify wins on its library of prebuilt scrapers.
- مقارنة بين Firecrawl و Bright Data: Bright Data wins on proxy scale; Firecrawl wins on simpler structured data extraction.
- فايركراول ضد كراول 4 إيه آي: Crawl4AI wins on price and self-hosting; Firecrawl wins on managed rate limits and reliability.
- فايركرول ضد سكرابي: Scrapy wins on low-level control; Firecrawl wins on speed and zero proxy setup.
- مقارنة بين Firecrawl و ScrapeGraphAI: Both are ai powered; Firecrawl wins on crawl coverage, ScrapeGraphAI on graph logic.
Start Using Firecrawl Now
You learned how to use every major Firecrawl feature:
- ✅ Scrape
- ✅ Crawl
- ✅ بحث
- ✅ Map
- ✅ Extract
الخطوة التالية: اختر ميزة واحدة وجرّبها الآن.
Most people start with Scrape.
يستغرق الأمر أقل من 5 دقائق.
الأسئلة الشائعة
ما هي استخدامات برنامج Firecrawl؟
Firecrawl is an ai powered web scraping tool. It turns web pages into clean, llm ready data for ai agents, rag systems, market research, and price monitoring.
هل يمكنك استخدام برنامج Firecrawl مجاناً؟
Yes. The free plan lets you scrape a limited number of pages with your api key, so you can test scrape, crawl, and extract before paying.
How do I install Firecrawl?
Run pip install firecrawl-py, then set your api key as an environment variable and create a firecrawl instance to start your first single api call.
How is Firecrawl different from traditional scraping?
Traditional web scraping needs Selenium and manual proxy setup. Firecrawl handles javascript rendering, rate limits, and clean data automatically through one api service.
Can Firecrawl extract structured data?
Yes. Use natural language prompts or a Pydantic schema for schema based extraction, and Firecrawl returns structured json instead of raw html.
English 
Spanish 
Chinese 
German 
French 
Arabic 
Russian 
Portuguese 
Japanese 
Korean 
Italian 
Turkish 
Dutch 
Polish 
Indonesian 
Thai 
Vietnamese 