Felo APIs

Web Fetch API

استخرج محتوى صفحة الويب بصيغة HTML أو نص أو Markdown مع خيارات المحدد وقابلية القراءة.

POST/v2/web/extract

المصادقة

Bearer API key

نوع المحتوى

application/json

ملاحظات السعر

قد تنطبق حدود خاصة بـ endpoint.

YouTube Subtitling Chat API

يستخرج Web Fetch API المحتوى من عنوان URL هدف ويعيد النتيجة بتنسيق أسهل على الوكلاء وأنظمة RAG وسير عمل المحتوى. ويمكنه إعادة HTML أو نص عادي أو Markdown، ويدعم المحدّدات وخيارات القراءة والتحكم في ذاكرة التخزين المؤقت وعملاء المستخدم المخصصين وملفات تعريف ارتباط الطلب.

Endpoint

POST https://openapi.felo.ai/v2/web/extract

المصادقة

أرسل مفتاح API في رأس Authorization:

Authorization: Bearer YOUR_API_KEY

راجع دليل المصادقة لتفاصيل إنشاء مفاتيح API وإدارتها.

الاستخدام مع وكلاء الذكاء الاصطناعي

ثبّت حزمة felo-ai الكاملة عندما تريد أن يستخرج وكيل صفحات الويب إلى جانب كل مهارة Felo Skill أخرى متاحة. يكتشف المثبّت ديناميكيًا كل دليل حزمة يحتوي SKILL.md، لذا لا يعتمد أبدًا على قائمة ثابتة. ثبّت كل المهارات المكتشفة في Codex ~/.codex/skills أو Claude Code ~/.claude/skills أو OpenClaw ~/.agents/skills أو Hermes Agent ~/.hermes/skills. استخدم دليل إعداد وكيل الذكاء الاصطناعي اليدوي لخطوات التثبيت الآمن ومفتاح API على كل منصة.

الطلب

الرؤوس

الرأس	مطلوب	الوصف
`Authorization`	نعم	مفتاح API الخاص بك بالصيغة `Bearer YOUR_API_KEY`
`Content-Type`	نعم	يجب أن يكون `application/json`

معاملات النص

المعامل	النوع	مطلوب	الافتراضي	الوصف
`url`	string	نعم	-	عنوان URL لصفحة الويب المطلوب استخراجها.
`crawl_mode`	string	لا	`fast`	وضع الاستخراج. استخدم `fast` لجلب أسرع أو `fine` لزحف أدق قد يتعامل مع صفحات أغنى.
`output_format`	string	لا	`html`	تنسيق المخرجات. القيم المدعومة: `html` و`text` و`markdown`.
`with_readability`	boolean أو string	لا	-	تمكين معالجة القراءة للتركيز على المحتوى الرئيسي وتقليل ضجيج الصفحة.
`with_links_summary`	boolean	لا	-	تضمين ملخص للروابط عندما يدعمه المستخرج اللاحق.
`with_images_summary`	boolean	لا	-	تضمين ملخص للصور عندما يُدعم.
`with_images_readability`	boolean	لا	-	تطبيق معالجة القراءة على استخراج الصور عندما يُدعم.
`with_images`	boolean	لا	-	تضمين معلومات الصور في النتيجة المستخرجة.
`with_links`	boolean	لا	-	تضمين معلومات الروابط في النتيجة المستخرجة.
`ignore_empty_text_image`	boolean	لا	-	تجاهل الصور التي لا تحتوي نصًا مفيدًا عندما يُدعم.
`target_selector`	string	لا	-	محدّد CSS للعنصر الهدف المطلوب استخراجه، مثل `article.main-content`.
`wait_for_selector`	string	لا	-	الانتظار حتى يظهر محدّد CSS قبل الاستخراج. مفيد للصفحات المعروضة ديناميكيًا.
`set_cookies`	array	لا	-	ملفات تعريف الارتباط المراد إرسالها مع طلب الاستخراج.
`user_agent`	string	لا	-	سلسلة User-Agent مخصصة لطلب الاستخراج.
`timeout`	integer	لا	-	مهلة الطلب بالمللي ثانية.
`with_cache`	boolean	لا	`true`	ما إذا كان المستخرج اللاحق قد يستخدم ذاكرة التخزين المؤقت.
`with_stypes`	boolean	لا	`false`	تضمين بيانات وصفية لنوع النمط عندما يُدعم.

الاستجابة

استجابة النجاح

تستخدم الاستجابة تصميم تمرير شفاف. وقد تختلف الحقول الدقيقة داخل data حسب output_format وخيارات الاستخراج الأخرى.

{
  "status": "ok",
  "message": null,
  "data": {
    "content": "# Example Article\n\nExtracted article content..."
  }
}

حقول الاستجابة

الحقل	النوع	الوصف
`status`	string	حالة الاستجابة. عادةً `ok` للطلب الناجح.
`message`	string أو null	رسالة إضافية. عادةً `null` للطلبات الناجحة.
`data`	object	المحتوى والبيانات الوصفية المستخرجة التي تعيدها خدمة الاستخراج اللاحقة.
`data.content`	string أو object	المحتوى المستخرج. يعتمد الشكل على `output_format` والخيارات المختارة.

استجابات الأخطاء

حالة HTTP	رمز الخطأ	الوصف	الإجراء المقترح
400	`WEB_EXTRACT_FAILED`	فشل التحقق من الطلب، أو عنوان URL غير صالح، أو أعاد المستخرج اللاحق خطأ من جانب العميل.	تحقق من `url` والمحدّدات ومعاملات الطلب.
401	`UNAUTHORIZED`	مفتاح API مفقود أو غير صالح أو مُبطَل.	تحقق من مفتاح API ورأس المصادقة.
500	`WEB_EXTRACT_FAILED`	خطأ داخلي في الخدمة.	أعد المحاولة. تواصل مع الدعم إذا استمرت المشكلة.

الأمثلة

استخراج أساسي

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com"
  }'

استخراج Markdown مع القراءة

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "output_format": "markdown",
    "with_readability": true
  }'

استخراج محدّد CSS معيّن

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "target_selector": "article.main-content",
    "output_format": "text"
  }'

الانتظار للمحتوى الديناميكي

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/app",
    "crawl_mode": "fine",
    "wait_for_selector": "#loaded-content",
    "output_format": "markdown",
    "timeout": 30000
  }'

حالات الاستخدام

تزويد وكيل بسياق صفحة ويب قبل الإجابة على سؤال.
استخراج نص مقال لاستيعاب RAG أو إنشاء قاعدة معرفة.
تحويل صفحات الويب إلى Markdown للأرشفة أو سير عمل التوثيق.
سحب محتوى مركّز من صفحة باستخدام محدّدات CSS.
تقليل ضجيج الصفحة بمعالجة القراءة قبل التحليل بالذكاء الاصطناعي اللاحق.

ملاحظات

يتعامل API مع عنوان URL واحد لكل طلب.
تُمرَّر data من خدمة الاستخراج اللاحقة، لذا قد تظهر حقول إضافية مع الوقت.
قد يكون وضع fine أبطأ من fast، لكنه مفيد عندما تحتاج الصفحة إلى سلوك عرض أغنى.
قد تحجب بعض الصفحات الاستخراج، أو تتطلب ملفات تعريف ارتباط، أو تحتاج user_agent مخصصة.