x-api-mcp-server

X (Twitter) API v2 を使った MCP サーバー。トレンド検索・キーワード検索・アカウント投稿取得・投稿作成に対応。

ツール一覧

| ツール名 | 機能 | 読み取り専用 | |---|---|---| | x_get_trends | 地域別トレンド検索 | ✅ | | x_search_recent | キーワード検索（直近7日間） | ✅ | | x_get_user_tweets | 特定アカウントの投稿取得 | ✅ | | x_create_post | ポスト投稿（dry-run対応） | ❌ |

セットアップ

Claude Desktop

claude_desktop_config.json に以下を追加：

{
  "mcpServers": {
    "x-api": {
      "command": "npx",
      "args": ["-y", "x-api-mcp-server"],
      "env": {
        "X_API_BEARER_TOKEN": "your-bearer-token",
        "X_API_KEY": "your-api-key",
        "X_API_KEY_SECRET": "your-api-key-secret",
        "X_API_ACCESS_TOKEN": "your-access-token",
        "X_API_ACCESS_TOKEN_SECRET": "your-access-token-secret"
      }
    }
  }
}

設定ファイルの場所：

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add x-api -- npx -y x-api-mcp-server

# 環境変数は .env ファイルまたはシェルで設定
export X_API_BEARER_TOKEN="your-bearer-token"
export X_API_KEY="your-api-key"
export X_API_KEY_SECRET="your-api-key-secret"
export X_API_ACCESS_TOKEN="your-access-token"
export X_API_ACCESS_TOKEN_SECRET="your-access-token-secret"

環境変数

| 変数名 | 用途 | 必須 | |---|---|---| | X_API_BEARER_TOKEN | Bearer Token（読み取り系API） | ✅ 読み取り時 | | X_API_KEY | OAuth 1.0a Consumer Key | ✅ 投稿時 | | X_API_KEY_SECRET | OAuth 1.0a Consumer Secret | ✅ 投稿時 | | X_API_ACCESS_TOKEN | OAuth 1.0a Access Token | ✅ 投稿時 | | X_API_ACCESS_TOKEN_SECRET | OAuth 1.0a Access Token Secret | ✅ 投稿時 |

APIキーは console.x.com で取得してください。

使い方の例

Claude で以下のように話しかけてください：

• 「日本のXトレンドを見せて」
• 「Xで "内視鏡AI" を検索して」
• 「@elonmusk の最新投稿を10件見せて」
• 「"新しいブログ記事を公開しました！" とXに投稿して」

API コスト目安（Pay-Per-Use）

| 操作 | 単価 | $5で可能な回数 | |---|---|---| | 読み取り (GET) | $0.005/件 | 1,000回 | | 投稿 (POST) | $0.01/件 | 500回 |

注意事項

• x_create_post はデフォルトで dry_run=true（プレビューのみ）です
• トレンドAPI（v2）が利用できない場合、自動的にv1.1にフォールバックします
• Pay-Per-Useプランでは月間200万ポスト読み取りの上限があります

License

MIT