جدول التوافقCompatibility table
متوافق مع نقاط Firecrawl v2 الأساسية الموضحة في جدول التوافق.Compatible with the core Firecrawl v2 endpoints listed in the compatibility table.
«زاحف» نسخة ١.٠.٠Zahif v1.0.0 · https://claude-crawler.trusted-intel.cc
التوافقCompatibility
متوافق مع نقاط Firecrawl v2 الأساسية الموضحة في جدول التوافقCompatible with the core Firecrawl v2 endpoints listed in the compatibility table.
لا تعمل كل عملاء Firecrawl دون تعديل: راجع حالة كل نقطة وخيار قبل الاعتماد عليه. الخيارات الجزئية موضّح سببها، وغير المدعومة تُرفض أو تُتجاهل كما هو مبيّن.Not every Firecrawl client works unmodified: check the status of each endpoint and option before relying on it. Partial items state their reason; unsupported ones are refused or ignored as shown.
مدعومSupported
مدعوم جزئياًPartial
غير مدعومNot supported
آخر مراجعة: ٢٠٢٦-١١-٠٣.Last reviewed: 2026-11-03. Firecrawl علامة تجارية لمالكها، ولا ارتباط بين «زاحف» وبينها.Firecrawl is a trademark of its owner; Zahif is not affiliated with it.
نقاط النهايةEndpoints
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
POST /v2/scrape | مدعومSupported | مسار الجلب كامل بالغلاف المعتاد.Full scrape pipeline with the standard envelope. |
POST /v2/batch/scrape | مدعومSupported | مهمة خلفية مع دعم invalidURLs وignoreInvalidURLs.Background job; invalidURLs and ignoreInvalidURLs handled. |
GET/DELETE /v2/batch/scrape/{id} | مدعومSupported | حالة مقسّمة بـ next مع الإلغاء.Paged status with next; cancel. |
GET /v2/batch/scrape/{id}/errors | مدعومSupported | يعيد errors وrobotsBlocked.Returns errors and robotsBlocked. |
POST /v2/crawl | مدعومSupported | يعيد {success, id, url}.Returns {success, id, url}. |
GET/DELETE /v2/crawl/{id} | مدعومSupported | حالة مع ترقيم next وإلغاء فوري.Status with next paging; immediate cancel. |
GET /v2/crawl/{id}/errors | مدعومSupported | الشكل نفسه، ومختبر على مستوى المهمة.Same shape; tested at the job level. |
GET /v2/crawl/active | مدعوم جزئياًPartial | الحقل options فارغ دائماً.options is always an empty object. |
POST /v2/crawl/params-preview | مدعومSupported | نموذج لغوي، أو قواعد كلمات مفتاحية عند غيابه.LLM, or keyword rules when no LLM is available. |
POST /v2/map | مدعومSupported | يعيد links [{url, title}].Returns links [{url, title}]. |
POST /v2/search | مدعومSupported | يعيد data.web وnews وimages مع حقل zahif إضافي.data.web / news / images, plus an extra zahif field. |
POST /v2/extract | مدعومSupported | مهمة خلفية، استدلالية أو اقتباسية عند غياب النموذج.Background job; heuristic or extractive when no LLM. |
GET /v2/extract/{id} | مدعوم جزئياًPartial | الحقل sources كائن يضيف مفتاح _pages.sources is an object that adds a _pages key. |
POST /v2/agent | مدعومSupported | مهمة بحث باقتباسات مرقّمة.Research job with numbered citations. |
GET/DELETE /v2/agent/{id} | مدعوم جزئياًPartial | المهمة الملغاة تظهر بحالة failed، ولا يوجد مسار قائمة أو تتبّع.A cancelled job reports failed; no agent list or trace route. |
GET /v2/team/credit-usage | مدعومSupported | أرصدة الخطة الشهرية من سجل الاستهلاك.Monthly plan credits from the usage ledger. |
GET /v2/team/token-usage | مدعوم جزئياًPartial | قيمة remainingTokens مشتقة من رصيد الخطة، وغير مختبرة.remainingTokens is derived from plan credits; not tested. |
GET /v2/team/queue-status | مدعوم جزئياًPartial | waitingJobsInQueue صفر دائماً، وmaxConcurrency ثابتة على 10.waitingJobsInQueue is always 0; maxConcurrency is fixed at 10. |
GET /v2/concurrency-check | مدعوم جزئياًPartial | concurrency هو عدد مهام المفتاح النشطة، وmaxConcurrency ثابتة على 10.concurrency = active jobs of the key; maxConcurrency fixed at 10. |
GET /v2/team/credit-usage/historical | غير مدعومNot supported | لا يوجد مسار.No route. |
GET /v2/team/token-usage/historical | غير مدعومNot supported | لا يوجد مسار.No route. |
GET /v2/team/activity | غير مدعومNot supported | لا يوجد مسار.No route. |
/v2/parse | غير مدعومNot supported | لا يوجد مسار.No route. |
/v2/monitor | غير مدعومNot supported | لا يوجد مسار.No route. |
/v2/interact, /v2/scrape/{id}/interact | غير مدعومNot supported | لا يوجد مسار؛ متصفح الوكيل الخاص بـ«زاحف» تحت /v2/zahif/browser.No route; Zahif's own agent browser lives under /v2/zahif/browser. |
/v2/search/research/papers | غير مدعومNot supported | لا يوجد مسار؛ البحث العلمي فئة بحث فقط.No route; research is a search category only. |
/v1/* aliases | مدعوم جزئياًPartial | تقتصر على scrape وmap وsearch وcrawl وbatch وextract (مع مسارات الحالة والإلغاء والأخطاء) وcredit-usage، وكلها بمنطق v2.scrape, map, search, crawl, batch, extract (with their status, cancel and errors routes) and credit-usage only, all running the v2 logic. |
خيارات الجلبScrape options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
formats: markdown | مدعومSupported | استخراج المحتوى الرئيسي.Main-content extraction. |
formats: html, rawHtml, links, images | مدعومSupported | تُعاد جميعها.All returned. |
formats: screenshot | مدعوم جزئياًPartial | يحتاج تصيير المتصفح ضمن ميزانيته الشهرية، والمختبر مسار غياب المتصفح فقط.Needs browser rendering within its monthly budget; only the no-browser path is tested. |
formats: summary | مدعوم جزئياًPartial | تلخيص اقتباسي TextRank عند غياب النموذج، والاختبار يتحقق من الوجود فقط.Extractive TextRank when no LLM; the test checks presence only. |
formats: json (schema, prompt) | مدعوم جزئياًPartial | استدلال المخطط مختبر، والتعليمة وحدها تحتاج نموذجاً لغوياً.Schema heuristics are tested; a prompt alone needs an LLM. |
formats: changeTracking | مدعوم جزئياًPartial | git-diff فقط، ويُتجاهل نمط json والمخطط.git-diff only; json mode and schema are ignored. |
formats: branding | مدعوم جزئياًPartial | شكل خاص بـ«زاحف»، واختبار وحدة فقط.Zahif's own shape; unit-tested only. |
formats: attributes | مدعوم جزئياًPartial | غير مُتحقق منه باختبار.Not verified by a test. |
formats: query | مدعوم جزئياًPartial | BM25 مع نموذج لغوي، وإلا أعلى مقطع، وغير مختبر.BM25 plus an LLM, else the top passage; not tested. |
onlyMainContent, includeTags, excludeTags | مدعومSupported | مُطبّقة.Honoured. |
maxAge | مدعومSupported | تخزين مؤقت في R2، والقيمة 0 تتجاوزه.R2 cache; 0 bypasses it. |
minAge | غير مدعومNot supported | مُتجاهَل.Ignored. |
headers | مدعوم جزئياًPartial | تُمرَّر للجلب والمتصفح، وغير مختبرة.Sent to fetch and browser; not tested. |
waitFor, mobile | مدعوم جزئياًPartial | يستخدمان تصيير المتصفح ضمن الميزانية، وwaitFor حده 30 ثانية، وغير مختبرين.Use browser rendering (budget); waitFor capped at 30 s; not tested. |
skipTlsVerification | مدعوم جزئياًPartial | يُمرَّر للخادم الأصلي فقط، ويُتجاهل على الحافة.Only forwarded to the origin; ignored at the edge. |
timeout | مدعوم جزئياًPartial | حده الأدنى 3 ثوانٍ ومقيد بمهلة الوضع.Minimum 3 s and bounded by the mode deadline. |
parsers (pdf, maxPages) | مدعوم جزئياًPartial | القيمة [] وحدها تعطّل التحليل، وmaxPages من الإعدادات.Only [] disables parsing; maxPages comes from a setting. |
actions: wait, click, write, press, scroll, scrape | مدعوم جزئياًPartial | عبر تصيير المتصفح فقط، وغير مختبرة من طرف إلى طرف.Browser rendering only; not tested end to end. |
actions: screenshot | مدعوم جزئياًPartial | PNG مع fullPage فقط، ويُتجاهل quality وviewport.PNG with fullPage only; quality and viewport ignored. |
actions: executeJavascript | مدعوم جزئياًPartial | معطّل ما لم يُفعَّل الإعداد actions.allow_js، والمخرجات حدها 100 KB.Off unless the setting actions.allow_js is on; output capped at 100 KB. |
actions: pdf | مدعوم جزئياًPartial | مقاس A4 ثابت، ويُتجاهل format وlandscape وscale.Fixed A4; format, landscape and scale ignored. |
location (country, languages) | مدعوم جزئياًPartial | country مُتجاهل، وlanguages تضبط Accept-Language في الجلب فقط.country ignored; languages sets Accept-Language on fetch only. |
removeBase64Images, blockAds, storeInCache | مدعوم جزئياًPartial | مُنفّذة وغير مختبرة.Implemented; not tested. |
proxy | مدعوم جزئياًPartial | stealth وenhanced يحتاجان الخادم الأصلي، وauto لا يصعّد.stealth and enhanced need the origin; auto never escalates. |
zeroDataRetention | مدعوم جزئياًPartial | لا تخزين مؤقت والملفات تُعاد data URI، ومسار الجلب غير مختبر.No cache, files returned as data URIs; scrape path not tested. |
fastMode | غير مدعومNot supported | مُتجاهَل.Ignored. |
خيارات الزحفCrawl options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
includePaths, excludePaths, regexOnFullURL | مدعومSupported | تعابير نمطية مع حماية من ReDoS.Regular expressions with a ReDoS guard. |
maxDiscoveryDepth, crawlEntireDomain, sitemap | مدعومSupported | مُطبّقة.Honoured. |
limit | مدعوم جزئياًPartial | مقيد بإعداد limits.max_pages (100 افتراضياً) مع تحذير.Capped by limits.max_pages (100 by default) with a warning. |
prompt | مدعوم جزئياًPartial | نموذج لغوي أو قواعد، والحقول الصريحة تتقدم، وغير مختبر داخل الزحف.LLM or rules; explicit fields win; not tested inside a crawl. |
ignoreQueryParameters, allowSubdomains, allowExternalLinks | مدعوم جزئياًPartial | مُنفّذة وغير مُتحقق منها باختبار.Implemented; not verified by a test. |
delay, maxConcurrency | مدعوم جزئياًPartial | delay حده 60 ثانية ويفرض تزامن 1، والتزامن حده 10، وغير مختبرين.delay capped at 60 s (forces concurrency 1); concurrency capped at 10; not tested. |
webhook: started, page, completed, headers, metadata | مدعومSupported | تصفية الأحداث وإعادة المحاولة.Event filter and retries. |
webhook: failed | مدعوم جزئياًPartial | يُرسل وغير مختبر.Emitted; not tested. |
webhook signature header | مدعوم جزئياًPartial | التوقيع في X-Zahif-Signature فقط، والمستقبِل الذي ينتظر اسم ترويسة آخر يحتاج تعديلاً.Signed in X-Zahif-Signature only; receivers that expect another header name must be adapted. |
scrapeOptions, zeroDataRetention | مدعومSupported | تُمرَّر (المهلة حدها 60 ثانية)، ولا تخزين في R2 مع عدم الاحتفاظ.Passed through (timeout capped at 60 s); no R2 storage under zero retention. |
خيارات الخريطةMap options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
search | مدعومSupported | ترتيب BM25.BM25 ranking. |
sitemap, includeSubdomains, ignoreQueryParameters, timeout | مدعوم جزئياًPartial | مُنفّذة وغير مُتحقق منها باختبار.Implemented; not verified by a test. |
limit | مدعوم جزئياًPartial | مقيد بـ limits.max_pages × 50.Capped at limits.max_pages × 50. |
location | غير مدعومNot supported | مُتجاهَل.Ignored. |
خيارات البحثSearch options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
limit, sources: web, news | مدعومSupported | محركات مجانية تُدمج بطريقة RRF، والحد الأقصى 100.Free backends fused with RRF; limit capped at 100. |
sources: images | مدعوم جزئياًPartial | Wikimedia Commons على الحافة، وSearXNG عند ربط الخادم الأصلي، وغير مختبر.Wikimedia Commons at the edge, plus SearXNG when an origin is connected; not tested. |
categories: github, research, pdf | مدعوم جزئياًPartial | عبر GitHub وarXiv/OpenAlex/Crossref وfiletype:pdf، وغير مختبرة.GitHub, arXiv/OpenAlex/Crossref and filetype:pdf; not tested. |
tbs | مدعوم جزئياًPartial | تُفهم صيغ qdr:h/d/w/m/y فقط.Only qdr:h/d/w/m/y is understood. |
location, country | مدعوم جزئياًPartial | يُعاملان كرمز دولة للمحركات الداعمة، وغير مختبرين.Treated as a country code for supporting backends; not tested. |
scrapeOptions | مدعوم جزئياًPartial | أعلى 10 نتائج كحد أقصى بمهلة 30 ثانية، وغير مختبر.At most the top 10 hits, 30 s cap; not tested. |
timeout, ignoreInvalidURLs | غير مدعومNot supported | مُتجاهلان (يُطبّق الإعداد search.timeout_ms).Ignored (the setting search.timeout_ms applies). |
خيارات الاستخراجExtract options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
urls (incl. /*), prompt, schema | مدعومSupported | يُوسَّع /* عبر map، ونموذج لغوي أو استدلال مستند إلى المصادر./* expanded through map; LLM or grounded heuristics. |
enableWebSearch, ignoreSitemap, includeSubdomains, showSources | مدعوم جزئياًPartial | مُنفّذة وغير مُتحقق منها باختبار.Implemented; not verified by a test. |
scrapeOptions | مدعوم جزئياًPartial | تُستبدل قيم formats وtimeout.formats and timeout are overridden. |
خيارات وكيل البحثAgent options
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
prompt, urls, schema, strictConstrainToURLs | مدعومSupported | بحث متعدد الاستعلامات، والروابط أولاً، والمخطط يُعاد في data.Multi-query research; seeds first; schema returned as data. |
maxCredits | مدعوم جزئياًPartial | القيمة الافتراضية 100 (تُطبّق حدود الوضع)، وغير مختبر.Default 100 (mode limits apply); not tested. |
mode extract | chat, model | مدعوم جزئياًPartial | يُقبل mode ويُعاد كما هو، وmodel مُتجاهل، ولا سلوك خاص لـ chat.mode is accepted and echoed; model is ignored; chat has no special behaviour. |
أشكال الاستجابةResponse shapes
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
error envelope {success:false, error} | مدعومSupported | يضيف code وrequestId وdetails.Adds code, requestId and details. |
job status fields | مدعومSupported | كلها موجودة، مع progress.All present, plus progress. |
MCPMCP
| البندItem | الحالةStatus | التوضيحNotes |
|---|---|---|
Firecrawl MCP tool names | غير مدعومNot supported | غير متاحة؛ خادم MCP في «زاحف» يقدّم أدواته فقط.Not offered; Zahif's MCP server exposes its own tools only. |
استخدام عميل Firecrawl الموجود لديكUsing an existing Firecrawl client
وجّه العميل إلى رابط «زاحف» ومفتاحك، ثم اختبر الخيارات التي تستخدمها مقابل الجدول أعلاه.Point the client at Zahif's base URL with your key, then test the options you use against the table above.
# Python
from firecrawl import Firecrawl
app = Firecrawl(api_key="zh-YOUR_KEY", api_url="https://claude-crawler.trusted-intel.cc")
// Node
import Firecrawl from "@mendable/firecrawl-js";
const app = new Firecrawl({ apiKey: "zh-YOUR_KEY", apiUrl: "https://claude-crawler.trusted-intel.cc" });
POST /v2/agent تُقبل القيمتان mode: "extract" و"chat"، ويُؤخذ وضع «زاحف» عندها من zahifMode أو الترويسة x-zahif-mode أو ملف المفتاح.On POST /v2/agent, mode: "extract" and "chat" are accepted; the Zahif work mode then comes from zahifMode, the x-zahif-mode header or the key profile.للحصول على كل القدرات استخدم حزمة «زاحف» البرمجية أو مرجع API مباشرة.For every capability use the Zahif SDK or the API reference directly.
Firecrawl علامة تجارية لمالكها، ولا ارتباط بين «زاحف» وبينها.Firecrawl is a trademark of its owner; Zahif is not affiliated with it.