用途：felo-x-search 用于查询 X（Twitter）数据，当用户需要查找 X 用户资料、按关键词搜索 X 用户、获取某用户推文、按关键词或高级查询搜索推文、获取推文回复时触发。触发词包括 twitter、tweet、X user、X search、tweets from、replies to、trending on X，以及推特、推文、X用户、X搜索、推文回复，亦可使用 /felo-x-search 等显式命令。不适用于通用网页搜索（用 felo-search）、网页抽取（用 felo-web-extract）或生成幻灯片（用 felo-slides）。
主要能力：提供用户资料批量查询、用户搜索、用户推文获取、推文搜索、推文回复获取五类接口。
使用方式：先获取 API Key，在 felo.ai 的 Settings -> API Keys 创建并复制，然后设置环境变量，Linux/macOS 使用 export FELO_API_KEY="your-api-key-here"，Windows PowerShell 使用 $env:FELO_API_KEY="your-api-key-here"。可通过打包 CLI（npm install -g felo-ai 后运行 felo x [query] [options]）或仓库脚本 node felo-x-search/scripts/run_x_search.mjs [query] [options] 执行。x 命令通过参数组合推断意图：带 query 时默认搜索推文，加 --user 搜索用户；带 --id 时默认获取推文回复，加 --user 获取用户信息，再加 --tweets 获取用户推文。常用选项包括 -q/--query、--id、--user、--tweets、-l/--limit、--cursor、--include-replies、--query-type、--since-time、--until-time、-j/--json、-t/--timeout。也可直接调用 API，基址为 https://openapi.felo.ai，认证头为 Authorization: Bearer YOUR_API_KEY，端点包括 /v2/x/user/info、/v2/x/user/search、/v2/x/user/tweets、/v2/x/tweet/search、/v2/x/tweet/replies。
限制：必须提供 FELO_API_KEY，若未设置需显示配置说明并停止；常见错误码为 INVALID_API_KEY 与 X_SEARCH_FAILED；默认输出 Markdown 格式，使用 --json 输出原始响应；分页使用 next_cursor；推文搜索支持与 X 高级搜索相同的高级查询语法。API 基址可用 FELO_API_BASE 环境变量覆盖。