Web Fetch API

Web Fetch API, hedef bir URL'den içerik çıkarır ve sonucu ajanların, RAG sistemlerinin ve içerik iş akışlarının işlemesi daha kolay bir biçimde döndürür. HTML, düz metin veya Markdown döndürebilir; seçicileri, readability seçeneklerini, önbellek denetimini, özel user agent'ları ve istek çerezlerini destekler.

Endpoint

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

Kimlik Doğrulama

API anahtarınızı Authorization başlığında gönderin:

Authorization: Bearer YOUR_API_KEY

API anahtarları oluşturma ve yönetme ayrıntıları için Kimlik Doğrulama Kılavuzu sayfasına bakın.

AI Ajanlarıyla Kullanım

Bir Ajanın diğer tüm mevcut Felo Skill'leriyle birlikte web sayfalarını çıkarmasını istediğinizde eksiksiz felo-ai paketini yükleyin. Yükleyici, SKILL.md içeren her paket dizinini dinamik olarak keşfeder; bu nedenle hiçbir zaman sabit bir listeye dayanmaz. Keşfedilen tüm Skill'leri Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills veya Hermes Agent ~/.hermes/skills dizinlerine yükleyin. Her platformun güvenli kurulumu ve API anahtarı adımları için manuel AI Ajanı kurulum kılavuzunu kullanın.

İstek

Başlıklar

Gövde Parametreleri

Yanıt

Başarılı Yanıt

Yanıt, saydam bir doğrudan aktarım tasarımı kullanır. data içindeki tam alanlar output_format ve diğer çıkarma seçeneklerine göre değişebilir.

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

Yanıt Alanları

Hata Yanıtları

Örnekler

Temel Çıkarma

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"
  }'

Readability ile Markdown Çıkarma

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
  }'

Belirli bir CSS Seçicisini Çıkarma

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"
  }'

Dinamik İçeriği Bekleme

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
  }'

Kullanım Senaryoları

• Bir soruyu yanıtlamadan önce ajana web sayfası bağlamı sağlayın.
• RAG alımı veya bilgi tabanı oluşturma için makale metni çıkarın.
• Arşivleme veya dokümantasyon iş akışları için web sayfalarını Markdown'a dönüştürün.
• CSS seçicilerini kullanarak bir sayfadan odaklı içerik çekin.
• Alt akış AI analizinden önce readability işleme ile sayfa gürültüsünü azaltın.

Notlar

• API, istek başına bir URL işler.
• data, alt akış çıkarma hizmetinden doğrudan aktarılır; bu nedenle zamanla ek alanlar görünebilir.
• fine modu fast modundan daha yavaş olabilir, ancak sayfanın daha zengin bir oluşturma davranışına ihtiyaç duyduğu durumlarda kullanışlı olabilir.
• Bazı sayfalar çıkarmayı engelleyebilir, çerez gerektirebilir veya özel bir user_agent gerektirebilir.