# المواقع المحمية

> URL: https://foura.ai/ar/docs/guides/protected-sites
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

تستخدم المواقع الحديثة تقنيات متقدمة لرصد برامج البوت. يوضح هذا الدليل كيف يتيح لك FourA جلب الصفحات من المواقع التي تدقق في هوية المُرسل، وكيف ترفع معدل نجاحك.

## كيف يعمل رصد برامج البوت

تعتمد المواقع على عدة طبقات حماية:

- **سمعة عنوان IP**: حظر مراكز البيانات وعناوين proxy المعروفة
- **بصمة الاتصال الشبكي**: لكل عميل HTTP بصمة مصافحة مميزة تستطيع المواقع اكتشافها
- **بصمة المتصفح**: يتحقق JavaScript من مؤشرات المتصفحات من نوع headless
- **التحليل السلوكي**: أنماط الـ request والتوقيت وتسلسل التصفح
- **صفحات التحقق**: مهمة بصرية يجب على الزائر إكمالها

يحدد الـ response اسم النظام الذي أجرى الفحص، وتستعرضها قائمة [فحوصات الموقع](https://foura.ai/docs/api/site-checks).

## المسار الأسرع: Auto

إذا لم تكن تعرف مستوى الحماية بعد، استدعِ `/api/auto/` مع جزء نصي `validate.data.accept` لا يظهر إلا في الصفحة الفعلية. يتدرج وضع Auto عبر مستويات تراعي التكلفة (proxy مُدار، ثم متصفح عبر proxy، ومع `forceProxy: false`، يبدأ بفحص مباشر منخفض التكلفة ثم استعراض مباشر عبر المتصفح أولا) ويتوقف عند أول مستوى يرجع response تقبله قواعدك. في الطلبات المتكررة لنفس المضيف، تتم إعادة استخدام جلسة نشطة بدلا من ذلك، مما يجعل الطلب الثاني منخفض التكلفة.

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://protected-site.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

يتعرف الوضع التلقائي على صفحات التحدي الشائعة ويواصل المحاولة عند مصادفة أحدها. بينما تغطي سلسلة `validate.data.accept` الحالات المتبقية: صفحة تحقق غير معروفة، أو جدار تسجيل دخول، أو صفحة لا تحتوي على المحتوى المطلوب. راجع [دليل Smart Fetch](https://foura.ai/docs/guides/smart-fetch) للاطلاع على الشرح الكامل.

## كيف يساعد FourA في كل طبقة

### طلبات واقعية على مستوى بروتوكول الشبكة

ترسل الـ endpoint الفردية (`POST /api/single/`) خصائص مصافحة تطابق المتصفح الحقيقي. فتستجيب المواقع لها تمامًا كما تستجيب للمتصفح، دون استهلاك الموارد الإضافي لتشغيله.

فعّل `unblocker` لإدراج headers واقعية للمتصفح أيضًا (User-Agent و Sec-Ch-Ua و *Sec-Fetch- و Accept-Encoding). الخيار `unblocker` مفعّل افتراضيًا؛ عيّن `false` فقط لإرسال الـ headers الخاصة بك دون إضافة أي شيء آخر.

```json
{
  "method": "GET",
  "url": "https://protected-site.com/data",
  "unblocker": true
}
```

### تصيير عبر متصفح حقيقي

يشغّل endpoint المتصفح (`POST /api/browser/`) نسخة Chrome كاملة. حيث ينفّذ JavaScript الخاص بالصفحة بالطريقة نفسها التي ينفذها متصفح الزائر. يُكمل `unblocker` في Browser عمليات التحقق التي تطلبها الصفحة قبل تحميلها (مثل Turnstile وبوابات الحماية المماثلة)؛ اتركه مفعلاً إلا إذا كنت تريد استلام صفحة التحدي كما هي.

### تدوير الـ Proxy

يقوم endpoint الـ proxy ‏(`POST /api/proxy/`) بالتدوير عبر مجمّع منافذ الخروج القياسي التابع لـ FourA. عندما يرفض موقع منفذ خروج معيناً أو لا يستجيب المنفذ، تنطلق المحاولة التالية عبر منفذ مختلف. استخدم `ignoreProxies` في استدعاء لاحق لتجاوز المنافذ المستهلكة سابقاً؛ واستخدم `maxTries` (القيمة الافتراضية 5، والحد الأقصى 90) للتحكم في عدد المحاولات.

لا تُستخدم منافذ الخروج premium إلا عندما يطلب الـ request ذلك صراحة. يتيح `exitClass: "premium"` للـ Proxy الانتقال إلى منفذ premium فور تعذر وصول المجمّع القياسي إلى الصفحة، وذلك ضمن خطة تتضمن منافذ premium. يوضح `exitClass` في الـ response الناجح نوع المنفذ الذي تولى التسليم، وعند استنفاد رصيد traffic المخصص لمنافذ premium خلال الفترة، يستمر الـ request عبر المجمّع القياسي ويُرجع `standard`. راجع [exitClass](https://foura.ai/docs/api/endpoints#exitclass).

### منافذ خروج محددة حسب الدولة

مرّر `exitCountries` في `/api/proxy/` لحصر الاختيار على خوادم proxy تطابق دولتها الظاهرة للهدف قائمة مسموح بها بدقة. القيم عبارة عن رموز من حرفين (`["CZ", "GB"]`)، وتتم إزالة المسافات الزائدة منها وتحويلها إلى أحرف كبيرة وحذف التكرارات. لا يعود المجمّع القياسي أبداً إلى دولة غير مطلوبة؛ وإذا لم تتوافر أي مطابقة في المجمّع الحالي، يُرجع الـ response الرمز `code: "no_eligible_proxy"` مع النطاق المعياري في `details.exitCountries` لتتمكن من إعادة المحاولة لاحقاً دون تخفيف القيود. كما يلتزم منفذ premium بالقائمة أيضاً: فباستخدام `exitClass: premium`، ينطلق منفذ premium من إحدى دولك المحددة، ويُحدد `exitCountry` في الـ response اسمها. تحديد نطاق الدول متاح بدءاً من خطة Startup فما فوق. وفي حال استخدام خطة لا تتضمنه، يتم رفض أي استدعاء يرسل `exitCountries` عبر `403` و`X-FourA-Limit: plan_limit_feature`.

```bash
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "exitCountries": ["CZ", "GB"],
    "request": {"method": "GET", "url": "https://target.example/pricing"}
  }'
```

تتضمن الـ response القيمة `exitCountry` عند طلب تحديد النطاق (scoping). تحقق من انتمائها إلى قائمة السماح (allowlist) الخاصة بك قبل الوثوق في الـ payload، ثم أعد استخدام معرف `proxy` المرتجع في أي استدعاء Browser لاحق حتى يتم تصيير الـ JavaScript عبر نقطة الخروج ذاتها.

## FourA تخبرك بما أوقفك

لست بحاجة لتخمين النظام الذي حظر الـ request. عندما يشغّل الهدف فحص bot، تحدد الـ response اسمه بدقة.

- تُرجع `POST /api/single/` و`POST /api/proxy/` الكائن `defense`: حيث يمثل `defense.vendor` النظام، ويوضح `defense.solved` ما إذا تم تجاوز الفحص بنجاح، ويسرد `defense.present` كل ما تم التعرف عليه في تلك الـ response.
- تُرجع `POST /api/browser/` القيمة `defenseSolved` بالإضافة إلى `defenses.present` و`defenses.cleared`.

```json
{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "sgcaptcha",
    "solved": true,
    "present": ["sgcaptcha"],
    "cookie": "_I_=<clearance>"
  }
}
```

يترتب على ذلك قاعدتان:

1. **`solved: false` تعني أن body قد يكون صفحة التحدي وليس الصفحة المطلوبة.** لا تقدم FourA صفحة التحدي كمحتوى أبدا، لذا تحقق من flag قبل التحليل.
2. **الحل يمنحك تصريح المرور (clearance).** عند وجود `defense.cookie`، أعد إرساله كترويسة `Cookie` على نفس نقطة الخروج بنفس User-Agent، وستتخطى الطلبات اللاحقة الفحص بالكامل.

تتعرف FourA على أنظمة الفحص الشائعة، بما في ذلك الفحوصات الداخلية التابعة لـ eBay وReddit وAmazon. نطاق التعرف أوسع من التجاوز: أي نظام يمكننا تحديده ولكن لا يمكننا تجاوزه يتم الإبلاغ عنه ولا يرفع تكلفة request أبدا. عندما تكون الصفحة المستلمة هي صفحة الفحص الخاصة بذلك النظام، حتى مع رمز الحالة HTTP 200، لا يتم احتساب تكلفة request ويحدد header المدعو `X-FourA-Check-Page` اسمه. راجع [فحوصات الموقع](https://foura.ai/docs/api/site-checks) للاطلاع على كل حقل، والفرق الحالي بين التجاوز والاكتشاف، ومثال على إعادة الإرسال.

صفحة "continue shopping" ذات الزر الواحد من Amazon يتم التجاوب معها نيابة عنك بدلا من تجاوزها كفحص أمني. تضغط Single وProxy وBrowser على الزر عبر نفس نقطة الخروج وتعيد الصفحة الفعلية. مع تفعيل `unblocker` (الوضع الافتراضي)، تبلغ Single وProxy عنها في `defense` كـ `retry: "amazon-continue"` مع `solved: false`، ولا يتغير السعر. يعمل فحص JavaScript الخفيف الخاص بـ Reddit بنفس الطريقة على Single وProxy: إذ يجيبان عليه عبر نفس نقطة الخروج، ويعيدان الصفحة الفعلية، ويبلغان عن `retry: "reddit-js-check"` مع `solved: false` بنفس السعر.

## الاستراتيجية حسب مستوى الحماية

### حماية غير معروفة

استخدم auto. يبدأ على proxy مُدار بالتناوب ولا يُصعّد إلا بالقدر الذي يفرضه الموقع المستهدف، وبذلك تدفع تكلفة مرحلة الاستكشاف مرة واحدة لكل host.

### حماية منخفضة (معظم المواقع)

استخدم endpoint الفردي مع `unblocker`. التطابق على مستوى بروتوكول الشبكة كافٍ.

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://news-site.com/article", "unblocker": true}'
```

### متوسط: صفحة اختبار تحدي أو جدار حماية أساسي

استخدم endpoint الخاص بالمتصفح لتجاوز تحديات JavaScript:

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://protected-site.com/data", "timeout_ms": 15000}'
```

### مرتفع: فحوصات السلوك وبصمة الجهاز

استخدم proxy endpoint مع محاولات إعادة متعددة:

```bash
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 10,
    "request": {
      "method": "GET",
      "url": "https://heavily-protected.com/prices",
      "unblocker": true
    }
  }'
```

بالنسبة لصفحات التحدي المتسلسلة ("Just a moment"، نقطة تحقق أمنية) حيث تحتاج إلى الصفحة المعروضة بعد تجاوز التحدي، راجع [MCP Recipes](https://foura.ai/docs/mcp/recipes). توضح وصفة "Protected page: proxy first, browser when JavaScript is needed" آلية التسليم الدقيقة من proxy إلى browser.

## أفضل الممارسات

1. **ابدأ باستخدام auto للأهداف غير المعروفة.** مرر قاعدة `validate`، ودع التدرج يختار المستوى الأقل تكلفة، ثم اقرأ `meta.rung` في response لمعرفة المحرك الذي نجح. بمجرد معرفتك، اتصل بذلك المحرك مباشرة لطلبات المرور المتكررة.

2. **أعد استخدام الجلسة الناجحة.** بعد استدعاء auto، يمكن إعادة استخدام قيمة `session` المرجعة (معرّف proxy + ملفات cookie + userAgent) عبر `/api/single/` أو `/api/browser/` للصفحات التالية على نفس المضيف، وفق تكلفة ذلك endpoint المحددة: رصيدان على Single مع `unblocker`، و5 على Browser (10 عندما يكمل الاستدعاء خطوة تحقق تطلبها الصفحة).

3. **التزم بحدود rate limits.** حتى مع تدوير proxy، فإن إرسال مئات طلبات request في الثانية إلى موقع واحد سيؤدي إلى تفعيل الاكتشاف السلوكي. باعد بين طلباتك بفارق ثانية إلى ثانيتين على الأقل.

4. **أبقِ `unblocker` مفعّلاً.** في Single وProxy، يضيف الخيار `unblocker: true` (الافتراضي) ترويسات headers واقعية للمتصفح. وفي Browser يعمل على تفعيل أداة حل التحديات. لا تعطه إلا عندما تحتاج تحديداً إلى request بدون ترويسات مضافة أو إلى صفحة تحدٍ غير معالجة.

5. **راقب معدلات النجاح.** تحقق من مقاييس [Dashboard](https://foura.ai/dashboard) لتتبع معدل النجاح بمرور الوقت. يشير الانخفاض المفاجئ عادةً إلى أن الموقع المستهدف قد قام بتحديث نظام الحماية لديه.

6. **تخطَّ نقاط الخروج المستهلكة.** إذا أرجع استدعاء `/api/proxy/` أو `/api/auto/` معرّف proxy بدأ بالفشل بعد ذلك، فمرره في `ignoreProxies` في الاستدعاء التالي ليختار FourA نقطة خروج مختلفة.

7. **اقرأ `defense` قبل إعادة المحاولة.** يوضح لك اسم المزود ما إذا كان تجربة ملف تعريف متصفح آخر تستحق المحاولة، أو ما إذا كنت بحاجة إلى render كامل، أو ما إذا كان الفحص لا يمكن تجاوزه دون خدمة حل متخصصة.

8. **غيّر المتصفح الذي تقدمه.** تقبل بعض الأهداف متصفحاً معيناً وترفض آخر. حدد `browser`، أو `os`، أو `version` في Single وProxy، واقرأ `GET /api/profiles` للاطلاع على القائمة الحالية. التفاصيل متوفرة في [endpoint reference](https://foura.ai/docs/api/endpoints).

## القيود

تتطلب بعض السيناريوهات معالجة إضافية خارج API:

- **المحتوى المحمي بتسجيل الدخول**: لا يدير FourA عمليات تسجيل الدخول طويلة الأمد نيابة عنك. يقبل endpoint المتصفح `cookies` لكل request؛ مرر cookies الخاصة بجلستك بنفسك.
- **مهام التحقق التفاعلية**: يتعرف FourA على المهام المرئية ويبلغ عنها في `defense.present`، لكنه لا يكملها. تتم معالجة Turnstile بواسطة Browser.
- **المحتوى المقتصر على بلدان معينة**: استخدم `exitCountries` في `/api/proxy/` لتحديد الاختيار بالبلدان المسموح بها. المواقع التي تتحقق أيضا من الشبكة التي ينتمي إليها العنوان (بعض وكلاء المراهنات المرخصين محليا، وبعض الخدمات الحكومية) قد ترفض نقاط الخروج حتى لو كانت من البلد الصحيح. باستخدام `exitClass: premium` وبلد واحد في `exitCountries`، يمكن لنقطة خروج مدفوعة أن تنطلق أيضا من منطقة أو مدينة أو شبكة تحددها: راجع [موقع الخروج](https://foura.ai/docs/api/endpoints#exit-location). عندما لا يتوفر لدى المجموعة أي نقطة خروج في البلدان التي سمحت بها، يعيد الـ request الرمز `no_eligible_proxy`.
- **المواقع ذات القيود القانونية**: تأكد دائما من توافق جمع البيانات لديك مع شروط خدمة الموقع المستهدف والقوانين المعمول بها.

## الخطوات التالية

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): نظرة متعمقة على `/api/auto/`
- [اختيار الـ Endpoint المناسب](https://foura.ai/docs/guides/choosing-task-type): دليل اتخاذ القرار للـ endpoints
- [المشكلات الشائعة](https://foura.ai/docs/troubleshooting/common-issues): معالجة أخطاء 403 وصفحات التحقق
- [API Endpoints](https://foura.ai/docs/api/endpoints): مرجع المعلمات الكامل بما في ذلك `exitCountries`
- [فحوصات الموقع](https://foura.ai/docs/api/site-checks): حقل `defense`، وقائمة الأنظمة، وإعادة تشغيل التصريح
- [وصفات MCP](https://foura.ai/docs/mcp/recipes): قوالب سير العمل بما في ذلك سلسلة proxy-first-then-browser
