felo-ai 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.7] - 2025-03-06
+
+### Breaking Changes
+
+- **CLI 命令与技能重命名：web extract → web fetch**
+  - 命令 `felo web-extract` 已更名为 `felo web-fetch`，请更新脚本与文档。
+  - 独立脚本路径由 `felo-web-extract/scripts/run_web_extract.mjs` 改为 `felo-web-fetch/scripts/run_web_fetch.mjs`。
+  - 技能/目录名由 `felo-web-extract` 改为 `felo-web-fetch`；触发词示例：`/felo-web-fetch`、`use felo web fetch`。
+  - 后端 API 路径未变（仍为 `POST /v2/web/extract`），仅产品对外名称改为「Web Fetch」。
+
+### Changed
+
+- 产品名称统一为「Web Fetch」：README、SKILL、package 描述与关键词已同步更新。
+- `felo-youtube-subtitling` 技能中「网页内容」相关引用已更新为 `felo-web-fetch`。
+
+---
+
+## [0.2.6] - (previous)
+
+Earlier releases: search, slides, web extract, youtube-subtitling features.
+
+[0.2.7]: https://github.com/Felo-Inc/felo-skills/compare/v0.2.6...v0.2.7
+[0.2.6]: https://github.com/Felo-Inc/felo-skills/releases/tag/v0.2.6

package/README.en.md

