Web Fetch API

A Web Fetch API extrai conteúdo de uma URL de destino e retorna o resultado em um formato mais fácil de processar por agentes, sistemas RAG e fluxos de conteúdo. Ela pode retornar HTML, texto simples ou Markdown, e oferece suporte a seletores, opções de legibilidade, controle de cache, user agents personalizados e cookies de requisição.

Endpoint

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

Autenticação

Envie sua chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Consulte o guia de autenticação para detalhes sobre como criar e gerenciar chaves de API.

Uso com agentes de IA

Instale o pacote completo felo-ai quando quiser que um agente extraia páginas web e use todos os demais Felo Skills disponíveis. O instalador descobre dinamicamente todos os diretórios de pacote que contêm SKILL.md, então nunca depende de uma lista fixa. Instale todos os Skills descobertos em ~/.codex/skills para o Codex, ~/.claude/skills para o Claude Code, ~/.agents/skills para o OpenClaw ou ~/.hermes/skills para o Hermes Agent. Use o guia de configuração manual de agentes de IA para ver os passos de instalação segura e de chave de API de cada plataforma.

Requisição

Cabeçalhos

Parâmetros do corpo

Resposta

Resposta de sucesso

A resposta usa um design transparente de repasse. Os campos exatos dentro de data podem variar conforme output_format e outras opções de extração.

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

Campos da resposta

Respostas de erro

Exemplos

Extração 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"
  }'

Extrair Markdown com legibilidade

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

Extrair um seletor CSS específico

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 por conteúdo 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 contexto de uma página web a um agente antes de responder a uma pergunta.
• Extrair o texto de artigos para ingestão em RAG ou criação de bases de conhecimento.
• Converter páginas web em Markdown para fluxos de arquivamento ou documentação.
• Obter conteúdo direcionado de uma página usando seletores CSS.
• Reduzir o ruído da página com processamento de legibilidade antes de uma análise de IA downstream.

Observações

• A API processa uma URL por requisição.
• data é repassado pelo serviço de extração downstream, então campos adicionais podem aparecer com o tempo.
• O modo fine pode ser mais lento que o fast, mas pode ser útil quando a página precisa de um comportamento de renderização mais rico.
• Algumas páginas podem bloquear a extração, exigir cookies ou precisar de um user_agent personalizado.