> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X Search

> 通过 Grok 原生的 x_search 工具搜索 X/Twitter 的帖子和内容

# X Search

X Search 让基于 Grok 的智能体在响应过程中搜索 X(原 Twitter)上的帖子和内容。

## 它做什么

此工具使用 xAI 原生的 `x_search` 能力。它可以帮助智能体在 X 上查找最近的帖子、讨论和话题串,而无需连接单独的 MCP 服务器。

## 要求

仅当你的智能体配置为使用 **xAI (Grok)** 模型时,才能使用 X Search。当你的智能体使用其他模型提供商时,请视情况使用 [GPT Search](./gpt-search)、[Google Search](./google-search) 或 [xAI Web Search](./xai-search)。

## 将工具添加到智能体

1. 在编辑器中打开一个智能体。
2. 确保该智能体的模型设置为某个 xAI Grok 模型。
3. 点击工具提示为 **Add MCP Tool or Sub Agent** 的按钮。
4. 在 **MCP Tools** 中,点击 **X Search**。

## 配置

X Search 的设置在 MCP 工具的设置面板中进行配置:

| 参数                           | 说明                                  |
| ---------------------------- | ----------------------------------- |
| `allowed_x_handles`          | 仅考虑来自特定 X handle 的帖子(最多 20 个)。默认为空。 |
| `excluded_x_handles`         | 排除来自特定 X handle 的帖子(最多 20 个)。默认为空。  |
| `included_domains`           | 倾向于或将链接内容限制在特定域名(最多 20 个)。默认为空。     |
| `excluded_domains`           | 排除来自特定域名的链接内容(最多 20 个)。默认为空。        |
| `from_date`                  | 搜索范围的起始日期(`YYYY-MM-DD`)。默认为空。       |
| `to_date`                    | 搜索范围的结束日期(`YYYY-MM-DD`)。默认为空。       |
| `enable_image_understanding` | 启用对帖子中图像的分析。默认禁用。                   |
| `enable_video_understanding` | 启用对帖子中视频的分析。默认禁用。                   |

备注:

* `Allowed X Handles` 和 `Excluded X Handles` 互斥。
* 日期必须是有效的 ISO 日期字符串(`YYYY-MM-DD`)。

## 使用场景

* 监控人们在 X 上对某个公司、产品、主题或事件的讨论。
* 在回答时效性问题之前查找最近的帖子和话题串。
* 从 X 内容中收集社交语境和公众反应。

## 计费

X Search 按 **每次完成的请求/工具调用 \$0.005** 计费。

## 备注

* X Search 搜索的是 X/Twitter 帖子和内容。要获取 Grok 的公开网页结果,请使用 [xAI Web Search](./xai-search)。
* 此工具由 xAI 原生的 `x_search` 能力驱动,而不是外部 MCP 服务器。
* 在编辑器中使用 **Chat**,可在测试运行期间查看智能体何时调用 **X Search**。请参阅[使用聊天测试](../testing-with-chat)。