SuperAPI AI 工具集

octen-extract

数据与分析

查看项目

更新于 10-16 10:21

技能介绍

Octen Extract 用于从网页 URL 提取干净、可直接供 LLM 使用的内容,由 Octen 提供。调用一次可批量抓取 1–20 个 URL,返回 markdown 或 text 正文;除正文外,每条结果还带有 category(页面主题)与 page_structure(页面类型)标签;若传入 query,则返回与查询相关的 highlights 而非整页正文。

使用前需配置 API Key:在 https://octen.ai 获取,并设置 export OCTEN_API_KEY=your-api-key(Claude Code、Cursor、Codex、OpenClaw 等可按各自方式配置)。接口为 POST https://api.octen.ai/extract,认证使用 X-Api-Key 头,Content-Type 为 application/json。

主要参数:urls(必填,1–20 个);mode 可选 standard(默认)、advanced、auto;query;max_age_seconds(默认 86400,最小 300);format(默认 markdown);timeout(默认 30 秒,1–60);include_images、include_videos、include_audio(默认 false);include_links({scope, max_links},scope 可选 prefer_internal 或 prefer_external,max_links 1–1000)。

模式选择:普通结构良好的页面(新闻、博客、文档、产品页)用 standard,最快最便宜;已知困难站点(反爬、JS 重的 SPA、Reddit、X、LinkedIn、ResearchGate)用 advanced,成功率更高但更慢且价格为 2.5 倍;不确定的混合批次用 auto,按 URL 分别决定。standard 失败或返回空内容时,可用 advanced 重试。advanced 与 auto 较慢,建议提高 timeout。

响应包含 request_id、data.results[](每条含 url、status、resolved_mode、error_message、title、full_content 或 highlights、category、page_structure、时间字段、favicon、媒体与 links 等)以及顶层 meta.usage 计费统计。支持部分成功:失败 URL 返回 status: failed 与错误信息,同批其余 URL 仍可成功,需逐条检查 status。错误码:400 参数错误、401 密钥无效、403 余额不足、429 限流、500 内部错误。计价:standard 每 1000 个成功 URL 1 美元,advanced 每 1000 个 2.5 美元;失败 URL 不计费。