felo-ai 0.2.9 → 0.2.11

package/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.10] - 2026-03-10
+
+### Fixed
+
+- 修复 `felo-x-search` API 请求路径缺少 `/v2` 前缀的问题。
+
+---
+
 ## [0.2.7] - 2025-03-06
 
 ### Breaking Changes
@@ -26,5 +34,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Earlier releases: search, slides, web fetch, youtube-subtitling features.
 
+[0.2.10]: https://github.com/Felo-Inc/felo-skills/compare/v0.2.9...v0.2.10
 [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.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 fetch, 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 page extraction, YouTube subtitles, and X (Twitter) search 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)]()
 
@@ -53,6 +53,7 @@ Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Enviro
 | `felo slides "<prompt>"`             | Generate PPT; returns link when done                 |
 | `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 x "<query>"`                       | Search X (Twitter) tweets, users, and replies       |
 | `felo config set FELO_API_KEY <key>` | Save API key to config                                |
 | `felo config get FELO_API_KEY`       | Print stored key                                      |
 | `felo config list`                   | List config keys                                      |
@@ -132,6 +133,32 @@ node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ"
 
 Options: `-v/--video-code` (required: **YouTube video URL** or video ID), `-l/--language` (e.g. en, zh-CN), `--with-time`, `-j/--json`. Same `FELO_API_KEY` as other commands. See [felo-youtube-subtitling](./felo-youtube-subtitling/README.md).
 
+**X (Twitter) search** (after `npm install -g felo-ai`)
+
+```bash
+# Search tweets
+felo x "AI news"
+felo x "AI news" --limit 10 --json
+
+# Search users
+felo x "OpenAI" --user
+
+# Get user info
+felo x --id "elonmusk" --user
+
+# Get user tweets
+felo x --id "elonmusk" --user --tweets
+felo x --id "elonmusk" --user --tweets --include-replies --limit 20
+
+# Get tweet replies
+felo x --id "1234567890"
+
+# From repo: run script directly (no install)
+node felo-x-search/scripts/run_x_search.mjs "AI news"
+```
+
+Options: `[query]` or `-q/--query` (search keyword), `--id` (tweet IDs or usernames, comma-separated), `--user` (user mode), `--tweets` (get user tweets), `-l/--limit`, `--cursor`, `--include-replies`, `--query-type`, `--since-time`, `--until-time`, `-j/--json`, `-t/--timeout`. Same `FELO_API_KEY` as other commands. See [felo-x-search](./felo-x-search/SKILL.md).
+
 ### CLI FAQ
 
 - **Key not found?** Run `felo config set FELO_API_KEY <key>` or set the `FELO_API_KEY` environment variable.
@@ -140,6 +167,7 @@ Options: `-v/--video-code` (required: **YouTube video URL** or video ID), `-l/--
 - **Where is config stored?** Run `felo config path` to see the file (e.g. `~/.felo/config.json`).
 - **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).
+- **X (Twitter) search?** Use `felo x "<query>"` to search tweets, `felo x "<query>" --user` to search users, `felo x --id "<username>" --user` for user info, `felo x --id "<username>" --user --tweets` for user tweets, `felo x --id "<tweet_id>"` for tweet replies. See [felo-x-search](./felo-x-search/SKILL.md).
 
 ---
 
@@ -185,6 +213,8 @@ Ask Claude: "What's the weather in Tokyo today?"
 
 **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.
 
+**Felo X Search:** In terminal run `felo x "query"` to search tweets, users, and replies on X (Twitter) (see [felo-x-search](./felo-x-search/SKILL.md)). In Claude Code install the skill and use it to search X content.
+
 ---
 
 ## Usage Examples
@@ -367,6 +397,10 @@ Generate PPT: in terminal use `felo slides "your topic"`, in Claude Code use `/f
 
 Fetch and extract webpage content: in terminal use `felo web-fetch --url "https://example.com"`, in Claude Code use `/felo-web-fetch https://example.com`. **[View skill documentation →](./felo-web-fetch/)**
 
+### felo-x-search
+
+Search X (Twitter) tweets, users, and replies: in terminal use `felo x "query"`, in Claude Code use `/felo-x-search query`. **[View skill documentation →](./felo-x-search/SKILL.md)**
+
 ---
 
 ## Contributing

package/felo-x-search/README.md

