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, והוא תומך בסלקטורים, באפשרויות readability, בשליטה ב-cache, בסוכני משתמש מותאמים ובקובצי cookie של בקשה.

Endpoint

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

אימות

שלחו את מפתח ה-API שלכם בכותרת Authorization:

Authorization: Bearer YOUR_API_KEY

ראו את מדריך האימות לפרטים על יצירת מפתחות API וניהולם.

שימוש עם סוכני AI

התקינו את החבילה המלאה felo-ai כשרוצים שסוכן יחלץ דפי אינטרנט לצד כל Felo Skill זמין אחר. המתקין מגלה באופן דינמי כל תיקיית חבילה שמכילה SKILL.md, כך שהוא לעולם אינו מסתמך על רשימה קבועה. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills או Hermes Agent ~/.hermes/skills. השתמשו במדריך ההגדרה הידנית לסוכני AI לשלבי ההתקנה הבטוחה ומפתח ה-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 or string	לא	-	הפעלת עיבוד readability כדי להתמקד בתוכן הראשי ולהפחית רעש מהעמוד.
`with_links_summary`	boolean	לא	-	לכלול סיכום קישורים כשהמחלץ במורד הזרם תומך בכך.
`with_images_summary`	boolean	לא	-	לכלול סיכום תמונות כשהדבר נתמך.
`with_images_readability`	boolean	לא	-	להחיל עיבוד readability על חילוץ תמונות כשהדבר נתמך.
`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	לא	-	קובצי cookie לשליחה עם בקשת החילוץ.
`user_agent`	string	לא	-	מחרוזת User-Agent מותאמת לבקשת החילוץ.
`timeout`	integer	לא	-	פסק זמן לבקשה באלפיות שנייה.
`with_cache`	boolean	לא	`true`	האם המחלץ במורד הזרם רשאי להשתמש ב-cache.
`with_stypes`	boolean	לא	`false`	לכלול מטא-נתונים של סוגי סגנון כשהדבר נתמך.

תגובה

תגובת הצלחה

התגובה משתמשת בעיצוב העברה שקוף. השדות המדויקים בתוך data יכולים להשתנות בהתאם ל-output_format ולאפשרויות חילוץ אחרות.

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

שדות התגובה

שדה	סוג	תיאור
`status`	string	סטטוס התגובה. בדרך כלל `ok` לבקשה מוצלחת.
`message`	string or null	הודעה נוספת. בדרך כלל `null` בבקשות מוצלחות.
`data`	object	התוכן והמטא-נתונים שחולצו והוחזרו על ידי שירות החילוץ במורד הזרם.
`data.content`	string or 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 עם readability

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.
להפחית רעש מהעמוד באמצעות עיבוד readability לפני ניתוח AI בהמשך.

הערות

ה-API מטפל בכתובת URL אחת בכל בקשה.
data מועבר כמו שהוא משירות החילוץ במורד הזרם, כך ששדות נוספים עשויים להופיע עם הזמן.
מצב fine עשוי להיות איטי יותר מ-fast, אך יכול להיות שימושי כשהעמוד צריך התנהגות עיבוד עשירה יותר.
ייתכן שעמודים מסוימים יחסמו חילוץ, ידרשו קובצי cookie או יצטרכו user_agent מותאם.