Web Fetch API

La Web Fetch API estrae il contenuto da un URL di destinazione e restituisce il risultato in un formato più facile da elaborare per agenti, sistemi RAG e workflow sui contenuti. Può restituire HTML, testo semplice o Markdown e supporta selettori, opzioni di leggibilità, controllo della cache, user agent personalizzati e cookie della richiesta.

Endpoint

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

Autenticazione

Invia la tua chiave API nell'header Authorization:

Authorization: Bearer YOUR_API_KEY

Vedi la guida all'autenticazione per i dettagli sulla creazione e gestione delle chiavi API.

Uso con agenti IA

Installa il pacchetto completo felo-ai quando vuoi che un agente estragga pagine web insieme a ogni altra Felo Skill disponibile. L'installer individua dinamicamente ogni directory del pacchetto che contiene SKILL.md, quindi non si basa mai su un elenco fisso. Installa tutte le Skill trovate in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Usa la guida alla configurazione manuale degli agenti IA per l'installazione sicura e i passaggi sulla chiave API di ogni piattaforma.

Richiesta

Header

Parametri del corpo

Risposta

Risposta di successo

La risposta usa un design di pass-through trasparente. I campi esatti dentro data possono variare in base a output_format e alle altre opzioni di estrazione.

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

Campi della risposta

Risposte di errore

Esempi

Estrazione di base

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

Estrarre Markdown con leggibilità

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

Estrarre un selettore CSS specifico

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

Attendere contenuti dinamici

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

Casi d'uso

• Dare a un agente il contesto di una pagina web prima di rispondere a una domanda.
• Estrarre il testo di un articolo per l'ingestione RAG o la creazione di basi di conoscenza.
• Convertire pagine web in Markdown per workflow di archiviazione o documentazione.
• Estrarre contenuti mirati da una pagina usando selettori CSS.
• Ridurre il rumore della pagina con l'elaborazione di leggibilità prima dell'analisi IA a valle.

Note

• L'API gestisce un URL per richiesta.
• data viene passato così com'è dal servizio di estrazione downstream, quindi nel tempo possono comparire campi aggiuntivi.
• La modalità fine può essere più lenta di fast, ma può essere utile quando la pagina richiede un rendering più completo.
• Alcune pagine possono bloccare l'estrazione, richiedere cookie o necessitare di un user_agent personalizzato.