Felo Web Fetch 技能

适用场景

当用户希望执行以下操作时，触发此技能：

• 从网页 URL 获取或爬取内容
• 从链接中提取文章正文/主要内容
• 将网页转换为 Markdown 或纯文本格式
• 从 URL 中捕获可读内容，用于后续摘要生成或处理

触发关键词示例：

• fetch webpage、scrape URL、fetch page content、web fetch、url to markdown
• 显式指令：/felo-web-fetch、“use felo web fetch”
• 其他语言中表达相同意图的短语（例如：网页抓取、提取网页内容）也会触发该技能

请勿用于以下场景：

• 实时搜索或问答（应使用 felo-search）
• 生成幻灯片（应使用 felo-slides）
• 本地文件内容读取（请直接读取文件）

配置步骤

1. 获取 API 密钥

1. 访问 felo.ai
2. 进入 Settings → API Keys
3. 创建并复制您的 API 密钥

2. 配置环境变量

Linux/macOS：

export FELO_API_KEY="your-api-key-here"

Windows PowerShell：

$env:FELO_API_KEY="your-api-key-here"

执行方式

选项 A：使用内置脚本或已打包的 CLI 工具

脚本方式（来自代码仓库）：

node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com/article" [options]

已打包 CLI 工具（安装后：npm install -g felo-ai）：支持相同参数，且允许使用简写形式：

felo web-fetch -u "https://example.com" [options]
# 简写形式：-u（url）、-f（format）、-t（timeout，单位为秒）、-j（json）

可用参数说明：

如何编写指令（target_selector + output_format）

当用户希望获取页面的特定部分或指定特定输出格式时，请按如下方式组织命令：

• 输出格式：“以纯文本格式获取” / “获取Markdown” / “返回HTML” → 对应使用 --format text、--format markdown 或 --format html。
• 目标单个元素：“仅获取主文章区域” / “只取 #main 内容” / “仅提取 article.main-content” → 使用 --target-selector "article.main"，或根据用户提供的选择器填写（如：#main、.main-content、article .post）。

用户意图与等效命令示例：

执行示例：

# 基础用法：以 Markdown 格式获取
node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com"

# 启用 readability 提取文章风格内容
node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com/article" --readability --format markdown

# 获取原始 HTML 并输出完整 JSON 响应
node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --format html --json

# 仅获取匹配 CSS 选择器的元素（例如主文章）
node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --target-selector "article.main" --format markdown

# 指定输出格式 + 目标选择器
node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --target-selector "#content" --format text

选项 B：使用 curl 调用 API

curl -X POST "https://openapi.felo.ai/v2/web/extract" 
  -H "Authorization: Bearer $FELO_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"url": "https://example.com", "output_format": "markdown", "with_readability": true}'

API 参考（摘要）

• 接口地址：POST /v2/web/extract
• 基础 URL：https://openapi.felo.ai。如需自定义，可通过 FELO_API_BASE 环境变量覆盖。
• 认证方式：Authorization: Bearer YOUR_API_KEY

请求体（JSON）

响应

成功响应（HTTP 200）：

{
  "code": 0,
  "message": "success",
  "data": {
    "content": { ... }
  }
}

获取的内容位于 data.content 字段中；其结构取决于 output_format 参数。

错误码

输出格式

执行成功（脚本未使用 --json 参数）时：

• 仅打印获取到的内容（便于直接使用或管道传递）。

使用 --json 参数时：

• 打印完整的 API 响应，包括 code、message、data 字段。

用户侧错误响应示例：

## Web Fetch Failed

- Error: 
- URL: 
- Suggestion: