Search X

核心用法

Search X 是一款专为 clawdbot 设计的实时 X/Twitter 搜索技能，通过 xAI 的 Grok-4 模型调用 x_search 工具获取真实推文数据。用户可通过自然语言触发搜索，支持多种过滤条件与输出格式。

主要功能

• 实时搜索：调用 Grok-4.20 模型，获取带引用的真实推文
• 时间过滤：--days 参数限定搜索范围（1-30天）
• 用户筛选：--handles 指定特定账号，--exclude 排除账号
• 多格式输出：标准格式、JSON 完整响应、紧凑模式或仅链接

显著优点

1. 真实数据源：直接对接 X 平台 API，返回可点击验证的推文链接
2. Agentic 优化：采用 grok-4-1-fast 模型，专为自动化搜索场景设计
3. 灵活配置：支持环境变量与命令行参数双重配置方式
4. 图片支持：Grok-4.20 可同时返回图片结果

潜在局限

• 依赖单一供应商：完全依赖 xAI API 可用性与定价策略
• 环境密钥要求：必须配置 XAI_API_KEY，增加部署复杂度
• 速率限制未知：文档未披露 API 调用配额与限速策略
• 中文支持未明：未测试非英文内容的搜索质量

适合人群

• 需要追踪社交媒体舆情的内容创作者与分析师
• 开发实时社交监听工具的开发者
• 希望自动化获取 X 平台讨论的技术团队

常规风险

• API 密钥泄露：XAI_API_KEY 以明文存储于配置，需妥善保管
• 数据合规性：X 平台内容爬取需遵守平台条款与地区法规
• 模型幻觉：Grok-4 可能对搜索结果进行摘要改写，存在信息失真风险
• 服务依赖：xAI 服务中断将直接导致技能失效

核心功能

search-x 是一款专为 Clawdbot 设计的 X/Twitter 实时搜索技能，调用 xAI 官方 Grok-4 模型（grok-4-1-fast）实现智能检索。用户可通过自然语言触发搜索，获取带 URL 引用的真实推文，支持按时间窗口（1-30 天）、指定账号（--handles）、排除账号（--exclude）等多维度过滤。

显著优势

• 实时性与权威性：直连 xAI 官方 API，返回结果包含真实推文链接，可追溯验证，避免信息茧房
• 输出灵活：提供标准、精简（--compact）、纯 JSON（--json）、仅链接（--links-only）四种模式，适配不同场景
• 零依赖架构：仅使用 Node.js 内置模块（https/fs/path），无第三方包，彻底消除供应链攻击风险
• 隐私合规：仅读取 XAI_API_KEY 必要环境变量，符合 GDPR/CCPA 最小化原则

局限与注意事项

• API 成本依赖：需用户自备 xAI API key，按调用量计费，高频使用可能产生费用
• 内容边界：依赖 Grok-4 的检索能力，对极新事件（数分钟内）或高度私密内容覆盖有限
• 平台绑定：目前仅支持 X 平台，无法跨平台检索其他社交网络

适用人群

• 产品经理/市场分析师：追踪竞品动态、用户反馈与行业热点
• 内容创作者：挖掘话题灵感、验证传播趋势
• 开发者与研究者：获取技术讨论的一手信源，替代传统 RSS 订阅

风险提醒

• API key 泄露风险：建议通过环境变量配置，避免硬编码或提交至版本控制
• 结果可信度：虽然带引用，但仍需人工核实原始推文，防范机器人账号或虚假信息
• 速率限制：xAI API 存在调用配额，大规模批量搜索需关注用量控制

技术亮点

安全认证评分 95/100（S 级），静态分析 98 分、动态行为 95 分、依赖审计满分。网络层仅访问 api.x.ai，全程 TLS 1.2+ 加密，无隐蔽通信或权限提升行为。