MCP 服务器

通过 Model Context Protocol 把 Claude、ChatGPT、Cursor 等 AI Agent 连接到 TwexAPI。用 TwexAPI 账号登录，或使用 API 密钥。

TwexAPI 在 https://api.twexapi.io/mcp 提供 Model Context Protocol 服务器。AI 助手和编程 Agent 可以用它搜索推文，读取用户资料、粉丝、回复、帖子串、社区、列表和趋势。每次调用都消耗你的 TwexAPI 额度，和 REST 请求一样。

本页介绍 API MCP 服务器。如果想让 Agent 检索 TwexAPI 文档，请使用 Docs MCP 服务器（https://docs.twexapi.io/mcp），无需登录。

快速开始

添加服务器

在 MCP 客户端中添加一个远程服务器，地址填 https://api.twexapi.io/mcp（Streamable HTTP）。如果要用登录方式，API 密钥和请求头字段都留空。

客户端会在浏览器中打开 twexapi.io。用你的 TwexAPI 账号（邮箱或 Google）登录，确认授权后要返回的地址，选择是否授予写入权限，然后点击 Approve。

开始提问

新建对话并提问，例如：“用 TwexAPI 找出美国当前的热门话题，并总结热门推文。”

各客户端的具体步骤：

Claude.ai 与 Claude Desktop

把 TwexAPI 添加为自定义连接器。

ChatGPT

在网页版或桌面应用中通过开发者模式连接。

编程 Agent 与编辑器

Claude Code、Codex、Cursor、VS Code、OpenCode 和 Windsurf。

开发自己的客户端

OAuth 2.1 端点、PKCE、权限范围和 token 有效期。

认证方式

服务器接受两种凭证：

方式	适用场景	用法
用 TwexAPI 登录（OAuth 2.1），推荐	支持 MCP 授权的客户端：Claude.ai、Claude Desktop、Claude Code、ChatGPT、Cursor、Codex、VS Code、OpenCode	只填服务器地址，客户端会自动完成登录。
API 密钥	不支持 MCP 登录的客户端、脚本和 Agent 框架	发送 `x-api-key: YOUR_API_KEY` 或 `Authorization: Bearer YOUR_API_KEY`。

在 TwexAPI 控制台创建或复制 API 密钥。ChatGPT 无法发送自定义请求头，所以只能用登录方式。

登录后会授予哪些权限

应用拿到的 token 只能用于 https://api.twexapi.io/mcp。它看不到你的密码和 API 密钥，不能修改你的账号，也读不到控制台里的数据。
调用会从你账号的额度中扣费，和用 API 密钥调用完全一样。
读取权限始终授予。写入权限（通过 twexapi_write 发推和回复）在授权页上是一个勾选框，取消勾选即为只读连接。
访问 token 有效期为一小时，客户端会自动续期。连续 30 天没有被任何应用使用的授权会自动失效。
每连接一次客户端，控制台的 Authorized apps（已授权应用）里就会多一条记录。点击 Revoke 可以立即切断该应用的访问。在客户端里删除连接器并不会撤销我们这边的授权。

点击授权之前

你的账号需要有一个可用的 API 密钥，并且还有额度。没有额度时，授权页会先提示你充值。授权请求在 10 分钟内有效，充值后可以回来再点一次 Approve。
留意 After you approve, you will return to（授权后将返回）这一行。它应该是你正在使用的应用，例如 claude.ai、chatgpt.com，桌面应用则是 127.0.0.1 开头的地址。

服务发现

MCP 客户端可以从服务器本身获取所需的全部信息：

URL	用途
`https://api.twexapi.io/.well-known/oauth-protected-resource/mcp`	受保护资源元数据：告诉客户端授权服务器在哪里。
`https://api.twexapi.io/.well-known/oauth-authorization-server`	授权服务器元数据：登录、换取 token、注册和撤销端点。
`https://api.twexapi.io/.well-known/mcp.json`	供注册表读取的 MCP 服务器卡片，`/.well-known/mcp/server-card.json` 返回同样的内容。

不带凭证的请求会返回 401，并带有 WWW-Authenticate: Bearer 质询，其中给出受保护资源元数据的地址。客户端正是靠这个质询知道需要发起登录。完整流程见 MCP 客户端 OAuth。

工具

工具	作用	何时可用
`explore`	搜索接口目录，返回请求方法、路径、参数、示例，以及应该用哪个工具调用。不消耗额度。	始终可用
`twexapi_request`	调用只读接口，例如搜索、用户资料、粉丝、回复、社区、列表和趋势。	始终可用
`twexapi_write`	调用写入接口。目前是发推或回复，需要提供你的 X 账号 Cookie。	授予写入权限时

Claude 等客户端在每次调用 twexapi_write 之前都会请你确认。点赞、关注、私信等其他写操作只能通过 REST API 完成。输入、输出和完整目录见 MCP 工具参考。

额度与错误

