X-Use - X (Twitter) MCP Server

x-use — X（Twitter）向け MCP サーバー

AI クライアントを X の調査、受信トレイの閲覧、レビューを経た公開に接続できます。

x-use は、オープンソースの Python 製 Model Context Protocol（MCP）サーバーおよび CLI です。Claude、Codex、Cursor などのローカル MCP クライアントを接続して、プロフィールの調査、受信トレイの管理、レビューを経た公開を行えます。認証済みのブラウザーセッションを使用し、複数のアカウントをサポートしています。公式 X API の認証情報なしでローカル実行できます。

クイックスタート · ドキュメント · ツールリファレンス · ディスカッション · 貢献

x-use でできること

• 返信前に調査する： X を検索し、プロフィールを確認し、投稿や範囲を限定したスレッドの文脈を読み、関連性の高い返信を準備します。
• 受信トレイを確認する： 閲覧可能な会話、未読メッセージ、リクエスト、通知を確認し、個別のメッセージやサポート対象の会話操作をレビュー用に準備します。
• 文脈を踏まえて公開する： 投稿や複数投稿のスレッドを下書きとして準備し、正確なテキストを確認して、準備ができたら下書きを承認します。
• アウトリーチをローカルで整理する： アカウントごとの上限と配信状況の追跡を設定して、見込み客、配信停止、キャンペーンの下書きを管理します。

推論とテキストの作成は AI クライアントが担います。オプションの OpenAI 互換 LLM 設定を使用すると、サーバー側で生成できます。通常の明示的なテキストを使う MCP ワークフローには、この追加キーは必要ありません。

クイックスタート

Python 3.11 以降と Chromium が必要です。CI マトリックスでは、Windows、macOS、Linux 上の Python 3.11～3.14 を対象としています。

バージョン 3.2.0 では、調査、受信トレイ管理、レビューを経た公開、アカウント操作向けに 82 個のツールを提供します。 パッケージをアップグレードし、MCP クライアントを再起動して、最新のツールを読み込んでください。

1. サーバーとブラウザーをインストールする

python -m pip install --upgrade x-use-mcp
python -m patchright install chromium

2. プライベートなデータディレクトリを選択して初期化する

Windows PowerShell：

$env:X_USE_HOME = "$env:LOCALAPPDATA\x-use"
x-use init
x-use doctor

macOS / Linux：

export X_USE_HOME="$HOME/.local/share/x-use"
x-use init
x-use doctor

ウィザードでアカウントを設定し、ローカルの JSON エクスポートから自分の X セッション Cookie をインポートします。Cookie と受信トレイの PIN は非公開にしてください。以下のクライアント設定でも同じ絶対パスのデータディレクトリを使用してください。シェル環境の設定だけでは、デスクトップクライアントは設定されません。

3. MCP クライアントを接続する

Claude Desktop など、mcpServers オブジェクトを受け付けるクライアントでは、次の stdio 設定を使用します。

{
  "mcpServers": {
    "x-use": {
      "command": "/absolute/path/to/x-use",
      "args": ["mcp"],
      "env": {
        "X_USE_HOME": "/absolute/path/to/x-use-data"
      }
    }
  }
}

両方のパスを置き換えてください。Windows では、インストール済みの x-use.exe のパスを使用し、JSON 内のパス区切りにはスラッシュを使ってください。たとえば、データディレクトリには C:/Users/you/AppData/Local/x-use を指定します。PowerShell では Get-Command x-use、macOS/Linux では command -v x-use を実行すると、実行ファイルの場所を確認できます。

Claude Code、Codex、Cursor、Windsurf にはそれぞれ固有の登録場所またはコマンドがあります。クライアントのセットアップ手順に従って設定し、必要に応じてクライアントを再読み込みしてください。ブラウザーを使った操作を始める前に、list_accounts を呼び出すよう依頼してください。

4. 最初のワークフローを試す

ドラフトモードを有効にして、クライアントに次のように依頼します。

アカウントの健全性を確認し、指定するプロフィールを調査して、最近の公開投稿を要約してください。関連性の高い返信ドラフトを1件作成し、そのIDと正確な本文を表示してください。公開する前に、私の承認を待ってください。

フローは get_account_health → get_profile_context → prepare_reply → reply_to_tweet → get_draft です。返信ツールはデフォルトのポリシーに従ってドラフトを準備し、prepare_reply はコンテキストを提供します。承認を受けた場合にのみ approve_draft を使用してください。

ワークフローの例では、受信トレイのトリアージ、アウトリーチ、スレッドを取り上げています。

git clone https://github.com/ihuzaifashoukat/x-use.git
cd x-use
python scripts/setup_uv.py --dev

npx skills add ihuzaifashoukat/x-use

バージョン 3.2.0 には、82 個のツール、7 個のプロンプト、4 個のリソースパターン、7 個のバンドル済みスキルが含まれています。 3.1.0 では、3.0.0 の 70 個のツールにランタイム診断、キャンペーンのプレビュー、ブックマーク、確認後の投稿編集／削除、エンゲージメントの取り消し、受信箱の操作が追加されました。3.2.0 では、MCP Python SDK v2 系列で同じツールが維持されています。対応するレイアウトとテストの制限については、投稿と受信箱の操作を参照してください。

MCP ガイドでは、すべてのツール、プロンプト、リソースについて説明しています。検証の証拠では、ローカルのプロトコルチェック、合成ブラウザーフィクスチャ、許可を得たライブアカウントのチェックを区別しています。

uvx クライアントでは、uvx x-use-mcp を使用するか、 uvx x-use-mcp==3.2.0 でリリースを固定してください。x-use-mcp 実行ファイルは引数なしで MCP を起動します。 既存の x-use mcp コマンドも引き続きサポートされています。3.0.0 に固定されたクライアントでは、 uvx --from x-use-mcp==3.0.0 x-use mcp を使用してください。

