mcpField
X
x-search

x-search

github.com/syjcnss生产力039 次安装35 周前更新
代码仓库

关于 x-search

通过 xAI 的 Grok API 搜索 X 帖子的技能，支持关键词和语义搜索，以及用户和日期筛选，并返回分析与引用。

主要功能

  1. 01关键词和语义搜索
  2. 02按日期范围筛选
  3. 03包含或排除指定用户
  4. 04分析图像和视频
  5. 05使用推理模型

适用场景

  1. 01追踪 X 上某主题的讨论
  2. 02将结果限定在时间段或账号范围内
  3. 03搜索含视觉媒体的帖子
  4. 04深入分析复杂主题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/syjcnss/skills --skill x-search

安装后在 Claude Code 中输入/x-search确认已加载。

附带文件scripts/x_search.sh

详细介绍

X 搜索

使用 xAI 的 Grok API 搜索 X（Twitter）帖子，支持关键词搜索、语义搜索、用户筛选和日期范围。

给 Agent 的说明

调用此技能时：

  1. 使用 Bash 工具，根据用户的请求传入适当的参数来执行脚本
  2. 解析输出，其中包含分析和引用部分
  3. 重要：始终在回复用户时包含引用。脚本输出包含“Citations:”部分，其中列出了带编号的 X 帖子 URL，必须呈现给用户
  4. 设置回复格式，包含：
    • Grok 的分析／发现
    • 包含所有引用帖子 URL 的完整引用列表

脚本会返回带有引用的格式化输出。必须在回复用户时包含这些引用。

快速开始

基本 X 搜索：

scripts/x_search.sh "What are people saying about AI?"

环境设置

必需的环境变量：

  • XAI_API_KEY：你的 xAI API 密钥（必需）
  • XAI_API_HOST：API 主机 URL（可选，默认为 https://api.x.ai）

搜索选项

日期范围筛选

将搜索范围限定在特定时间段：

scripts/x_search.sh "AI developments" --from-date 2025-01-01 --to-date 2025-02-06
用户账号筛选

仅搜索特定用户（最多 10 个）：

scripts/x_search.sh "latest updates" --allowed-handles elonmusk,gdb

排除特定用户（最多 10 个）：

scripts/x_search.sh "tech news" --excluded-handles spamaccount,bot123

注意：不能在同一个请求中同时使用 --allowed-handles 和 --excluded-handles。

媒体理解

启用对帖子中图像的分析：

scripts/x_search.sh "AI art trends" --enable-images

启用对帖子中视频的分析：

scripts/x_search.sh "product demos" --enable-videos
组合选项

所有选项都可以组合使用：

scripts/x_search.sh "climate change discussion" \
  --from-date 2025-01-01 \
  --excluded-handles climateskeptic \
  --enable-images
启用推理模型

使用 --thinking 标志切换到推理模型，以进行更深入的分析：

scripts/x_search.sh "complex topic requiring deep analysis" --thinking

这会使用 grok-4-1-fast-reasoning，而不是默认的 grok-4-1-fast-non-reasoning。

输出格式

脚本会自动解析 JSON 响应并输出：

  1. 文本内容：Grok 格式化后的分析和发现
  2. 引用：带有引用编号的 X 帖子 URL 列表

输出示例：

## Response:

[Analysis text with inline citation markers]

## Citations:
[1] https://x.com/i/status/...
[2] https://x.com/i/status/...

使用说明

  • 默认模型：grok-4-1-fast-non-reasoning，用于快速搜索
  • 使用 --thinking 标志时：使用 grok-4-1-fast-reasoning 进行更深入的推理
  • 脚本使用 curl 查询 xAI Responses API 端点
  • 输出会自动使用 jq 解析，便于阅读
  • 日期格式：ISO8601（YYYY-MM-DD）
  • 账号数量限制：允许／排除列表最多各包含 10 个

评论

支持 Markdown