Felo X 搜索技能

适用场景

当用户希望执行以下操作时，触发该技能：

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

触发关键词示例：

• 英文：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 命令通过参数组合自动推断用户意图，无需子命令。

带查询关键词（搜索模式）：

带 --id 参数（查询模式）：

参数说明

选项 B：使用 curl 调用 API

# 搜索推文
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}'

# 搜索用户
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"}'

# 获取用户信息
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"]}'

# 获取用户推文
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}'

# 获取推文回复
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 格式输出；如需原始 API 响应，请使用 --json 参数。
• 如需获取更多结果，请使用分页游标（next_cursor）。
• 推文搜索支持高级查询语法（与 X 平台的高级搜索语法一致）。

参考资料

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