用途:grok_search 用于实时或时事查询,通过 xAI Grok Live Search 检索 X、网页与新闻,返回一段答案以及引用来源,适合需要新鲜来源和引用的场景,例如社交情绪或“X 上大家在说什么”的市场与实体查询。
主要能力:支持指定 query,并可用 sources 限定搜索渠道,取值为 web、x、news;maxResults 控制来源数量,范围为 1–50,默认 20,数值越高来源与成本越高。返回结构包含 content、citations、sourcesUsed、model。
使用方式:需在环境变量中提供 XAI_API_KEY 或 GROK_API_KEY。可作为工具调用或通过 HTTP 调用。HTTP 示例:curl -sS -X POST http://127.0.0.1:7777/api/tools/execute -H 'Content-Type: application/json' -d '{"name":"grok_search","params":{"query":"what changed in CPI print today","sources":["news"],"maxResults":10}}'。工具调用示例参数为 query、sources、maxResults。
成本与限制:该工具为付费,成本主要随 maxResults 增长,约 $0.025/source。免费来源足够时建议先用 gdelt_news 获取背景标题;不需要引用且希望零成本时不建议使用。底层 Grok 客户端虽支持日期范围、域名允许/禁止、X 句柄允许/禁止、互动阈值等更丰富过滤,但当前 grok_search 仅暴露 query、sources、maxResults,若需这些过滤需扩展 src/tools/grok-search.ts。