Web Fetch API

Web Fetch API extrahuje obsah z cílové URL a vrací výsledek ve formátu, který se snáze zpracovává agentům, systémům RAG a obsahovým workflow. Může vracet HTML, prostý text nebo Markdown a podporuje selektory, možnosti readability, řízení mezipaměti, vlastní user agenty a cookies požadavku.

Endpoint

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

Ověřování

Odešlete svůj API klíč v hlavičce Authorization:

Authorization: Bearer YOUR_API_KEY

Podrobnosti o vytváření a správě API klíčů najdete v příručce k ověřování.

Použití s AI agenty

Nainstalujte kompletní balíček felo-ai, když chcete, aby agent extrahoval webové stránky vedle všech ostatních dostupných Felo Skills. Instalátor dynamicky objevuje každý adresář balíčku obsahující SKILL.md, takže nikdy nespoléhá na pevný seznam. Nainstalujte všechny objevené Skills do ~/.codex/skills pro Codex, ~/.claude/skills pro Claude Code, ~/.agents/skills pro OpenClaw nebo ~/.hermes/skills pro Hermes Agent. Bezpečnou instalaci a kroky pro API klíč u každé platformy najdete v příručce k ručnímu nastavení AI agenta.

Požadavek

Hlavičky

Parametry těla požadavku

Odpověď

Úspěšná odpověď

Odpověď používá transparentní průchozí návrh. Přesná pole uvnitř data se mohou lišit podle output_format a dalších možností extrakce.

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

Pole odpovědi

Chybové odpovědi

Příklady

Základní extrakce

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

Extrakce Markdownu s 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
  }'

Extrakce konkrétního CSS selektoru

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

Čekání na dynamický obsah

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

Případy použití

• Dejte agentovi kontext webové stránky dříve, než odpoví na otázku.
• Extrahujte text článku pro ingest do RAG nebo vytvoření znalostní báze.
• Převeďte webové stránky na Markdown pro archivaci nebo dokumentační workflow.
• Získejte ze stránky cílený obsah pomocí CSS selektorů.
• Snižte šum stránky zpracováním readability před následnou analýzou AI.

Poznámky

• API zpracovává jednu URL na požadavek.
• data se předává z navazující služby extrakce, takže v čase se mohou objevit další pole.
• Režim fine může být pomalejší než fast, ale může být užitečný, když stránka potřebuje bohatší vykreslování.
• Některé stránky mohou extrakci blokovat, vyžadovat cookies nebo potřebovat vlastní user_agent.