xai-x-search

用途

xAI X（Twitter）搜索是一款基于 Grok API 的实时 Twitter/X 检索工具，依托 xAI 独有的 Grok 原生 X 集成能力，让开发者以编程方式搜索 X 平台上的帖子、监控账号动态、跟踪趋势话题并分析社交讨论。

主要能力

主题搜索：检索某个话题的近期帖子，并汇总主要讨论与情绪倾向。
股票代码搜索：查找某个股票代码（如 $AAPL、$NVDA）在 X 上的提及，输出近期讨论、看多/看空情绪、关键意见领袖观点和突发新闻提及。
账号监控：获取指定 X 账号（@handle）的最新发帖并总结其近期动态。
趋势话题：列出 X 当前的热门话题及简要描述。
Agent Tools API（进阶）：通过 x_search 工具获得更精细的控制，包括按日期范围过滤、按账号白名单/黑名单过滤（最多 10 个）、分析图片视频等。

使用方式

首先通过环境变量 XAI_API_KEY 配置密钥，并使用 OpenAI 兼容客户端初始化：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

基础搜索示例：

response = client.chat.completions.create(
    model="grok-4-1-fast",
    messages=[{
        "role": "user",
        "content": "Search X for what people are saying about Tesla stock today"
    }]
)
print(response.choices[0].message.content)

进阶用法通过 Agent Tools API 传入 x_search 工具，可指定日期范围（ISO8601）与账号过滤：

response = client.chat.completions.create(
    model="grok-4-1-fast",
    messages=[{
        "role": "user",
        "content": "Search X for posts about Bitcoin from the last 24 hours"
    }],
    tools=[{
        "type": "x_search",
        "x_search": {
            "enabled": True,
            "date_range": {
                "start": "2025-12-04",
                "end": "2025-12-05"
            }
        }
    }]
)

也可通过 allowed_x_handles 限定只搜索指定账号，例如金融分析师账号列表：jimcramer、elonmusk、chaikinadx、unusual_whales。

搜索参数

allowed_x_handles：仅搜索这些账号，最多 10 个。
excluded_x_handles：排除这些账号，最多 10 个。
date_range.start：起始日期（ISO8601）。
date_range.end：结束日期（ISO8601）。
include_media：分析图片/视频。

适用场景

金融新闻监控：检索最近一小时的突发财经新闻，关注影响市场的消息、财报公告、美联储/经济新闻及重要分析师观点，可要求返回 JSON 结构。
财报反应追踪：针对某个股票代码的财报，分析整体情绪、主要担忧、正面亮点、意见领袖反应和讨论量。
竞品/多股情绪对比：对多个股票代码进行情绪对比，给出 -1 到 +1 的情绪评分、关键主题和重要提及。
日常舆情与趋势跟踪：监控特定账号动态、获取热门话题。

代码示例中给出的最佳实践包括：查询要具体明确、请求结构化 JSON 输出便于解析、使用账号过滤器提升信息质量，以及将 X 情绪与其他数据（如行情数据）结合分析。

限制

反讽识别：可能误判带有讽刺意味的帖子。
机器人内容：无法总是过滤机器人发帖。
历史深度：最适合近期数据。
速率限制与费用：每次搜索 $0.005（$5/1000 次）。

错误处理

示例提供 safe_x_search 包装函数，通过 try/except 捕获异常并返回包含 success、data 或 error 的字典，同时可设置 30 秒超时。

技能介绍

用途