felo-x-search

Felo X 搜索技能

适用场景

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

• 按用户名查找 X（Twitter）用户资料
• 按关键词搜索 X 用户
• 获取特定 X 用户发布的推文
• 按关键词或高级查询搜索推文
• 获取特定推文的回复

触发关键词（示例）：

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

明确命令：/felo-x-search、"search X"、"search twitter"

请勿用于：

• 通用网页搜索（使用 felo-search）
• 网页内容提取（使用 felo-web-extract）
• 生成幻灯片（使用 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

打包的 CLI（执行 npm install -g felo-ai 后）：

felo x [query] [options]

脚本（来自仓库）：

node felo-x-search/scripts/run_x_search.mjs [query] [options]

使用模式

x 命令会根据参数组合推断意图——无需子命令。

带查询词（搜索模式）：

用法	行为
felo x "AI news"	搜索推文（默认）
felo x -q "AI news"	同上
felo x "OpenAI" --user	搜索用户

带 --id（查询模式）：

用法	行为
felo x --id "1234567890"	获取推文回复（默认）
felo x --id "elonmusk" --user	获取用户信息
felo x --id "elonmusk" --user --tweets	获取用户推文

选项

选项	描述
[query]	位置参数，搜索关键词（等同于 -q）
-q, --query <text>	搜索关键词
--id <values>	推文 ID 或用户名（以逗号分隔）
--user	切换到用户模式
--tweets	获取用户推文（与 --id --user 配合使用）
-l, --limit <n>	结果数量
--cursor <str>	分页游标
--include-replies	包含回复（与 --tweets 配合使用）
--query-type <type>	查询类型筛选条件（推文搜索）
--since-time <val>	起始时间筛选条件
--until-time <val>	结束时间筛选条件
-j, --json	输出原始 JSON
-t, --timeout <seconds>	超时时间（秒，默认值：30）

选项 B：使用 curl 调用 API

# 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" \
  -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/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/v2/x/tweet/replies" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_ids": ["1234567890"]}'

输出格式

用户信息（默认，非 JSON）

## @elonmusk (Elon Musk 🔵)
- User ID: `44196397`
- Followers: 100.0M
- Following: 500
- Total Tweets: 30.0K
- Bio: ...
- Location: Mars
- Account Created: 2009-06-02T00:00:00Z

---

推文（默认，非 JSON）

### @elonmusk(Elon Musk ✓)
- Posted: 2026-03-09T12:00:00Z ｜ Tweet ID: `1234567890`

Tweet content here...

Engagement: 5.0K likes ｜ 1.0K retweets ｜ 200 replies

---

错误处理

常见错误代码

• INVALID_API_KEY — API 密钥无效或已撤销
• X_SEARCH_FAILED — X 搜索请求失败（检查参数或下游错误）

缺少 API 密钥

如果未设置 FELO_API_KEY，请显示设置说明并停止。

API 参考（摘要）

• 基础 URL：https://openapi.felo.ai。如有需要，可通过 FELO_API_BASE 环境变量覆盖。
• 身份验证：Authorization: Bearer YOUR_API_KEY
• 端点：
  • POST /v2/x/user/info — 批量获取用户资料
  • POST /v2/x/user/search — 搜索用户
  • POST /v2/x/user/tweets — 获取用户推文
  • POST /v2/x/tweet/search — 搜索推文
  • POST /v2/x/tweet/replies — 获取推文回复

重要说明

• 调用前务必检查 FELO_API_KEY；如果未设置，请返回设置说明。
• 默认将输出格式设为易读的 Markdown；使用 --json 获取原始 API 响应。
• 使用分页游标（next_cursor）获取更多结果。
• 推文搜索支持高级查询语法（与 X 高级搜索相同）。

参考资料

• Felo X 搜索 API
• Felo 开放平台