推特搜索助手
一个轻量级工具包，使克劳德能够使用自然语言查询搜索推特，并根据用户意图显示结果，支持推文过滤、分页和灵活的输出格式等功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"x-tools": {
"args": [
"YOUR_ABSOLUTE_PATH_TO/main.js"
],
"command": "node",
"env": {
"RAPIDAPI_KEY": "your_rapidapi_key"
}
}
}
}服务介绍
X Tools for Claude MCP
一个轻量级、开源的工具包，使Claude能够高效地使用自然语言搜索Twitter，并根据用户意图显示结果。既适用于原始数据查看，也支持可选分析。
功能
- 自然语言搜索：用简单的英语让Claude搜索Twitter
- Twitter搜索：使用自然语言或高级Twitter语法搜索推文
- 专业格式化：干净、Markdown格式化的推文展示
- 灵活输出：根据需求显示原始推文或添加分析
- 高级过滤：通过关键词、用户、日期、参与度指标等查找推文
- 分页支持：在需要时检索超过默认每搜索20条推文的数量
安装
前提条件
- Node.js v16+
- Claude桌面版
- 访问"The Old Bird API"（Twitter154）端点所需的免费RapidAPI密钥
RapidAPI密钥设置
- 访问RapidAPI上的The Old Bird API
- 如果还没有账户，请注册RapidAPI账号
- 订阅该API（有免费层级可用）
- 订阅后，从您的仪表板复制RapidAPI密钥
设置步骤
-
克隆此仓库：
bash
git clone https://github.com/0xGval/twitter-X-mcp-server
cd twitter-X-mcp-tools -
安装依赖：
bash
npm install -
创建您的配置：
- 将
mcp.json.example复制为mcp.json并放置于您的Claude Desktop目录中 - 编辑
mcp.json以包含您的RapidAPI密钥及正确的文件路径
json
{
"mcpServers": {
"x-tools": {
"command": "node",
"args": ["YOUR_ABSOLUTE_PATH_TO/main.js"],
"env": {
"RAPIDAPI_KEY": "your_rapidapi_key"
}
}
}
} - 将
-
配置Claude桌面版：
- 在Windows上：将您的
mcp.json文件放置于%APPDATA%Claude目录下 - 在macOS上：将您的
mcp.json文件放置于~/Library/Application Support/Claude/目录下 - 将
claude-rules.md和knowledge/TwitterSearchSyntaxGuide.txt复制到您的Claude知识库目录 - 重启Claude桌面版以使更改生效
- 在Windows上：将您的
可用工具
Twitter搜索
该工具主要设计用于自然语言。只需告诉Claude您想在Twitter上搜索什么，它就会解释您的请求。
searchTwitter(query: "keyword", section: "latest", limit: 20)
使用自然语言或高级语法搜索Twitter：
query：搜索查询（支持Twitter的高级搜索操作符）section："latest"或"top"结果（默认："latest"）limit：要返回的推文数量（默认：20）
自然语言示例
简单查询
询问Claude：
Show me recent tweets about artificial intelligence
用户聚焦查询
询问Claude：
Find the latest tweets from Elon Musk that mention SpaceX
复杂自然查询
询问Claude：
Search for tweets about climate change with at least 100 likes from the past month
分析请求
询问Claude：
What's the sentiment around the new Bitcoin ETF based on recent tweets?
直接语法示例
对于偏好直接语法的用户：
from:elonmusk spacex since:2023-01-01
"artificial intelligence" filter:images min_faves:100
climate action min_retweets:50 -filter:retweets
必需文件
此工具包括几个重要的文件，必须正确设置：
- main.js：主应用程序文件
- tools/twitter.js：Twitter搜索实现
- claude-rules.md：指示Claude适当显示搜索结果的说明
- knowledge/TwitterSearchSyntaxGuide.txt：Twitter搜索语法参考指南
确保所有这些文件都放置在您的Claude设置中的正确位置。
搜索语法
该工具支持所有标准Twitter搜索操作符，Claude可以从您的自然语言中应用这些操作符：
用户- from:username - 由特定账户发送的推文
to:username- 回复给特定账户的推文@username- 提及该账户的推文
媒体和链接
filter:media- 包含任何媒体的推文filter:images- 包含图片的推文filter:native_video- 包含视频的推文filter:links- 包含链接的推文
日期
since:YYYY-MM-DD- 在此日期之后的推文until:YYYY-MM-DD- 在此日期之前的推文
互动
min_retweets:n- 至少有 n 次转推的推文min_faves:n- 至少有 n 个赞的推文min_replies:n- 至少有 n 条回复的推文
故障排除
常见问题：
- 找不到 API 密钥：确保您的 RapidAPI 密钥已在
mcp.json中正确设置 - 路径错误：请确保在 Windows 系统中使用完整的绝对路径，并正确转义（
\） - 无结果：检查您的搜索查询是否有效且不过于严格
- Claude 行为问题：确保您拥有最新版本的
claude-rules.md，其中包含灵活输出指令 - 缺少文件：验证
claude-rules.md和TwitterSearchSyntaxGuide.txt是否已正确添加到您的 Claude 规则和知识库中
开发
要修改工具：
- 编辑
tools/目录中的文件 - 如有必要，请更新
formatTwitterResults()函数中的格式 - 重启 Claude for Desktop 以查看更改
许可证
本项目采用 MIT 许可证。
致谢
- Anthropic 的 Model Context Protocol (MCP)
- RapidAPI Twitter154 API
- Axios
- Zod
注意：此工具旨在与 Claude AI 助手配合使用，并根据用户意图提供具有灵活显示选项的 Twitter 搜索结果。
