核心用法
search-x 是一款面向 Claude Code 的双模式 X/Twitter 实时搜索技能，无需浏览器即可获取公开推文内容。
两种搜索模式
| 模式 | 数据源 | 历史范围 | 特点 |
|------|--------|---------|------|
| **xAI Grok（默认）** | xAI Responses API + x_search 工具 | 30 天 | AI 智能格式化、自动引用、适合语义查询 |
| **X API（`--x-api`）** | X 原生搜索 API | 7 天 | 原始数据、互动指标（转推/点赞/回复）、按量计费 |
常用命令
# Grok 模式（需 XAI_API_KEY）
node {baseDir}/scripts/search.js "Claude Code reviews"
node {baseDir}/scripts/search.js --days 7 --handles @elonmusk "AI announcements"
# X API 模式（需 X_BEARER_TOKEN，按量付费）
node {baseDir}/scripts/search.js --x-api --max 50 "trending topic"
node {baseDir}/scripts/search.js --x-api --links-only "news" # 仅输出链接输出格式
每条结果包含：@用户名、推文内容、发布时间、互动数据（X API 模式）、直达链接。
显著优点
- 实时性强：直接调用官方 API，无爬虫延迟
- 双模式灵活：Grok 适合快速摘要，X API 适合数据挖掘
- 精准过滤：支持按账号筛选（
--handles）、排除账号（--exclude）、时间窗口（--days） - 输出可控：JSON/compact/links-only 多格式可选
- 安全设计：
disable-model-invocation: true，禁止 AI 自主调用，需用户显式触发
潜在缺点与局限性
- 历史限制：Grok 最多 30 天，X API 仅 7 天；无完整档案搜索
- 成本因素：X API 按量计费（无订阅门槛，但高频使用可能产生费用）
- 覆盖盲区：仅搜索公开推文，无法访问私密账号、DM 或已删除内容
- 地区合规：X/Twitter 内容受平台政策约束，部分敏感话题可能受限
- 依赖外部服务：xAI 或 X API 的可用性直接影响功能
适合人群
- 开发者/研究员：追踪技术趋势、竞品动态、社区反馈
- 内容创作者：监控话题热度、收集用户观点、寻找灵感
- 市场分析师：实时舆情监测、品牌提及追踪（短周期）
- 新闻工作者：快速核实社交媒体信源、获取一手讨论
常规风险
- API 密钥泄露：
XAI_API_KEY与X_BEARER_TOKEN需妥善保管，避免硬编码 - 内容可信度：社交媒体信息良莠不齐，需交叉验证
- 隐私边界：仅能搜索公开内容，不可用于监控非公开账号
- 费率失控：X API 模式建议设置用量预警，避免意外账单
- 平台政策变更：X API 定价与权限可能调整，需关注官方公告