twitterapi

twitterapi.io MCP 服务

面向 twitterapi.io 的官方 Model Context Protocol 服务——为 AI Agent 和应用提供 Twitter / X 数据 API。

将 Claude Desktop、Cursor、VS Code Copilot 或任意 MCP 客户端连接到 twitterapi.io，即可通过自然语言搜索推文、获取用户资料、查看关注者、回复、趋势等信息。

功能

12 个只读工具，逐一映射到 twitterapi.io 已验证的生产环境端点：

工具	功能
search_tweets	使用 Twitter 运算符（from:、since:、lang:、has:、…）进行高级搜索
get_user_info	按用户名获取用户资料基本信息
get_user_about	获取扩展资料／关于页面
get_user_followers	获取包含完整资料元数据的关注者（分页）
get_user_followings	获取包含资料元数据的关注列表（分页）
get_user_last_tweets	获取用户近期推文（时间线）
get_user_mentions	获取提及某用户的推文
get_tweets_by_ids	按 ID 批量获取推文（最多 100 条）
get_tweet_replies	获取推文的回复
get_tweet_quotes	获取引用该推文的推文
get_tweet_retweeters	获取转发该推文的用户
get_trends	按位置（WOEID）获取热门话题

快速开始

1. 获取 API 密钥

在 twitterapi.io 注册——提供免费套餐。

2. 配置 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

重启 Claude Desktop。12 个工具将在任意聊天中可用——Claude 会根据你的提示词选择合适的工具。

Cursor

打开 Settings → MCP → Add new MCP Server：

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code（使用 MCP 的 Copilot Chat）

将其添加到 MCP 服务配置中——格式与 Claude Desktop / Cursor 相同。

Claude Code

claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here

3. 开始使用

在任意启用了 MCP 的聊天中：

“查找 @elonmusk 过去一周关于 AI 的近期推文”

“获取 @sama 的关注者列表，并按关注者数量列出前 20 名”

“日本当前有哪些热门话题？”

Claude（或你的客户端）会自动选择 search_tweets / get_user_followers / get_trends，并使用正确的参数调用它们。

身份验证

通过 MCP 客户端注入的 TWITTERAPI_IO_API_KEY 环境变量进行身份验证。服务绝不会存储或记录该密钥。每次工具调用都会在 X-API-Key 标头中向 https://api.twitterapi.io 发送密钥。

分页

返回列表的工具（关注者、回复、搜索结果等）会返回 next_cursor 字段。在下一次调用时将其作为 cursor 参数传回，即可继续翻页。每页通常约有 20 项。

错误处理

• 429 / 5xx 响应会自动通过指数退避重试（尝试 3 次，间隔为 1s/2s/4s）
• 网络超时：每个请求 30s
• 4xx 错误（429 除外）会连同原始消息立即传递给大模型

工具 — 完整规范

每个工具的输入架构都通过 MCP 的 tools/list 暴露，并遵循 JSON Schema。运行 npx @twitterapi_io/mcp-server 和 mcp-inspector 即可交互式浏览：

npx @modelcontextprotocol/inspector npx -y @twitterapi_io/mcp-server

未包含的内容

根据设计，此服务仅公开只读端点。为确保服务可安全地供自主 Agent 使用，以下功能有意排除：

• ❌ 发布推文、点赞、转推、关注、私信
• ❌ 账号登录 / 双重身份验证
• ❌ 编辑个人资料 / 横幅 / 头像
• ❌ 上传媒体
• ❌ 删除账号
• ❌ 设置实时流 / Webhook（不符合 MCP 请求/响应模型）

这些功能可通过完整的 twitterapi.io REST API 使用——如果需要写入权限，请直接使用该 API。

规范兼容性

• 基于 @modelcontextprotocol/sdk v1 构建
• 支持 MCP 规范 2025-11-25（最新版本）
• 传输方式：stdio（计划在 v0.2+ 中支持 Streamable HTTP，以供远程 / 托管使用）
• 已通过以下工具测试：mcp-inspector、Claude Desktop、Cursor、Claude Code

开发

git clone https://github.com/kaitoInfra/twitterapi-io-mcp-server.git
cd twitterapi-io-mcp-server
npm install
npm run build
TWITTERAPI_IO_API_KEY=xxx npm run inspect  # opens mcp-inspector

链接

• 🔗 twitterapi.io — REST API 主页 + 注册
• 📖 twitterapi.io 文档 — 完整 API 参考
• 🧰 Model Context Protocol — 协议主页
• 🐛 报告问题

许可证

MIT © twitterapi.io