Web Fetch API

Web Fetch API видобуває вміст із цільової URL-адреси та повертає результат у форматі, зручнішому для обробки агентами, системами RAG і робочими процесами з контентом. Він може повертати HTML, звичайний текст або Markdown і підтримує селектори, параметри readability, керування кешем, власні user agent і файли cookie запиту.

Endpoint

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

Автентифікація

Надішліть свій API-ключ у заголовку Authorization:

Authorization: Bearer YOUR_API_KEY

Про створення та керування API-ключами див. посібник з автентифікації.

Використання з агентами ШІ

Установіть повний пакет felo-ai, якщо хочете, щоб агент видобував вміст вебсторінок разом з усіма іншими доступними Felo Skills. Інсталятор динамічно знаходить кожен каталог пакета, що містить SKILL.md, тому ніколи не покладається на фіксований список. Установіть усі знайдені Skills у Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills або Hermes Agent ~/.hermes/skills. Використовуйте посібник з ручного налаштування агента ШІ, щоб дізнатися про безпечне встановлення та кроки з API-ключем для кожної платформи.

Запит

Заголовки

Параметри тіла

Відповідь

Успішна відповідь

Відповідь має прозорий наскрізний дизайн. Точні поля в data можуть відрізнятися залежно від output_format та інших параметрів видобування.

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

Поля відповіді

Відповіді з помилками

Приклади

Базове видобування

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

Видобування Markdown із 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
  }'

Видобування конкретного CSS-селектора

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

Очікування динамічного вмісту

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

Варіанти використання

• Надати агенту контекст вебсторінки перед відповіддю на запитання.
• Видобути текст статті для наповнення RAG або створення бази знань.
• Перетворити вебсторінки на Markdown для архівування або робочих процесів документації.
• Отримати цільовий вміст зі сторінки за допомогою CSS-селекторів.
• Зменшити шум сторінки за допомогою обробки readability перед подальшим аналізом ШІ.

Примітки

• API обробляє одну URL-адресу за запит.
• data передається наскрізно від сервісу видобування нижчого рівня, тому з часом можуть з'являтися додаткові поля.
• Режим fine може бути повільнішим за fast, але буває корисним, коли сторінка потребує складнішого рендерингу.
• Деякі сторінки можуть блокувати видобування, вимагати файлів cookie або потребувати власного user_agent.