Web Fetch API

API Web Fetch wyodrębnia treść z docelowego adresu URL i zwraca wynik w formacie łatwiejszym do przetworzenia dla agentów, systemów RAG i przepływów pracy z treścią. Może zwracać HTML, zwykły tekst lub Markdown i obsługuje selektory, opcje czytelności, kontrolę pamięci podręcznej, niestandardowe agenty użytkownika oraz pliki cookie żądań.

Endpoint

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

Uwierzytelnianie

Wyślij klucz API w nagłówku Authorization:

Authorization: Bearer YOUR_API_KEY

Szczegóły tworzenia kluczy API i zarządzania nimi znajdziesz w przewodniku uwierzytelniania.

Użycie z agentami AI

Zainstaluj kompletny pakiet felo-ai, gdy chcesz, aby agent wyodrębniał treść stron internetowych obok każdego innego dostępnego Felo Skill. Instalator dynamicznie wykrywa każdy katalog pakietu zawierający SKILL.md, więc nigdy nie opiera się na stałej liście. Zainstaluj wszystkie wykryte Skills w Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills lub Hermes Agent ~/.hermes/skills. Użyj podręcznika konfiguracji agenta AI, aby poznać bezpieczną instalację i kroki konfiguracji klucza API dla każdej platformy.

Żądanie

Nagłówki

Parametry treści

Odpowiedź

Odpowiedź sukcesu

Odpowiedź wykorzystuje przezroczysty przekaz. Dokładne pola w data mogą się różnić w zależności od output_format i innych opcji wyodrębniania.

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

Pola odpowiedzi

Odpowiedzi błędów

Przykłady

Podstawowa ekstrakcja

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

Ekstrakcja Markdown z przetwarzaniem czytelności

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

Ekstrakcja konkretnego selektora 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"
  }'

Oczekiwanie na dynamiczną treść

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

Zastosowania

• Daj agentowi kontekst strony internetowej przed odpowiedzią na pytanie.
• Wyodrębnij tekst artykułu do wprowadzenia do RAG lub utworzenia bazy wiedzy.
• Konwertuj strony internetowe na Markdown do archiwizacji lub przepływów dokumentacji.
• Pobierz wyodrębnioną treść ze strony za pomocą selektorów CSS.
• Zmniejsz szum strony dzięki przetwarzaniu czytelności przed dalszą analizą AI.

Uwagi

• API obsługuje jeden adres URL na żądanie.
• data jest przekazywane z podrzędnej usługi wyodrębniania, więc z czasem mogą pojawić się dodatkowe pola.
• Tryb fine może być wolniejszy niż fast, ale bywa przydatny, gdy strona wymaga bogatszego renderowania.
• Niektóre strony mogą blokować wyodrębnianie, wymagać plików cookie lub niestandardowego user_agent.