@@ -0,0 +1,81 @@
+# Felo X Search Skill
+
+Search X (Twitter) tweets, users, and replies using the [Felo X Search API](https://openapi.felo.ai/docs/api-reference/v2/x-search.html).
+
+## Features
+
+- **Search tweets** by keyword with advanced query support
+- **Search users** by keyword
+- **Get user info** by username (batch supported)
+- **Get user tweets** by username, with optional replies
+- **Get tweet replies** by tweet ID
+- Same `FELO_API_KEY` as other Felo skills
+
+## Quick Start
+
+### 1) Configure API key
+
+At [felo.ai](https://felo.ai) -> Settings -> API Keys, create a key, then:
+
+```bash
+# Linux/macOS
+export FELO_API_KEY="your-api-key-here"
+```
+
+```powershell
+# Windows PowerShell
+$env:FELO_API_KEY="your-api-key-here"
+```
+
+### 2) Run
+
+```bash
+# From repo: script
+node felo-x-search/scripts/run_x_search.mjs "AI news"
+
+# After npm install -g felo-ai: CLI
+felo x "AI news"
+```
+
+## All parameters
+
+| Parameter | Option | Example |
+|-----------|--------|---------|
+| Search keyword | `[query]` or `-q, --query` | `felo x "AI news"` or `-q "AI news"` |
+| Tweet IDs or usernames | `--id` | `--id "elonmusk"` or `--id "123,456"` |
+| User mode | `--user` | `--user` |
+| Get user tweets | `--tweets` | `--tweets` (with `--id --user`) |
+| Result limit | `-l, --limit` | `--limit 20` |
+| Pagination cursor | `--cursor` | `--cursor "abc123"` |
+| Include replies | `--include-replies` | `--include-replies` (with `--tweets`) |
+| Query type filter | `--query-type` | `--query-type "Latest"` |
+| Start time filter | `--since-time` | `--since-time "2026-01-01"` |
+| End time filter | `--until-time` | `--until-time "2026-03-01"` |
+| Full JSON response | `-j, --json` | `-j` |
+| Timeout (seconds) | `-t, --timeout` | `-t 60` |
+
+## Usage patterns
+
+**Search mode** (with query):
+
+```bash
+felo x "AI news"                    # Search tweets (default)
+felo x "OpenAI" --user              # Search users
+felo x "AI" --limit 10 --json      # Search with limit, raw JSON output
+```
+
+**Lookup mode** (with --id):
+
+```bash
+felo x --id "elonmusk" --user                       # Get user info
+felo x --id "elonmusk,OpenAI" --user                # Batch user info
+felo x --id "elonmusk" --user --tweets              # Get user tweets
+felo x --id "elonmusk" --user --tweets --limit 20   # With limit
+felo x --id "1234567890"                            # Get tweet replies
+```
+
+## When to use (Agent)
+
+Trigger keywords: twitter, tweet, X user, X search, tweets from, replies to, trending on X, 推特, 推文, `/felo-x-search`.
+
+See [SKILL.md](SKILL.md) for full agent instructions and API parameters.

package/felo-x-search/SKILL.md

@@ -109,31 +109,31 @@ The `x` command uses parameter combinations to infer intent — no subcommands n
 
 ```bash
 # Search tweets
-curl -X POST "https://openapi.felo.ai/x/tweet/search" \
+curl -X POST "https://openapi.felo.ai/v2/x/tweet/search" \
   -H "Authorization: Bearer $FELO_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"query": "AI news", "limit": 20}'
 
 # Search users
-curl -X POST "https://openapi.felo.ai/x/user/search" \
+curl -X POST "https://openapi.felo.ai/v2/x/user/search" \
   -H "Authorization: Bearer $FELO_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"query": "artificial intelligence"}'
 
 # Get user info
-curl -X POST "https://openapi.felo.ai/x/user/info" \
+curl -X POST "https://openapi.felo.ai/v2/x/user/info" \
   -H "Authorization: Bearer $FELO_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"usernames": ["elonmusk", "OpenAI"]}'
 
 # Get user tweets
-curl -X POST "https://openapi.felo.ai/x/user/tweets" \
+curl -X POST "https://openapi.felo.ai/v2/x/user/tweets" \
   -H "Authorization: Bearer $FELO_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"username": "elonmusk", "limit": 20}'
 
 # Get tweet replies
-curl -X POST "https://openapi.felo.ai/x/tweet/replies" \
+curl -X POST "https://openapi.felo.ai/v2/x/tweet/replies" \
   -H "Authorization: Bearer $FELO_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"tweet_ids": ["1234567890"]}'
@@ -185,11 +185,11 @@ If `FELO_API_KEY` is not set, display setup instructions and stop.
 - **Base URL**: `https://openapi.felo.ai`. Override with `FELO_API_BASE` env if needed.
 - **Auth**: `Authorization: Bearer YOUR_API_KEY`
 - **Endpoints**:
-  - `POST /x/user/info` — Batch get user profiles
-  - `POST /x/user/search` — Search users
-  - `POST /x/user/tweets` — Get user tweets
-  - `POST /x/tweet/search` — Search tweets
-  - `POST /x/tweet/replies` — Get tweet replies
+  - `POST /v2/x/user/info` — Batch get user profiles
+  - `POST /v2/x/user/search` — Search users
+  - `POST /v2/x/user/tweets` — Get user tweets
+  - `POST /v2/x/tweet/search` — Search tweets
+  - `POST /v2/x/tweet/replies` — Get tweet replies
 
 ## Important Notes
 

package/felo-x-search/scripts/run_x_search.mjs

@@ -62,7 +62,7 @@ async function fetchWithRetry(url, init, timeoutMs) {
 
 async function postApi(apiBase, apiKey, path, body, timeoutMs) {
   const res = await fetchWithRetry(
-    `${apiBase}${path}`,
+    `${apiBase}/v2${path}`,
     {
       method: 'POST',
       headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Felo AI CLI - real-time search, PPT generation, web fetch, and YouTube subtitles from the terminal",
   "type": "module",
   "main": "src/cli.js",