情况	你会看到
没有凭证	`401`，并带登录质询。支持登录的客户端会自动发起登录。
API 密钥无效，或登录已过期、已被撤销	`401`，带 `error="invalid_token"`。重新登录，或检查密钥。
API 密钥已在控制台中停用	`403`，提示 “This TwexAPI API key is disabled.”。
额度已用完	连接仍然正常，`explore` 免费可用。其他工具调用会返回 “No credits left on this TwexAPI account. Top up at https://twexapi.io/dashboard and try again.”。
只读授权	`twexapi_write` 不会出现。需要发推时请重新连接，并保持写入权限勾选。

反馈连接问题时，请附上响应头 X-Request-Id 和发生时间（UTC）。

无需账号的按次付费

使用 Machine Payments Protocol 付费、而不是用 API 密钥的 MCP 客户端，请连接 https://api.twexapi.io/mcp/pay。该端点接受匿名请求，对可付费的工具调用返回付款质询。主端点 /mcp 始终要求登录或 API 密钥。

Claude.ai 与 Claude Desktop

Claude.ai 和 Claude Desktop 共用同一套连接器，所以 TwexAPI 只需要添加一次。

添加自定义连接器

打开 Settings → Connectors，选择 Add custom connector。名称填 TwexAPI，URL 填 https://api.twexapi.io/mcp。OAuth 的 client ID 和 secret 留空，然后点击 Add。

连接

点击 Connect，在打开的 TwexAPI 页面登录，然后点击 Approve。

在对话中使用

在对话中打开 + 菜单，在连接器里启用 TwexAPI，然后提问。

在 Team 和 Enterprise 套餐中，可能需要所有者先允许自定义连接器。

Agent 框架

Agent 运行时和脚本通常使用 API 密钥。以 OpenAI Agents SDK 为例：

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

请从环境变量或密钥管理服务中读取密钥，不要写死在代码里。

搜索过去 24 小时关于 AI agents 的 X 帖子，返回前 20 条推文，包含推文 ID、作者、发布时间、点赞数、转发数和一句话摘要。
查找 @elonmusk 最近提到 Grok 或 AI 的推文，按主题分组，并附上 X 原文链接。
读取这条推文：https://x.com/elonmusk/status/2104354931595423762。总结内容，再拉取最相关的回复并列出回复 ID。
获取推文 ID 2104354931595423762 的相似推文，并说明每条结果为什么相关。

用户资料与关注关系

读取 @openai 的个人简介，返回用户名、显示名称、用户 ID、所在地、粉丝数和主页链接。
搜索与 AI infrastructure 相关的 X 用户，返回 25 个账号，包含用户名、简介、粉丝数以及匹配原因。
获取 @elonmusk 的最新粉丝，找出简介中提到 AI、创业或加密货币的账号。
拉取 @sama 的一页游标分页粉丝，返回前 20 个用户，并保留 next_cursor 供下次使用。

趋势

列出所有支持的全球趋势国家，然后获取 united-states 的热门话题。
获取 united-states 中话题为 technology、内容标签为 AI 的热门推文，返回推文 ID、作者和互动数据。
对比 united-states、japan 和 united-kingdom 的热门话题，总结各地区的差异。

回复、引用与帖子串

拉取 https://x.com/elonmusk/status/2104354931595423762 的回复，按相关度排序，返回回复 ID、作者、正文和点赞数。
列出转发了推文 ID 2104354931595423762 的 50 个用户，返回用户 ID、用户名、显示名称，以及可获取到的粉丝数。
获取推文 ID 2104354931595423762 的引用推文，并把引用分为支持、批评和中立三类。
提取推文 ID 2104354931595423762 的完整帖子串，整理成 Markdown 大纲。

文章、社区与列表

以 Markdown 格式获取 X 文章 2104354931595423762，并整理成 5 条要点的简报。
搜索与 AI builders 相关的 X 社区，返回社区 ID、名称、成员数和简介。
搜索与 AI founders 相关的列表，返回前 10 个列表的 ID、名称、简介和成员数。

框架指南

在你常用的框架里用 TwexAPI MCP 工具构建 Agent：

LangChain

把 TwexAPI MCP 工具接入 LangChain 和 LangGraph Agent。

CrewAI

构建共享同一个 TwexAPI MCP 连接的研究团队。

Pydantic AI

用 Streamable HTTP MCP 工具构建类型安全的 Agent。

Google ADK

为基于 Gemini 的 ADK Agent 添加 TwexAPI 工具。

Mastra

把 TypeScript Agent 连接到远程 TwexAPI MCP 工具。

无代码工作流

把 Agent 输出交给 n8n、Zapier、Make 和 Pipedream。

AI Agent 技能

TwexAPI 技能让 AI 编程 Agent 无需 MCP 连接也能深入了解 TwexAPI API。安装后，Agent 可以编写 API 集成、配置 MCP 连接，并遵循 TwexAPI 的最佳实践。

npx skills add twexapi-dev/x-api-scraper-cli

MCP 服务器

快速开始

认证方式

登录后会授予哪些权限

点击授权之前

服务发现

工具

额度与错误

无需账号的按次付费

Claude.ai 与 Claude Desktop

Agent 框架

MCP 与 REST API 的选择

MCP 服务器

REST API

示例提示词

搜索与查询

用户资料与关注关系

趋势

回复、引用与帖子串

文章、社区与列表

框架指南

AI Agent 技能