Web Fetch API

L'API Web Fetch extrait le contenu d'une URL cible et renvoie le résultat dans un format plus facile à traiter pour les agents, les systèmes RAG et les workflows de contenu. Elle peut renvoyer du HTML, du texte brut ou du Markdown, et prend en charge les sélecteurs, les options de lisibilité, le contrôle du cache, les user agents personnalisés et les cookies de requête.

Endpoint

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

Authentification

Envoyez votre clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Consultez le guide d'authentification pour les détails sur la création et la gestion des clés API.

Utilisation avec des agents IA

Installez le paquet complet felo-ai lorsque vous voulez qu'un agent extraie des pages web aux côtés de tous les autres Felo Skills disponibles. L'installateur découvre dynamiquement chaque répertoire de paquet contenant SKILL.md, il ne s'appuie donc jamais sur une liste figée. Installez tous les Skills découverts dans Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills ou Hermes Agent ~/.hermes/skills. Utilisez le guide d'installation manuelle des agents IA pour les étapes d'installation sûre et de clé API propres à chaque plateforme.

Requête

En-têtes

Paramètres du corps

Réponse

Réponse de succès

La réponse utilise une conception de transmission transparente. Les champs exacts dans data peuvent varier selon output_format et les autres options d'extraction.

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

Champs de réponse

Réponses d'erreur

Exemples

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

Extraire du Markdown avec lisibilité

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

Extraire un sélecteur CSS spécifique

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

Attendre du contenu dynamique

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

Cas d'usage

• Fournir à un agent le contexte d'une page web avant de répondre à une question.
• Extraire le texte d'articles pour l'ingestion RAG ou la création de bases de connaissances.
• Convertir des pages web en Markdown pour des workflows d'archivage ou de documentation.
• Extraire un contenu ciblé d'une page à l'aide de sélecteurs CSS.
• Réduire le bruit des pages grâce au traitement de lisibilité avant une analyse IA en aval.

Remarques

• L'API traite une URL par requête.
• data est transmis depuis le service d'extraction en aval, des champs supplémentaires peuvent donc apparaître avec le temps.
• Le mode fine peut être plus lent que fast, mais peut être utile lorsque la page nécessite un rendu plus riche.
• Certaines pages peuvent bloquer l'extraction, nécessiter des cookies ou exiger un user_agent personnalisé.