Felo X Search Skill

When to Use

Trigger this skill when the user wants to:

• - Look up X (Twitter) user profiles by username
• Search for X users by keyword
• Get tweets from a specific X user
• Search tweets by keyword or advanced query
• Get replies to specific tweets

Trigger keywords (examples):

• - English: twitter, tweet, X user, X search, tweets from, replies to, trending on X
• 简体中文: 推特, 推文, X用户, X搜索, 推文回复
• 日本語: ツイッター, ツイート, Xユーザー, X検索

Explicit commands: /felo-x-search, "search X", "search twitter"

Do NOT use for:

• - General web search (use felo-search)
• Webpage extraction (use felo-web-extract)
• Generating slides (use felo-slides)

Setup

1. Get API key

1. 1. Visit felo.ai
2. Open Settings -> API Keys
3. Create and copy your API key

2. Configure environment variable

Linux/macOS:

CODEBLOCK0

Windows PowerShell:

CODEBLOCK1

How to Execute

Option A: Use the bundled script or packaged CLI

Packaged CLI (after npm install -g felo-ai):

CODEBLOCK2

Script (from repo):

CODEBLOCK3

Usage Pattern

The x command uses parameter combinations to infer intent — no subcommands needed.

With query (search mode):

Usage	Behavior
INLINECODE6	Search tweets (default)
INLINECODE7

Same as above |
| felo x "OpenAI" --user | Search users |

With --id (lookup mode):

Usage	Behavior
INLINECODE9	Get tweet replies (default)
INLINECODE10

Get user info |
| felo x --id "elonmusk" --user --tweets | Get user tweets |

Options

Option	Description
INLINECODE12	Positional arg, search keyword (equivalent to -q)
INLINECODE13

Search keyword | | --id <values> | Tweet IDs or usernames (comma-separated) | | --user | Switch to user mode | | --tweets | Get user tweets (with --id --user) | | -l, --limit <n> | Number of results | | --cursor <str> | Pagination cursor | | --include-replies | Include replies (with --tweets) | | --query-type <type> | Query type filter (tweet search) | | --since-time <val> | Start time filter | | --until-time <val> | End time filter | | -j, --json | Output raw JSON | | -t, --timeout <seconds> | Timeout in seconds (default: 30) |

Option B: Call API with curl

CODEBLOCK4

Output Format

User Info (default, non-JSON)

CODEBLOCK5

Tweet (default, non-JSON)

CODEBLOCK6

Error Handling

Common Error Codes

• - INVALID_API_KEY — API Key is invalid or revoked
• INLINECODE26 — X search request failed (check parameters or downstream error)

Missing API Key

If FELO_API_KEY is not set, display setup instructions and stop.

API Reference (summary)

• - Base URL: https://openapi.felo.ai. Override with FELO_API_BASE env if needed.
• Auth: INLINECODE30
• Endpoints:

- 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

• - Always check FELO_API_KEY before calling; if missing, return setup instructions.
• Format output as readable Markdown by default; use --json for raw API response.
• Use pagination cursors (next_cursor) for fetching more results.
• For tweet search, advanced query syntax is supported (same as X advanced search).

References

• - Felo X Search API
• Felo Open Platform