内容
# GetXAPI MCP — 推特/X API 用于 Claude, Cursor 及任何 MCP 客户端
[](https://www.npmjs.com/package/@getxapi/mcp)
[](./LICENSE)
官方 **[GetXAPI](https://www.getxapi.com)** MCP 服务器。为您的 AI 助手提供直接访问推特/X API 的能力 — **搜索推文、查找用户、阅读回复和关注者、发布推文、发送私信、管理文章等** — 通过一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器。
与只读推特 MCP 服务器不同，GetXAPI MCP 可以 **执行操作**：发布推文、回复、点赞、转发、发送私信、发布文章 — 而不仅仅是读取。
→ **[在 getxapi.com 获取免费 API 密钥](https://www.getxapi.com)** · **[API 文档](https://docs.getxapi.com)** · **[定价](https://www.getxapi.com/pricing)** （每调用 0.001 美元，每 1,000 条推文 0.05 美元）
---
## 安装
将其添加到您的 MCP 客户端配置（Claude Desktop, Cursor, Windsurf 等）：
```json
{
"mcpServers": {
"getxapi": {
"command": "npx",
"args": ["-y", "@getxapi/mcp@latest"],
"env": {
"GETXAPI_KEY": "get-x-api-..."
}
}
}
}
```
从您的 [GetXAPI 控制台](https://www.getxapi.com) 获取您的 `GETXAPI_KEY`。这就是所有 **读取** 工具所需的。
或通过 Claude Code CLI：
```bash
claude mcp add getxapi -- npx -y @getxapi/mcp@latest
```
---
## 您能做什么
安装完成后，只需自然地询问您的助手：
> “查找 Elon Musk 的最新推文”
> “搜索过去一周关于 OpenAI 的推文”
> “谁是 @vercel 的已验证关注者？”
> “获取这条推文的回复：1799…”
> “在我的 X 账户上发布 'shipping 🚀'” *（需要 X 身份验证 — 见下文）*
---
## 读取 vs. 编写工具
| | 需要 | 示例 |
|---|---|---|
| **读取** | 仅 `GETXAPI_KEY` | 搜索推文、用户信息、关注者/关注中、回复、提及、用户推文、列表 |
| **写入 / 私有** | `GETXAPI_KEY` **+ X 账户身份验证** | 发布 / 回复 / 点赞 / 转发 / 书签 / 删除推文、发送私信、读取私信/时间线/书签、发布文章、更新个人资料 |
### 启用写入工具
写入和私有工具会对真实的 X 账户执行操作，因此需要该账户的身份验证。有两种提供身份验证的方法：
**选项 A — 通过助手登录** （方便）：
> “登录到我的 X 账户”
助手使用您的凭证调用 `x_login` 工具，并为写入工具保存会话。
⚠️ 您的 X 密码作为工具参数传递，因此它会经过 AI 模型的上下文。对于敏感账户，请优先选择选项 B。
**选项 B — 在配置中设置凭证** （推荐用于敏感账户）：
```json
{
"mcpServers": {
"getxapi": {
"command": "npx",
"args": ["-y", "@getxapi/mcp@latest"],
"env": {
"GETXAPI_KEY": "get-x-api-...",
"X_AUTH_TOKEN": "...",
"X_CT0": "...",
"X_TWID": "...",
"X_PROXY": "http://user:pass@host:port"
}
}
}
}
```
`X_CT0`、`X_TWID` 和 `X_PROXY` 是可选的 — 仅 `X_AUTH_TOKEN` 就足以应对大多数写入工具；其他选项可以提高某些账户的可靠性。
您的 X 密码永远不会接触到模型。凭证字段永远不会显示给 AI — 服务器仅将它们注入到需要它们的调用中。
---
## 计费方式
每次工具调用都是使用您的 `GETXAPI_KEY` 验证的正常 GetXAPI API 调用，与直接 API 使用一样计费。没有单独的 MCP 计费。
参见 [定价](https://www.getxapi.com/pricing)。
---
## 链接
- 🌐 **网站：** [getxapi.com](https://www.getxapi.com)
- 📚 **API 文档：** [docs.getxapi.com](https://docs.getxapi.com)
- 💳 **定价：** [getxapi.com/pricing](https://www.getxapi.com/pricing)
- 🔑 **获取 API 密钥：** [getxapi.com](https://www.getxapi.com)
GetXAPI 是开发者和研究人员的独立第三方 API。不隶属于 X Corp.，不获得 X Corp. 的认可或赞助。
## 许可证
MIT
