使用说明
TwitterAPI.io MCP 服务器
一种模型上下文协议（MCP）服务器，通过twitterapi.io API提供对Twitter数据的访问。此服务器允许LLM搜索推文、获取用户信息、分析趋势等。
特性
- 推特搜索：具有过滤选项的高级搜索
- 用户分析：获取用户资料、关注者和以下列表
- 推特分析：访问回复、引用和转发
- 趋势监测：按位置获取热门话题
- 用户发现：按关键字搜索用户
快速开始
📚 阅读完整的入门指南 有关分步设置说明。
选项1：远程设置（NPX）-推荐
{
"mcpServers": {
"twitterapi-io": {
"command": "npx",
"args": ["twitterapi-io-mcp", "--api-key=your_api_key_here"]
}
}
}
选项2：本地设置
git clone https://github.com/alexandrebouchez/twitterapi-io-mcp.git
cd twitterapi-io-mcp
npm install
npm run build
{
"mcpServers": {
"twitterapi-io": {
"command": "node",
"args": ["/path/to/twitterapi-io-mcp/dist/index.js", "--api-key=your_api_key_here"]
}
}
}
📋 先决条件：
- Node.js 18+
- API密钥来自 网站 twitterapi.io
- Claude Desktop或MCP兼容客户端
可用工具
推特操作
search_tweets：使用高级过滤功能搜索推文get_tweet_by_id：获取详细的推特信息get_tweet_replies：获取特定推文的回复get_tweet_quotes：获取报价推文get_tweet_retweets：获取转发推特的用户
用户操作
get_user_info：获取详细的用户资料get_user_tweets：获取用户最近的推文get_user_followers：获取用户的关注者get_user_following：让用户被关注search_users：按关键字搜索用户
趋势操作
get_trends：获取热门话题（可选择按地点）
例子
搜索最近的推文
// Search for tweets about AI
search_tweets({
query: "artificial intelligence",
queryType: "Latest"
})
获取用户信息
// Get profile information for a user
get_user_info({
userName: "elonmusk"
})
获取推特回复
// Get replies to a specific tweet
get_tweet_replies({
tweetId: "1234567890123456789"
})
API成本
TwitterAPI.io使用基于使用量的定价：
- 每千条推文0.15美元
- 0.18美元/千用户配置文件
- 0.15美元/千关注者
- 最低费用：每次请求0.00015美元
发展
设置
git clone https://github.com/alexandrebouchez/twitterapi-io-mcp.git
cd twitterapi-io-mcp
npm install
构建
npm run build
发展模式
npm run dev
测试
# Install MCP Inspector for debugging
npx @modelcontextprotocol/inspector dist/index.js
错误处理
该服务器包括全面的错误处理功能，用于：
- 身份验证失败
- 速率限制
- 网络错误
- 无效参数
- API错误
安全
- API密钥在使用前经过验证
- 所有输入都使用Zod模式进行验证
- 网络超时可防止挂起请求
- 错误消息不会泄露敏感信息
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 彻底测试
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件
支持
- 访问 网站 twitterapi.io API文件
- 在以下方面创建问题 GitHub 用于错误报告
- 请查看MCP文档，网址为 模型上下文协议.io
