名称： search-x
描述： 使用 Grok 或 X API 实时搜索 X/Twitter。查找推文、趋势和讨论，并提供引用来源。
主页： https://docs.x.ai
user-invocable: true
disable-model-invocation: true
触发器：
- search x
- search twitter
- find tweets
- what's on x about
- x search
- twitter search
元数据：
clawdbot:
emoji: "🔍"
primaryEnv: XAI_API_KEY
requires:
bins: [node]
env: [XAI_API_KEY]

搜索 X

提供两种模式的实时 X/Twitter 搜索：
1. xAI Grok（默认）—— 使用 x_search 工具的 AI 驱动搜索，支持最多 30 天历史记录
2. X API (--x-api) —— 原生 X 搜索，支持最多 7 天历史记录，按使用量付费

设置

选项 1：xAI API（默认模式）

export XAI_API_KEY="xai-YOUR-KEY"

获取密钥：https://console.x.ai

选项 2：X API（原生模式）

export X_BEARER_TOKEN="YOUR-BEARER-TOKEN"

获取令牌：https://console.x.com

注意： X API 采用按使用量付费的定价模式，无需订阅。

命令

基础搜索（xAI Grok 模式）

node {baseDir}/scripts/search.js "AI 视频编辑"

原生 X API 搜索

node {baseDir}/scripts/search.js --x-api "AI 视频编辑"
node {baseDir}/scripts/search.js --x-api --max 50 "热门话题"  # 获取更多结果

按时间筛选

node {baseDir}/scripts/search.js --days 7 "突发新闻"
node {baseDir}/scripts/search.js --days 1 "今日趋势"
node {baseDir}/scripts/search.js --x-api --days 7 "新闻"  # X API 最多支持 7 天

按用户账号筛选

node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI 公告"
node {baseDir}/scripts/search.js --exclude @bots "真实讨论"

输出选项

node {baseDir}/scripts/search.js --json "话题"        # 完整的 JSON 响应
node {baseDir}/scripts/search.js --compact "话题"     # 仅推文内容，无冗余信息
node {baseDir}/scripts/search.js --links-only "话题"  # 仅 X 链接

聊天示例

用户： “搜索 X 上关于 Claude Code 的讨论”
操作： 执行搜索，查询词为 “Claude Code”

用户： “查找 @remotion_dev 过去一周的推文”
操作： 执行搜索，参数为 --handles @remotion_dev --days 7

用户： “今天 Twitter 上关于 AI 的趋势是什么？”
操作： 执行搜索，参数为 --days 1 "AI trending"

用户： “搜索 X 上过去 30 天关于 Remotion 最佳实践的内容”
操作： 执行搜索，参数为 --days 30 "Remotion best practices"

工作原理

xAI Grok 模式（默认）

使用 xAI 的 Responses API (/v1/responses) 和 x_search 工具：
- 模型：grok-4-1-fast（为代理搜索优化）
- 最多支持 30 天历史记录
- AI 驱动的结果格式化，附带引用
- 返回带有 URL 的真实推文

X API 模式 (--x-api)

使用 X 的原生搜索 API (/2/tweets/search/recent)：
- 最多支持 7 天历史记录
- 按使用量付费（无需订阅）
- 原始推文数据，包含指标
- 每次查询最多返回 100 条结果

响应格式

每条结果包含：
- @用户名（显示名称）
- 推文内容
- 日期/时间
- 互动指标（X API 模式）
- 推文直接链接

环境变量

xAI 模式：
- XAI_API_KEY - 您的 xAI API 密钥（默认模式必需）
- SEARCH_X_MODEL - 模型覆盖（默认：grok-4-1-fast）
- SEARCH_X_DAYS - 默认搜索天数（默认：30）

X API 模式：
- X_BEARER_TOKEN - 您的 X API Bearer Token
- TWITTER_BEARER_TOKEN - 备选环境变量名

安全与权限

此技能的功能：
- 调用 xAI 的 /v1/responses 端点（Grok 模式）或 X 的 /2/tweets/search/recent 端点（X API 模式）
- 返回带有 URL 和引用的公开推文数据
- 所有请求仅发送至 api.x.ai 或 api.x.com

此技能不会：
- 不会发布、点赞、转推或修改任何 X/Twitter 内容
- 不会访问您的 X/Twitter 账户或私信
- 不会读取配置文件或访问本地文件系统
- 不会将凭据发送至任何第三方端点
- 无法由代理自主调用 (disable-model-invocation: true)

首次使用前，请查看 scripts/search.js 以验证其行为。