Web Fetch API

La Web Fetch API extrae contenido de una URL de destino y devuelve el resultado en un formato más fácil de procesar para agentes, sistemas RAG y flujos de trabajo de contenido. Puede devolver HTML, texto sin formato o Markdown, y admite selectores, opciones de legibilidad, control de caché, agentes de usuario personalizados y cookies de solicitud.

Endpoint

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

Autenticación

Envía tu clave de API en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Consulta la guía de autenticación para obtener detalles sobre la creación y gestión de claves de API.

Uso con agentes de IA

Instala el paquete completo felo-ai cuando quieras que un agente extraiga páginas web junto con todas las demás Felo Skills disponibles. El instalador descubre dinámicamente todos los directorios del paquete que contengan SKILL.md, por lo que nunca depende de una lista fija. Instala todas las Skills descubiertas en Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Usa la guía de configuración manual de agentes de IA para los pasos de instalación segura y de clave de API de cada plataforma.

Solicitud

Encabezados

Parámetros del cuerpo

Respuesta

Respuesta correcta

La respuesta usa un diseño de paso directo transparente. Los campos exactos dentro de data pueden variar según output_format y otras opciones de extracción.

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

Campos de la respuesta

Respuestas de error

Ejemplos

Extracción básica

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

Extraer Markdown con legibilidad

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

Extraer un selector CSS concreto

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

Esperar contenido dinámico

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

Casos de uso

• Dar a un agente el contexto de una página web antes de responder a una pregunta.
• Extraer el texto de un artículo para ingerirlo en RAG o crear una base de conocimiento.
• Convertir páginas web a Markdown para archivarlas o para flujos de documentación.
• Obtener contenido concreto de una página mediante selectores CSS.
• Reducir el ruido de la página con el procesamiento de legibilidad antes del análisis de IA downstream.

Notas

• La API gestiona una URL por solicitud.
• data se pasa directamente desde el servicio de extracción downstream, por lo que pueden aparecer campos adicionales con el tiempo.
• El modo fine puede ser más lento que fast, pero puede resultar útil cuando la página necesita un comportamiento de renderizado más completo.
• Algunas páginas pueden bloquear la extracción, requerir cookies o necesitar un user_agent personalizado.