🚀 X 工具适用于 Claude MCP
X 工具是一个轻量级、开源的工具包，专为 Claude 设计。它能让 Claude 高效地运用自然语言搜索 Twitter，并依据用户意图展示搜索结果。此外，该工具还支持查看原始数据和进行可选分析。
🚀 快速开始
X 工具能帮助 Claude 实现自然语言搜索 Twitter 的功能，你可以按照以下步骤完成安装设置，然后开始使用。
✨ 主要特性
- 自然语言搜索：可使用日常语言让 Claude 搜索 Twitter。
- Twitter 搜索：既可以通过自然语言，也能利用高级 Twitter 语法搜索推文。
- 专业格式：以干净的 Markdown 格式显示推文。
- 灵活输出：既能显示原始推文，也能根据需求添加分析内容。
- 高级筛选：能按关键词、用户、日期、互动指标等条件查找推文。
- 分页支持：可获取超过默认 20 条推文的搜索结果。
📦 安装指南
先决条件
- Node.js v16+
- Claude for Desktop
- RapidAPI 的免费密钥，且该密钥需具有访问“Twitter154 API”的权限
设置步骤
- 编辑 mcp.json 文件：
{
"api_key": "your_rapidapi_key",
"tools": {
"x_tools": "path/to/xTools.js"
}
}
- 安装依赖项：
npm install axios zod
- 重启 Claude Desktop 完成设置
💻 使用示例
基础用法
在 formatTwitterResults() 函数中，可根据需求调整输出格式。例如：
function formatTwitterResults(results) {
return results.map(tweet =>
`标题：${tweet.title}\n链接：${tweet.url}\n内容：${tweet.content}`
).join('\n\n');
}
📚 详细文档
搜索语法
支持以下高级筛选条件：
- 用户名：
from:username— 来自特定用户的推文to:username— 发送给特定用户的推文
- 媒体类型：
filter:links— 包含链接的推文filter:images— 包含图片的推文
- 日期范围：
since:YYYY-MM-DD— 推文发布时间早于该日期until:YYYY-MM-DD— 推文发布时间晚于该日期
常见问题解决
- API 密钥错误：确认 mcp.json 中的密钥是否正确配置。
- 路径问题：使用正确的绝对路径，并在 Windows 系统中使用反斜杠（如
C:\\path）。 - 无搜索结果：检查查询条件是否有效且不过于严格。
开发指南
- 修改工具文件夹中的代码。
- 更新
formatTwitterResults()函数的输出格式。 - 重启 Claude Desktop 以应用更改。
📄 许可证
本项目在 MIT 许可证下开源。
致谢
感谢以下项目的贡献：
- Model Context Protocol (MCP) by Anthropic
- RapidAPI Twitter154 API
- Axios
- Zod