実行の仕組み

現在の MCP ランタイムでは、アカウントごとに分離されたコンテキストで、非同期の Patchright Chromium を使用します。設定、Cookie、下書き、キュー、アクションジャーナルは X_USE_HOME の下に保存されます。AI クライアントおよび任意のモデルプロバイダーによるデータの取り扱いは、選択したクライアントとプロバイダーによって異なります。

プロトコルの実装には MCP Python SDK v2 系列（mcp>=2.3,<3）を使用しています。既存のクライアントとの間で、2024-11-05 から 2025-11-25 までのハンドシェイクプロトコルバージョンをネゴシエートします。

通常の投稿では、下書きモードがデフォルトで有効です。メッセージ、フォロー、スレッドの開始には、下書きの承認が必要です。直接投稿モード、明示的なキュー処理、オプトインによる自動排出、レガシーのバッチランナーには、それぞれ別の実行経路があります。これらの設定を変更する前に、設定リファレンスを確認してください。

開発用チェックアウトでは、X_USE_HOME ごとに 1 つの MCP サーバープロセスのみを許可し、古い下書きやキューの状態を使って複数のサーバーが同時に動作するのを防ぎます。同じデータディレクトリを別のクライアントで開く前に、既存の接続を閉じてください。

把握しておくべき制限事項

• ブラウザーで読み取れる内容は、X 上で表示される範囲に限られます。フォロワー、受信トレイ、スレッドは完全なエクスポートではないため、取得できない情報は不明のままです。
• 会話や通知を開くと、X 側の既読状態が変わる場合があります。
• ブラウザーコンテキストの再起動後、暗号化された受信トレイではアカウント所有者の PIN の再入力が必要になる場合があります。
• アナリティクスで現在確認できるのは、利用可能かどうかと、確認された Premium の利用制限のみです。完全なアナリティクスダッシュボードは提供されません。
• X のレイアウト変更、セッションの期限切れ、アカウントの確認要求、プラットフォームの制限によって、作業が中断される場合があります。ローカルの制御機能は、アカウント制限からの保護を保証するものではありません。
• レガシー Selenium バッチエンジン（x-use run / run_cycle）は、MCP の下書きレビューとは別に実行されます。非同期ランタイムでのコミュニティへの投稿は、現在検証されていません。

ブラウザーの動作と復旧方法と責任ある利用に関するガイダンスをご覧ください。

よくある質問

x-use の利用に X API キーは必要ですか？

いいえ。セッション Cookie で認証されたブラウザーを通じて、表示されている X のページを操作します。X の公式 API 認証情報は必要ありません。オプションのサーバー側テキスト生成には、LLM プロバイダーのキーが必要な場合があります。

どの MCP クライアントで x-use を利用できますか？

ローカルの stdio MCP サーバーを起動するクライアントで利用できます。セットアップ例では、Claude Desktop、Claude Code、Codex、Cursor、Windsurf を取り上げています。クライアントによって、サーバーの検出や再読み込みの動作は異なります。

下書きしたメッセージはすべて x-use が自動的に送信しますか？

いいえ。メッセージの下書きは個別に承認する必要があります。それ以外の書き込み動作は、下書きモード、キューの実行、レガシーランナーによって異なります。操作を依頼する前に、設定済みのポリシーを確認してください。

複数の X アカウントを管理できますか？

はい。各アカウントは Cookie、ブラウザーコンテキスト、ポリシー設定が個別に管理され、オプションでプロキシルートも設定できます。ブラウザーの処理能力には上限があり、ホスト環境と設定に応じて異なります。

投稿の編集や X の受信トレイの管理はできますか？

バージョン 3.1.0 では、レビューを経た投稿の編集と削除、ブックマーク、フォロー解除、および対応する会話リクエスト、ミュート／ミュート解除、削除の操作が追加されました。投稿を編集できるかどうかは X が決定します。受信トレイの履歴は一部のみ取得でき、メッセージ単位の編集・削除、添付ファイルの送信、グループ管理には対応していません。正確な引数と制限については、制御ガイドをご覧ください。

x-use は無料のオープンソースですか？

このプロジェクトは MIT ライセンスで提供され、プロジェクト自体のライセンス料はかかりません。AI クライアントのサブスクリプション、オプションのモデルプロバイダー、プロキシ、ホスティングには、それぞれ費用が発生する場合があります。

x-use は X と提携していますか？

いいえ。x-use は独立したコミュニティプロジェクトです。X と Twitter は、x-use が操作するプラットフォームを示す名称として使用されています。

このプロジェクトは以前、twitter-automation-ai という名前でしたか？

はい。v2 のリローンチ時に、プロジェクト名が x-use に変更されました。これまでの経緯については、変更履歴をご覧ください。

ドキュメントとコミュニティ

ドキュメントの目次から始めてください。セットアップ、ワークフロー、ツール、設定、プリセット、アーキテクチャ、トラブルシューティングへのリンクがあります。X-Use は Huzaifa Shoukat がメンテナンスしており、コミュニティからの貢献を歓迎しています。

再現可能な問題を見つけましたか？バグを報告してください。共有したいワークフローがありますか？ディスカッションを開始してください。初めての貢献としては、セットアップ手順の明確化、架空のブラウザーフィクスチャ、プラットフォームの修正、サンプルプリセットなどが役立ちます。

CONTRIBUTING、行動規範、セキュリティポリシーをご覧ください。x-use が役に立った場合は、GitHub でスターを付けると、ほかの開発者が見つけやすくなります。

スター履歴

ライセンス

MIT.