基本能力
产品定位
twitter-X-mcp-server 是一个专为 Claude AI 设计的 Twitter 搜索工具,旨在通过自然语言和高级搜索语法提供高效的 Twitter 数据检索和分析功能。
核心功能
- 自然语言搜索:支持使用自然语言搜索 Twitter。
- Twitter 搜索:支持使用自然语言或高级 Twitter 语法搜索推文。
- 专业格式化:提供干净、Markdown 格式的推文显示。
- 灵活输出:支持显示原始推文或根据用户需求添加分析。
- 高级过滤:支持按关键词、用户、日期、互动指标等过滤推文。
- 分页支持:支持检索超过默认 20 条推文的搜索结果。
适用场景
- 需要从 Twitter 获取信息的用户。
- 需要分析 Twitter 数据的开发者或研究人员。
- 需要快速检索特定推文的用户。
工具列表
- Twitter Search:支持自然语言或高级语法搜索 Twitter。
- 能力:搜索推文、过滤结果、分页检索。
常见问题解答
- API Key Not Found:确保 RapidAPI 密钥正确设置在
mcp.json
中。 - Path Errors:确保使用完整的绝对路径(Windows 中使用
\\
)。 - No Results:检查搜索查询是否有效且不过于严格。
- Claude Behavior Issues:确保使用最新版本的
claude-rules.md
。 - Missing Files:确保
claude-rules.md
和TwitterSearchSyntaxGuide.txt
正确添加到 Claude 规则和知识库中。
使用教程
使用依赖
- Node.js v16+
- Claude for Desktop
- Free RapidAPI key with access to the "The Old Bird API" (Twitter154) endpoint
安装教程
-
克隆仓库:
bash
git clone https://github.com/0xGval/twitter-X-mcp-server
cd twitter-X-mcp-tools -
安装依赖:
bash
npm install -
创建配置:
- 复制
mcp.json.example
到mcp.json
。 -
编辑
mcp.json
包含 RapidAPI 密钥和正确的文件路径。 -
配置 Claude for Desktop:
- Windows:将
mcp.json
放在%APPDATA%\Claude\
。 - macOS:将
mcp.json
放在~/Library/Application Support/Claude/
。 - 复制
claude-rules.md
和knowledge/TwitterSearchSyntaxGuide.txt
到 Claude 知识库目录。 - 重启 Claude Desktop。
调试方式
- 确保 RapidAPI 密钥正确设置。
- 检查文件路径是否正确。
- 确保所有必需文件已正确添加到 Claude 规则和知识库中。