Felo APIs

Web Fetch API

Ekstrak kandungan halaman web sebagai HTML, teks atau Markdown dengan pilihan selector dan readability.

POST/v2/web/extract

Pengesahan

Bearer API key

Jenis kandungan

application/json

Nota had kadar

Had khusus endpoint mungkin terpakai.

YouTube Subtitling Chat API

Web Fetch API mengekstrak kandungan daripada URL sasaran dan mengembalikan hasil dalam format yang lebih mudah diproses oleh ejen, sistem RAG, dan aliran kerja kandungan. Ia boleh mengembalikan HTML, teks biasa, atau Markdown, dan ia menyokong pemilih, pilihan kebolehbacaan, kawalan cache, agen pengguna tersuai, dan kuki permintaan.

Endpoint

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

Pengesahan

Hantar kunci API anda dalam pengepala Authorization:

Authorization: Bearer YOUR_API_KEY

Lihat Panduan Pengesahan untuk butiran tentang mencipta dan mengurus kunci API.

Guna dengan Ejen AI

Pasang pakej lengkap felo-ai apabila anda mahu Ejen mengekstrak halaman web bersama setiap Felo Skill lain yang tersedia. Pemasang menemui secara dinamik setiap direktori pakej yang mengandungi SKILL.md, jadi ia tidak sekali-kali bergantung pada senarai tetap. Pasang semua Skill yang ditemui dalam ~/.codex/skills Codex, ~/.claude/skills Claude Code, ~/.agents/skills OpenClaw, atau ~/.hermes/skills Hermes Agent. Gunakan panduan persediaan Ejen AI manual untuk langkah pemasangan selamat dan kunci API bagi setiap platform.

Permintaan

Pengepala

Pengepala	Wajib	Penerangan
`Authorization`	Ya	Kunci API anda dalam format `Bearer YOUR_API_KEY`
`Content-Type`	Ya	Mesti `application/json`

Parameter Badan

Parameter	Jenis	Wajib	Lalai	Penerangan
`url`	string	Ya	-	URL halaman web untuk diekstrak.
`crawl_mode`	string	Tidak	`fast`	Mod pengekstrakan. Gunakan `fast` untuk pengambilan lebih pantas atau `fine` untuk crawl lebih tepat yang mungkin mengendalikan halaman lebih kaya.
`output_format`	string	Tidak	`html`	Format output. Nilai yang disokong: `html`, `text`, `markdown`.
`with_readability`	boolean or string	Tidak	-	Dayakan pemprosesan kebolehbacaan untuk menumpukan pada kandungan utama dan mengurangkan bunyi halaman.
`with_links_summary`	boolean	Tidak	-	Sertakan ringkasan pautan apabila disokong oleh pengekstrak hiliran.
`with_images_summary`	boolean	Tidak	-	Sertakan ringkasan imej apabila disokong.
`with_images_readability`	boolean	Tidak	-	Gunakan pengendalian kebolehbacaan pada pengekstrakan imej apabila disokong.
`with_images`	boolean	Tidak	-	Sertakan maklumat imej dalam hasil yang diekstrak.
`with_links`	boolean	Tidak	-	Sertakan maklumat pautan dalam hasil yang diekstrak.
`ignore_empty_text_image`	boolean	Tidak	-	Abaikan imej yang tidak mengandungi teks berguna apabila disokong.
`target_selector`	string	Tidak	-	Pemilih CSS untuk elemen sasaran yang hendak diekstrak, seperti `article.main-content`.
`wait_for_selector`	string	Tidak	-	Tunggu sehingga pemilih CSS muncul sebelum pengekstrakan. Berguna untuk halaman yang dipaparkan secara dinamik.
`set_cookies`	array	Tidak	-	Kuki untuk dihantar bersama permintaan pengekstrakan.
`user_agent`	string	Tidak	-	Rentetan User-Agent tersuai untuk permintaan pengekstrakan.
`timeout`	integer	Tidak	-	Tamat masa permintaan dalam milisaat.
`with_cache`	boolean	Tidak	`true`	Sama ada pengekstrak hiliran boleh menggunakan cache.
`with_stypes`	boolean	Tidak	`false`	Sertakan metadata jenis gaya apabila disokong.

Respons

Respons Berjaya

Respons menggunakan reka bentuk penghantaran telus. Medan tepat dalam data boleh berbeza bergantung pada output_format dan pilihan pengekstrakan lain.

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

Medan Respons

Medan	Jenis	Penerangan
`status`	string	Status respons. Biasanya `ok` untuk permintaan berjaya.
`message`	string atau null	Mesej tambahan. Biasanya `null` untuk permintaan berjaya.
`data`	object	Kandungan dan metadata yang diekstrak yang dikembalikan oleh perkhidmatan pengekstrakan hiliran.
`data.content`	string atau object	Kandungan yang diekstrak. Bentuknya bergantung pada `output_format` dan pilihan yang dipilih.

Respons Ralat

Status HTTP	Kod Ralat	Penerangan	Tindakan Disyorkan
400	`WEB_EXTRACT_FAILED`	Pengesahan permintaan gagal, URL tidak sah, atau pengekstrak hiliran mengembalikan ralat sebelah klien.	Semak `url`, pemilih, dan parameter permintaan.
401	`UNAUTHORIZED`	Kunci API tiada, tidak sah, atau telah dibatalkan.	Sahkan kunci API dan pengepala kebenaran anda.
500	`WEB_EXTRACT_FAILED`	Ralat perkhidmatan dalaman.	Cuba semula permintaan. Hubungi sokongan jika isu berterusan.

Contoh

Pengekstrakan Asas

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

Ekstrak Markdown dengan Kebolehbacaan

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

Ekstrak Pemilih CSS Tertentu

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

Tunggu Kandungan Dinamik

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

Kes Penggunaan

Memberikan konteks halaman web kepada ejen sebelum menjawab soalan.
Mengekstrak teks artikel untuk pengambilan RAG atau pembinaan pangkalan pengetahuan.
Menukar halaman web kepada Markdown untuk arkib atau aliran kerja dokumentasi.
Mengambil kandungan fokus daripada halaman dengan menggunakan pemilih CSS.
Mengurangkan bunyi halaman dengan pemprosesan kebolehbacaan sebelum analisis AI hiliran.

Nota

API ini mengendalikan satu URL setiap permintaan.
data dihantar terus daripada perkhidmatan pengekstrakan hiliran, jadi medan tambahan mungkin muncul dari semasa ke semasa.
Mod fine mungkin lebih perlahan daripada fast, tetapi boleh berguna apabila halaman memerlukan tingkah laku paparan yang lebih kaya.
Sesetengah halaman mungkin menyekat pengekstrakan, memerlukan kuki, atau memerlukan user_agent tersuai.