@@ -56,7 +56,7 @@ Get your API key at [felo.ai](https://felo.ai) (Settings → API Keys).
 |---------|-------------|
 | `felo search "<query>"` | Real-time search |
 | `felo slides "<prompt>"` | Generate PPT |
-| `felo web-extract --url <url>` | Extract webpage content (markdown/text/html) |
+| `felo web-fetch --url <url>` | Fetch webpage content (markdown/text/html) |
 | `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles |
 | `felo config set FELO_API_KEY <key>` | Save API key |
 | `felo config get/list/path/unset` | View / list / path / remove config |
@@ -81,12 +81,12 @@ felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
 npx felo-ai slides "Tokyo travel guide, 5 slides"
 ```
 
-**Web extract**
+**Web fetch**
 
 ```bash
-felo web-extract --url "https://example.com"
-felo web-extract --url "https://example.com" --format text --readability
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --format markdown
+felo web-fetch --url "https://example.com"
+felo web-fetch --url "https://example.com" --format text --readability
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --format markdown
 ```
 
 **YouTube subtitling**
@@ -111,7 +111,7 @@ After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in
 
 **Slides (PPT)** — `npx @claude/skills add felo-slides`, then `/felo-slides your topic`. Same `FELO_API_KEY`. [Details →](./felo-slides/README.md)
 
-**Web Extract** — `felo web-extract --url "https://example.com"` or run `node felo-web-extract/scripts/run_web_extract.mjs` from repo. [Details →](./felo-web-extract/README.md)
+**Web Fetch** — `felo web-fetch --url "https://example.com"` or run `node felo-web-fetch/scripts/run_web_fetch.mjs` from repo. [Details →](./felo-web-fetch/README.md)
 
 **YouTube Subtitling** — `felo youtube-subtitling -v "URL_or_VIDEO_ID"` or run `node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs` from repo. [Details →](./felo-youtube-subtitling/README.md)
 

package/README.md

@@ -2,7 +2,7 @@
 
 **Ask anything. Get current answers. Generate slides from a prompt.**
 
-[npm package: **felo-ai**](https://www.npmjs.com/package/felo-ai) — Real-time search, PPT generation, web page extraction, and YouTube subtitles from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
+[npm package: **felo-ai**](https://www.npmjs.com/package/felo-ai) — Real-time search, PPT generation, web fetch, and YouTube subtitles from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.
 
 [![npm version](https://img.shields.io/npm/v/felo-ai.svg)](https://www.npmjs.com/package/felo-ai) [![License](https://img.shields.io/badge/license-MIT-green)]()
 
@@ -51,7 +51,7 @@ Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Enviro
 | ------------------------------------ | ----------------------------------------------------- |
 | `felo search "<query>"`              | Search for current info (weather, news, prices, etc.) |
 | `felo slides "<prompt>"`             | Generate PPT; returns link when done                 |
-| `felo web-extract --url <url>`       | Extract webpage content (markdown/text/html)          |
+| `felo web-fetch --url <url>`       | Fetch webpage content (markdown/text/html)          |
 | `felo youtube-subtitling -v <url-or-id>` | Fetch YouTube video subtitles by video URL or ID   |
 | `felo config set FELO_API_KEY <key>` | Save API key to config                                |
 | `felo config get FELO_API_KEY`       | Print stored key                                      |
@@ -79,29 +79,29 @@ felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300
 npx felo-ai slides "Tokyo travel guide, 5 slides"
 ```
 
-**Web extract** (after `npm install -g felo-ai`)
+**Web fetch** (after `npm install -g felo-ai`)
 
 ```bash
 # Packaged CLI
-felo web-extract --url "https://example.com"
-felo web-extract --url "https://example.com/article" --format markdown --readability
-felo web-extract --url "https://example.com" --target-selector "article.main" --format text
-felo web-extract --url "https://example.com" -j
-npx felo-ai web-extract --url "https://example.com" --format markdown
+felo web-fetch --url "https://example.com"
+felo web-fetch --url "https://example.com/article" --format markdown --readability
+felo web-fetch --url "https://example.com" --target-selector "article.main" --format text
+felo web-fetch --url "https://example.com" -j
+npx felo-ai web-fetch --url "https://example.com" --format markdown
 
 # From repo: run script directly (no install)
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --format markdown
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --readability -f text
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --format markdown
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --readability -f text
 ```
 
 **How to pass parameters**
 
 | Parameter | CLI option | Example | Description |
 |-----------|------------|---------|--------------|
-| URL (required) | `-u`, `--url` | `--url "https://example.com"` | Page to extract |
+| URL (required) | `-u`, `--url` | `--url "https://example.com"` | Page to fetch |
 | Output format | `-f`, `--format` | `--format text` or `-f markdown` | `html`, `text`, or `markdown` (default: markdown) |
-| Target element | `--target-selector` | `--target-selector "article.main"` | CSS selector; only this element is extracted |
-| Wait for element | `--wait-for-selector` | `--wait-for-selector ".content"` | Wait for selector before extracting (e.g. dynamic pages) |
+| Target element | `--target-selector` | `--target-selector "article.main"` | CSS selector; only this element is fetched |
+| Wait for element | `--wait-for-selector` | `--wait-for-selector ".content"` | Wait for selector before fetching (e.g. dynamic pages) |
 | Readability | `--readability` | `--readability` | Main article content only (no nav/ads) |
 | Crawl mode | `--crawl-mode` | `--crawl-mode fine` | `fast` (default) or `fine` |
 | Timeout (seconds) | `-t`, `--timeout` | `--timeout 120` or `-t 90` | Request timeout (default: 60) |
@@ -110,8 +110,8 @@ node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --
 Examples with multiple options:
 
 ```bash
-felo web-extract -u "https://example.com" -f text --readability -t 90
-felo web-extract --url "https://example.com" --target-selector "#main" --wait-for-selector ".loaded" --format markdown --json
+felo web-fetch -u "https://example.com" -f text --readability -t 90
+felo web-fetch --url "https://example.com" --target-selector "#main" --wait-for-selector ".loaded" --format markdown --json
 ```
 
 Same `FELO_API_KEY` as search/slides.
@@ -138,7 +138,7 @@ Options: `-v/--video-code` (required: **YouTube video URL** or video ID), `-l/--
 - **Request timeout?** Use `felo search "query" --timeout 120` (default 60 seconds). 5xx errors are retried automatically with backoff.
 - **Slides taking long?** Use `felo slides "topic" --poll-timeout 300` (default 1200s) to limit wait.
 - **Where is config stored?** Run `felo config path` to see the file (e.g. `~/.felo/config.json`).
-- **Web extract after install?** Use `felo web-extract --url "<page url>"`. Other params: `--format markdown|text|html`, `--readability`, `--target-selector "selector"`, `--wait-for-selector "selector"`, `--crawl-mode fast|fine`, `--timeout 120`, `--json`. See the "How to pass parameters" table above. Same API key as other commands.
+- **Web fetch after install?** Use `felo web-fetch --url "<page url>"`. Other params: `--format markdown|text|html`, `--readability`, `--target-selector "selector"`, `--wait-for-selector "selector"`, `--crawl-mode fast|fine`, `--timeout 120`, `--json`. See the "How to pass parameters" table above. Same API key as other commands.
 - **YouTube subtitles?** Use `felo youtube-subtitling -v "<url or video_id>"` (full YouTube link or 11-char ID). Optional: `-l/--language`, `--with-time`, `-j/--json`. See [felo-youtube-subtitling](./felo-youtube-subtitling/README.md).
 
 ---
@@ -181,7 +181,7 @@ Ask Claude: "What's the weather in Tokyo today?"
 
 **Felo Slides (PPT):** In terminal run `felo slides "your topic"`. In Claude Code install with `npx @claude/skills add felo-slides`, then use `/felo-slides your topic`. See [felo-slides](./felo-slides/README.md).
 
-**Felo Web Extract:** In terminal run `felo web-extract --url "https://example.com"` (see [felo-web-extract](./felo-web-extract/README.md)). In Claude Code you can install the skill and use it to extract webpage content from a URL.
+**Felo Web Fetch:** In terminal run `felo web-fetch --url "https://example.com"` (see [felo-web-fetch](./felo-web-fetch/README.md)). In Claude Code you can install the skill and use it to fetch webpage content from a URL.
 
 **Felo YouTube Subtitling:** In terminal run `felo youtube-subtitling -v "URL_or_VIDEO_ID"` (see [felo-youtube-subtitling](./felo-youtube-subtitling/README.md)). Fetches subtitles/captions; accepts full YouTube link or video ID.
 
@@ -399,6 +399,12 @@ Run CLI tests: `npm test`
 
 ---
 
+## Version history
+
+See [CHANGELOG.md](./CHANGELOG.md) for release notes (e.g. breaking changes such as `web-extract` → `web-fetch` in v0.2.7).
+
+---
+
 ## License
 
 MIT — see [LICENSE](./felo-search/LICENSE) in the repo for details.

package/{felo-web-extract → felo-web-fetch}/README.md

@@ -1,10 +1,10 @@
-# Felo Web Extract Skill
+# Felo Web Fetch Skill
 
-Extract webpage content from a URL using the [Felo Web Extract API](https://openapi.felo.ai/docs/api-reference/v2/web-extract.html).
+Fetch webpage content from a URL using the [Felo Web Extract API](https://openapi.felo.ai/docs/api-reference/v2/web-extract.html).
 
 ## Features
 
-- Extract content from any URL as **html**, **text**, or **markdown** (`--format`)
+- Fetch content from any URL as **html**, **text**, or **markdown** (`--format`)
 - **Target one element** with a CSS selector (`--target-selector`, e.g. `article.main`, `#content`)
 - Optional **readability** mode for main article content only
 - Crawl modes: `fast` (default) or `fine`
@@ -26,28 +26,28 @@ export FELO_API_KEY="your-api-key-here"
 $env:FELO_API_KEY="your-api-key-here"
 ```
 
-### 2) Run extraction
+### 2) Run fetch
 
 ```bash
-# Extract as Markdown (default)
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com/article"
+# Fetch as Markdown (default)
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com/article"
 
 # With readability for clean article text
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --readability --format markdown
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --readability --format markdown
 
 # Full JSON response
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --json
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --json
 
 # Only a specific element (CSS selector) and output format
-node felo-web-extract/scripts/run_web_extract.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 "article.main" --format markdown
 ```
 
-## Using the packaged CLI (`felo web-extract`)
+## Using the packaged CLI (`felo web-fetch`)
 
 After `npm install -g felo-ai`, you can run:
 
 ```bash
-felo web-extract --url "https://example.com"
+felo web-fetch --url "https://example.com"
 ```
 
 **All parameters (how to pass)**
@@ -66,13 +66,13 @@ felo web-extract --url "https://example.com"
 **Examples with multiple options**
 
 ```bash
-felo web-extract -u "https://example.com" -f text --readability
-felo web-extract --url "https://example.com" --target-selector "#content" --format markdown --timeout 90
-felo web-extract --url "https://example.com" --wait-for-selector "main" --readability -j
+felo web-fetch -u "https://example.com" -f text --readability
+felo web-fetch --url "https://example.com" --target-selector "#content" --format markdown --timeout 90
+felo web-fetch --url "https://example.com" --wait-for-selector "main" --readability -j
 ```
 
 ## When to use (Agent)
 
-Trigger keywords: extract webpage, scrape URL, fetch page content, url to markdown, `/felo-web-extract`.
+Trigger keywords: fetch webpage, scrape URL, fetch page content, url to markdown, `/felo-web-fetch`.
 
 See [SKILL.md](SKILL.md) for full agent instructions and API parameters.

package/{felo-web-extract → felo-web-fetch}/SKILL.md

@@ -1,23 +1,23 @@
 ---
-name: felo-web-extract
-description: "Extract web page content from a URL using Felo Web Extract API. Use when users ask to scrape/capture/fetch webpage content, extract article text from URL, convert page to markdown/text, or when explicit commands like /felo-web-extract are used. Supports html, text, markdown output and readability mode."
+name: felo-web-fetch
+description: "Fetch web page content from a URL using Felo Web Extract API. Use when users ask to scrape/capture/fetch webpage content, get article text from URL, convert page to markdown/text, or when explicit commands like /felo-web-fetch are used. Supports html, text, markdown output and readability mode."
 ---
 
-# Felo Web Extract Skill
+# Felo Web Fetch Skill
 
 ## When to Use
 
 Trigger this skill when the user wants to:
 
-- Extract or scrape content from a webpage URL
+- Fetch or scrape content from a webpage URL
 - Get article/main text from a link
 - Convert a webpage to Markdown or plain text
 - Capture readable content from a URL for summarization or processing
 
 Trigger keywords (examples):
 
-- extract webpage, scrape URL, fetch page content, web extract, url to markdown
-- Explicit: `/felo-web-extract`, "use felo web extract"
+- fetch webpage, scrape URL, fetch page content, web fetch, url to markdown
+- Explicit: `/felo-web-fetch`, "use felo web fetch"
 - Same intent in other languages (e.g. 网页抓取, 提取网页内容) also triggers this skill
 
 Do NOT use for:
@@ -55,13 +55,13 @@ $env:FELO_API_KEY="your-api-key-here"
 **Script** (from repo):
 
 ```bash
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com/article" [options]
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com/article" [options]
 ```
 
 **Packaged CLI** (after `npm install -g felo-ai`): same options, with short forms allowed:
 
 ```bash
-felo web-extract -u "https://example.com" [options]
+felo web-fetch -u "https://example.com" [options]
 # Short forms: -u (url), -f (format), -t (timeout, seconds), -j (json)
 ```
 
@@ -69,10 +69,10 @@ Options:
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `--url` | (required) | Webpage URL to extract |
+| `--url` | (required) | Webpage URL to fetch |
 | `--format` | markdown | Output format: `html`, `text`, `markdown` |
-| `--target-selector` | - | CSS selector: extract only this element (e.g. `article.main`, `#content`) |
-| `--wait-for-selector` | - | Wait for this selector before extracting (e.g. dynamic content) |
+| `--target-selector` | - | CSS selector: fetch only this element (e.g. `article.main`, `#content`) |
+| `--wait-for-selector` | - | Wait for this selector before fetching (e.g. dynamic content) |
 | `--readability` | false | Enable readability processing (main content only) |
 | `--crawl-mode` | fast | `fast` or `fine` |
 | `--timeout` | 60000 (script) / 60 (CLI) | Request timeout: script uses **milliseconds**, CLI uses **seconds** (e.g. `-t 90`) |
@@ -82,35 +82,35 @@ Options:
 
 When the user wants a **specific part** of the page or a **specific output format**, phrase the command like this:
 
-- **Output format**: "Extract as **text**" / "Get **markdown**" / "Return **html**" → use `--format text`, `--format markdown`, or `--format html`.
-- **Target one element**: "Only the **main article**" / "Just the **content inside** `#main`" / "Extract only **article.main-content**" → use `--target-selector "article.main"` or the selector they give (e.g. `#main`, `.main-content`, `article .post`).
+- **Output format**: "Fetch as **text**" / "Get **markdown**" / "Return **html**" → use `--format text`, `--format markdown`, or `--format html`.
+- **Target one element**: "Only the **main article**" / "Just the **content inside** `#main`" / "Fetch only **article.main-content**" → use `--target-selector "article.main"` or the selector they give (e.g. `#main`, `.main-content`, `article .post`).
 
 Examples of user intents and equivalent commands:
 
 | User intent | Command |
 |-------------|---------|
-| "Extract this page as plain text" | `--url "..." --format text` |
+| "Fetch this page as plain text" | `--url "..." --format text` |
 | "Get only the main content area" | `--url "..." --target-selector "main"` or `article` |
-| "Extract the div with id=content as markdown" | `--url "..." --target-selector "#content" --format markdown` |
+| "Fetch the div with id=content as markdown" | `--url "..." --target-selector "#content" --format markdown` |
 | "Just the article body, as HTML" | `--url "..." --target-selector "article .body" --format html` |
 
 Examples:
 
 ```bash
-# Basic: extract as Markdown
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com"
+# Basic: fetch as Markdown
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com"
 
 # Article-style with readability
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com/article" --readability --format markdown
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com/article" --readability --format markdown
 
 # Raw HTML
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --format html --json
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --format html --json
 
 # Only the element matching a CSS selector (e.g. main article)
-node felo-web-extract/scripts/run_web_extract.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 "article.main" --format markdown
 
 # Specific output format + target selector
-node felo-web-extract/scripts/run_web_extract.mjs --url "https://example.com" --target-selector "#content" --format text
+node felo-web-fetch/scripts/run_web_fetch.mjs --url "https://example.com" --target-selector "#content" --format text
 ```
 
 ### Option B: Call API with curl
@@ -132,14 +132,14 @@ curl -X POST "https://openapi.felo.ai/v2/web/extract" \
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| url | string | Yes | - | Webpage URL to extract |
+| url | string | Yes | - | Webpage URL to fetch |
 | crawl_mode | string | No | fast | `fast` or `fine` |
 | output_format | string | No | html | `html`, `text`, `markdown` |
 | with_readability | boolean | No | - | Use readability (main content) |
 | with_links_summary | boolean | No | - | Include links summary |
 | with_images_summary | boolean | No | - | Include images summary |
 | target_selector | string | No | - | CSS selector for target element |
-| wait_for_selector | string | No | - | Wait for selector before extract |
+| wait_for_selector | string | No | - | Wait for selector before fetch |
 | timeout | integer | No | - | Timeout in milliseconds |
 | with_cache | boolean | No | true | Use cache |
 
@@ -157,7 +157,7 @@ Success (200):
 }
 ```
 
-Extracted content is in `data.content`; structure depends on `output_format`.
+Fetched content is in `data.content`; structure depends on `output_format`.
 
 ### Error codes
 
@@ -165,13 +165,13 @@ Extracted content is in `data.content`; structure depends on `output_format`.
 |------|------|-------------|
 | 400 | - | Parameter validation failed |
 | 401 | INVALID_API_KEY | API key invalid or revoked |
-| 500/502 | WEB_EXTRACT_FAILED | Extract failed (server or page error) |
+| 500/502 | WEB_EXTRACT_FAILED | Fetch failed (server or page error) |
 
 ## Output Format
 
 On success (script without `--json`):
 
-- Print the extracted content only (for direct use or piping).
+- Print the fetched content only (for direct use or piping).
 
 With `--json`:
 
@@ -180,7 +180,7 @@ With `--json`:
 Error response to user:
 
 ```markdown
-## Web Extract Failed
+## Web Fetch Failed
 
 - Error: <code or message>
 - URL: <requested url>

package/{felo-web-extract/scripts/run_web_extract.mjs → felo-web-fetch/scripts/run_web_fetch.mjs}

@@ -28,13 +28,13 @@ function usage() {
   console.error(
     [
       'Usage:',
-      '  node felo-web-extract/scripts/run_web_extract.mjs --url <url> [options]',
+      '  node felo-web-fetch/scripts/run_web_fetch.mjs --url <url> [options]',
       '',
       'Options:',
-      '  --url <url>           Page URL to extract (required)',
+      '  --url <url>           Page URL to fetch (required)',
       '  --format <format>     Output format: html, text, markdown (default: markdown)',
       '  --target-selector <s> CSS selector for target element only',
-      '  --wait-for-selector <s> Wait for selector before extract',
+      '  --wait-for-selector <s> Wait for selector before fetch',
       '  --readability         Enable readability (main content only)',
       '  --crawl-mode <mode>   fast or fine (default: fast)',
       '  --timeout <ms>        Request timeout in ms (default: 60000)',
@@ -210,7 +210,7 @@ async function main() {
     if (isEmpty) {
       stopSpinner(spinnerId);
       process.stderr.write(
-        `No content extracted from ${args.url}. The page may be empty, blocked, or the selector did not match.\n`
+        `No content fetched from ${args.url}. The page may be empty, blocked, or the selector did not match.\n`
       );
       process.exit(1);
     }
@@ -226,7 +226,7 @@ main().catch((err) => {
   const i = argv.findIndex((a) => a === '--url' || a === '-u');
   if (i >= 0 && argv[i + 1]) url = argv[i + 1];
   process.stderr.write(
-    `Web extract failed${url ? ` for ${url}` : ''}: ${err?.message || err}\n`
+    `Web fetch failed${url ? ` for ${url}` : ''}: ${err?.message || err}\n`
   );
   process.exit(1);
 });

package/felo-youtube-subtitling/SKILL.md

@@ -22,7 +22,7 @@ Trigger keywords (examples):
 Do NOT use for:
 
 - Real-time search (use `felo-search`)
-- Web page content (use `felo-web-extract`)
+- Web page content (use `felo-web-fetch`)
 - Generating slides (use `felo-slides`)
 
 ## Setup

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "felo-ai",
-  "version": "0.2.6",
-  "description": "Felo AI CLI - real-time search, PPT generation, web extract, and YouTube subtitles from the terminal",
+  "version": "0.2.7",
+  "description": "Felo AI CLI - real-time search, PPT generation, web fetch, and YouTube subtitles from the terminal",
   "type": "module",
   "main": "src/cli.js",
   "bin": {
@@ -15,7 +15,7 @@
     "felo-ai",
     "search",
     "slides",
-    "web-extract",
+    "web-fetch",
     "youtube-subtitles",
     "cli",
     "ai"

package/src/cli.js

@@ -4,7 +4,7 @@ import { createRequire } from "module";
 import { Command } from "commander";
 import { search } from "./search.js";
 import { slides } from "./slides.js";
-import { webExtract } from "./webExtract.js";
+import { webFetch } from "./webFetch.js";
 import { youtubeSubtitling } from "./youtubeSubtitling.js";
 import * as config from "./config.js";
 
@@ -177,9 +177,9 @@ configCmd
   });
 
 program
-  .command("web-extract")
-  .description("Extract webpage content from a URL (markdown, text, or html)")
-  .requiredOption("-u, --url <url>", "page URL to extract")
+  .command("web-fetch")
+  .description("Fetch webpage content from a URL (markdown, text, or html)")
+  .requiredOption("-u, --url <url>", "page URL to fetch")
   .option(
     "-f, --format <format>",
     "output format: html, text, markdown",
@@ -191,7 +191,7 @@ program
   )
   .option(
     "--wait-for-selector <selector>",
-    "wait for selector before extracting"
+    "wait for selector before fetching"
   )
   .option("--readability", "use readability (main content only)")
   .option("--crawl-mode <mode>", "crawl mode: fast or fine", "fast")
@@ -199,7 +199,7 @@ program
   .option("-j, --json", "output full API response as JSON")
   .action(async (opts) => {
     const timeoutMs = parseInt(opts.timeout, 10) * 1000;
-    const code = await webExtract({
+    const code = await webFetch({
       url: opts.url,
       format: opts.format,
       targetSelector: opts.targetSelector,

package/src/{webExtract.js → webFetch.js}

@@ -49,7 +49,7 @@ function stringifyContent(content) {
   return String(content);
 }
 
-async function fetchExtract(apiBase, apiKey, body, timeoutMs) {
+async function fetchContent(apiBase, apiKey, body, timeoutMs) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -86,10 +86,10 @@ async function fetchExtract(apiBase, apiKey, body, timeoutMs) {
 }
 
 /**
- * Run web extract and print result. Returns exit code (0 or 1).
+ * Run web fetch and print result. Returns exit code (0 or 1).
  * @param {Object} opts - { url, format, targetSelector, waitForSelector, readability, timeoutMs, json }
  */
-export async function webExtract(opts) {
+export async function webFetch(opts) {
   const apiKey = await getApiKey();
   if (!apiKey) {
     console.error(NO_KEY_MESSAGE.trim());
@@ -119,7 +119,7 @@ export async function webExtract(opts) {
   if (opts.waitForSelector) body.wait_for_selector = opts.waitForSelector;
 
   try {
-    const payload = await fetchExtract(apiBase, apiKey, body, timeoutMs);
+    const payload = await fetchContent(apiBase, apiKey, body, timeoutMs);
     const content = payload?.data?.content;
 
     if (opts.json) {
@@ -131,7 +131,7 @@ export async function webExtract(opts) {
     const isEmpty = out == null || String(out).trim() === '';
     if (isEmpty) {
       process.stderr.write(
-        `No content extracted from ${opts.url}. The page may be empty, blocked, or the selector did not match.\n`
+        `No content fetched from ${opts.url}. The page may be empty, blocked, or the selector did not match.\n`
       );
       return 1;
     }
@@ -139,7 +139,7 @@ export async function webExtract(opts) {
     return 0;
   } catch (err) {
     process.stderr.write(
-      `Web extract failed for ${opts.url}: ${err?.message || err}\n`
+      `Web fetch failed for ${opts.url}: ${err?.message || err}\n`
     );
     return 1;
   } finally {