如何使用 X MCP —— 让 AI Agent 自动发帖、获取 X 庞大信息（保姆级教程）

🚀 如何使用 X MCP

让 AI Agent 自动发帖、获取 X（Twitter）庞大信息

2026年6月 · 技术学习 · 完整保姆级教程

核心价值：AI Agent 从此拥有了 X 的实时社交数据 —— 市场情绪、热点话题、KOL 动态、官方公告，都能直接喂给 Agent 做分析决策。而写操作（发帖、书签）让你可以全自动化内容运营。

⚠️ 关键区别：默认创建 App 后拿到的是 OAuth 1.0a 凭证（Consumer Key / Secret Key + Bearer Token），但这些 只能读不能写。要做写操作（发帖、管理书签），必须额外启用 OAuth 2.0 并获取 Client ID / Client Secret。

App type: 选 Confidential client（推荐）或 Public client

Callback URI / Redirect URL: http://localhost:8080/callback（精确填入，这是 xurl 桥接器的默认回调地址）

Website URL: 你的网站地址（如 https://opcgrow.org）

OAuth 2.0 Client ID: QXMwVzc3...6MTpjaQ

OAuth 2.0 Client Secret: YVjt-u31...9FPAh

📋 保存好这两个值，接下来的配置需要用到。注意它们和 OAuth 1.0a 的 Consumer Key/Secret 是两套不同的凭证。

推荐：Pay-Per-Use（按量付费）

$0.50 起充 · 读操作约 $0.005/次 · 写操作稍贵 · 无月费

💡 提示：BitMart Visa 卡余额与平台账户互通，从现货账户直接划转 USDT 到卡内即可消费，无额外货币兑换费。X 的计费是美元，BitMart 卡会自动按汇率扣 USDT。

# ~/.hermes/config.yaml
mcp_servers:
  xapi:
    url: "https://api.x.com/mcp"
    headers:
      Authorization: "Bearer YOUR_BEARER_TOKEN"
    timeout: 180
    connect_timeout: 60
  x-docs:
    url: "https://docs.x.com/mcp"
    timeout: 60
    connect_timeout: 30

# ~/.hermes/config.yaml
mcp_servers:
  xapi:
    command: "npx"
    args:
      - "-y"
      - "@xdevplatform/xurl"
      - "mcp"
      - "https://api.x.com/mcp"
    env:
      CLIENT_ID: "你的 OAuth 2.0 Client ID"
      CLIENT_SECRET: "你的 OAuth 2.0 Client Secret"
    connect_timeout: 120
    timeout: 180
  x-docs:
    url: "https://docs.x.com/mcp"
    timeout: 60
    connect_timeout: 30

📌 注意：connect_timeout 设为 120 秒（或更高）—— 第一次启动 xurl 时需要你在浏览器中完成 OAuth 登录，MCP 客户端需要等待这个过程。推荐设为 300 秒。

🔁 授权只需做一次。xurl 会缓存 token 到 ~/.xurl/ 目录，之后自动刷新。只要 refresh token 不过期就不需要重新授权。

#!/usr/bin/env python3
# refresh_xapi_token.py — 每 1 小时自动刷新 X API Token
import json, base64, yaml, urllib.request, urllib.parse

with open('xapi_refresh.json') as f:
    info = json.load(f)

data = urllib.parse.urlencode({
    'grant_type': 'refresh_token',
    'refresh_token': info['refresh_token'],
}).encode()

auth = base64.b64encode(
    f"{info['client_id']}:{info['client_secret']}".encode()
).decode()

req = urllib.request.Request(
    'https://api.x.com/2/oauth2/token',
    data=data,
    headers={
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': f'Basic {auth}',
    },
    method='POST',
)

resp = json.loads(urllib.request.urlopen(req).read())
# 更新 config.yaml 中的 Bearer token
# 保存新的 refresh_token

X MCP 是 2026 年最重大的 Agent 生态事件之一。它让 AI Agent 首次拥有了官方、实时、结构化的社交数据接入，不再需要爬虫或者第三方 API。

配合 Hermes Agent 的 cron 定时任务能力，你可以实现全自动的社交内容运营和分析 pipeline —— 每天定时抓取行业动态 → Agent 分析总结 → 自动发布到 X。