felo-x-search

Files (5)

• README.md
• SKILL.md
• clawhub.json
• githubclaw.json
• run_x_search.mjs · scripts/

SKILL.md (first lines)

# 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. Visit [felo.ai](https://felo.ai)
2. Open Settings -> API Keys
3. Create and copy your API key

### 2. Configure environment variable

Linux/macOS:

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

Windows PowerShell:

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

## How to Execute

### Option A: Use the bundled script or packaged CLI

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

```bash
felo x [query] [options]
```

**Script** (from repo):

```bash
node .agents/skills/felo-x-search/scripts/run_x_search.mjs [query] [options]
```

### Usage Pattern

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

**With query (search mode):**

| Usage | Behavior |
|-------|----------|
| `felo x "AI news"` | Search tweets (default) |
| `felo x -q "AI news"` | Same as above |
| `felo x "OpenAI" --user` | Search users |

**With --id (lookup mode):**

| Usage | Behavior |
|-------|----------|
| `felo x --id "1234567890"` | Get tweet replies (default) |
| `felo x --id "elonmusk" --user` | Get user info |
| `felo x --id "elonmusk" --user --tweets` | Get user tweets |

### Options

| Option | Description |
|--------|-------------|
| `[query]` | Positional arg, search keyword (equivalent to -q) |
| `-q, --query <text>` | 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

```bash
# Search tweets
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/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/v2/x/user/info" \

From duotify/GitHubClawToolkit, MIT.

More from duotify/GitHubClawToolkit