Model Context Protocolサーバー

Twitter MCP Server

Twitter/Xデータを、Claude、Cursor、AIエージェント向けのMCPツールとして利用できます。

Twitter/Xのライブデータを、オープンソースのサーバーがAIクライアントに そのまま接続します — 読み取り専用の12ツール、ワンコマンドでインストール、 Twitter開発者アカウント不要、スクレイピングもなし。

claude_desktop_config.json
{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": { "TWITTERAPI_IO_API_KEY": "your_key_here" }
    }
  }
}

「設定」→「開発者」→「構成を編集」を開いて貼り付け、Claude を再起動します。 your_key_here は、ご自身の twitterapi.io API キーに置き換えてください。

12個の読み取り専用ツール·MITライセンス·MCP spec 2025-11-25·読了目安:約5分
/01

Twitter MCP Serverとは

Twitter MCP Serverは、Claude や Cursor をはじめとする AIエージェントに、Twitter/Xのライブデータへの直接的かつ 構造化されたアクセスを提供する、オープンソースのModel Context Protocolサーバーです。ワンコマンドでインストールし、 twitterapi.io の API キーを指定すれば、ツイート検索、プロフィール・ フォロワー・返信・トレンドの取得など、12個のツールが AIクライアントから使えるようになります。

MCP は、AIアプリケーションが外部ツールやデータソースを統一的な方法で 呼び出せるようにするオープン標準です。サービスごとに専用の 連携コードを書く代わりに、クライアントは1つのプロトコルで多数の サーバーと会話します。本サーバーはその Twitter/X 部分 —— twitterapi.io の読み取り専用データエンドポイントをラップしているので、 MCP 対応のあらゆるクライアントがネイティブツールとして利用できます。 どのツールをどの引数で呼び出すかはエージェントが判断し、 あなたは自然言語で質問するだけです。

仕様上、読み取り専用です —— 投稿なし、ログインなし、 スクレイピングなし。ライセンスは MIT なので、ソースコードを 読む、フォークする、無改変で動かすのも自由です。

/02

12個のツール

各ツールは twitterapi.io のエンドポイントに対応し、 公開データのみを返します。リクエストごとに最適なツールを エージェントが選択します。

  • search_tweetsfrom:、since:、lang:など、Twitterの演算子をフルに使った高度な検索。トピック監視、データセット作成
  • get_user_info任意のアカウントの基本プロフィールをハンドル名から取得。bio、フォロワー数、認証情報など。アカウント検索とエンリッチメント
  • get_user_aboutユーザーの拡張プロフィール/詳細情報。より深いプロフィール情報の把握
  • get_user_followersアカウントのフォロワーをメタデータ付きで取得。カーソルベースのページネーションに対応。オーディエンスとネットワークの分析
  • get_user_followingsユーザーがフォローしているアカウントを取得。カーソルベースのページネーションに対応。興味関心グラフの可視化
  • get_user_last_tweetsユーザーのタイムラインにある最近のツイート。アクティビティの追跡と要約
  • get_user_mentions指定したアカウントに言及しているツイート。ブランドと評判のモニタリング
  • get_tweets_by_ids1回の呼び出しで、IDから最大50件のツイートを一括取得。ツイートデータセットのハイドレーション
  • get_tweet_repliesツイートにぶら下がる返信スレッド。会話分析
  • get_tweet_quotes指定したツイートの引用ツイート。議論と拡散の分析
  • get_tweet_retweetersツイートをリツイートしたアカウント。拡散力とリーチの分析
  • get_trendsWOEIDで指定した場所のトレンドトピック。トレンド検知とタイムリーなコンテンツ作成
/03

インストールと設定

サーバーはローカルで npx で実行されます —— clone もビルドも不要です。下の設定を クライアントに追加し、API キーをセットして、再起動するだけです。

Claude Desktop

これを claude_desktop_config.json に貼り付け(Settings → Developer → Edit Config)、Claude を再起動してください。 ファイルの場所は ~/Library/Application Support/Claude/ 、Windows では %APPDATA%\Claude\ です。

claude_desktop_config.json
{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": { "TWITTERAPI_IO_API_KEY": "your_key_here" }
    }
  }
}

Cursor & VS Code

どちらも同じ MCP 設定を使います。Cursor では Settings → MCP → Add new MCP Server、VS Code では User Settings (JSON) を開いて MCP servers ブロックの下にサーバーを追加します。いずれの場合も、 同じ mcpServers ブロックを貼り付けてください。

Claude Code

ターミナルからコマンド1つで実行できます。

ターミナル
claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here

置き換えるのは your_key_here です。実際のtwitterapi.io APIキーに置き換えてください。詳しくは次のセクションを参照してください。

/04

リクエストの流れ

サーバーを接続したら、APIを直接呼び出すことはもうありません。 AIクライアントに普通に質問するだけで、適切なツールが選ばれ、 呼び出され、結果が読み上げられます。実際の往復の例を示します。

  1. 1

    あなたが質問する

    ClaudeやCursorで、自然な言葉で入力します。

    “@elonmuskのプロフィールを取得して。”

  2. 2

    エージェントがツールを呼び出す

    モデルは、この依頼が get_user_info に対応すると判断し、推測した引数で呼び出します。
    ツール呼び出し
    {
      "name": "get_user_info",
      "arguments": { "userName": "elonmusk" }
    }
  3. 3

    サーバーがライブデータを返す

    twitterapi.io が応答し、サーバーがライブのプロフィール情報を そのままモデルに引き渡します:
    レスポンス
    {
      "data": {
        "id": "44196397",
        "userName": "elonmusk",
        "name": "Elon Musk",
        "followers": 239997162,
        "following": 1142,
        "isBlueVerified": true,
        "description": "...",
        "profilePicture": "https://..."
      }
    }
  4. 4

    エージェントが回答する

    モデルはそれを読み取り、自然な言葉で返答します —— 「@elonmusk の フォロワーは約2.4億、フォローは1,142アカウント、Blue 認証済みです」 といった形で、あるいは表、比較、要望に応じた形で。 連携コードもレート制限処理も、こちら側で書く必要はありません。

同じパターンがすべてのツールに当てはまります —— 「世界で今トレンドは?」 は get_trendsへ、「@sama の最近の AGI に関するツイート」は search_tweetsに振り分けられます。

/05

APIキーの取得

サーバーは、あなた自身の API キーを使って twitterapi.io に認証します。 キーは TWITTERAPI_IO_API_KEY 環境変数で渡します。

  1. 1.twitterapi.ioにサインインし、ダッシュボードを開きます。
  2. 2.ダッシュボードからAPIキーをコピーします。
  3. 3.設定内で TWITTERAPI_IO_API_KEY として貼り付け、クライアントを再起動します。
APIキーを取得
/06

twitterapi.ioを選ぶ理由

サーバーの質は、裏にある API の質で決まります。公式の X(Twitter) API は開発者アカウントが必要で、機能は高額なティアに閉じ込められ、 価格はエンタープライズ向けです。twitterapi.io は逆のアプローチを 取っています:

$0.15

取得した1,000ツイートあたり。従量課金で、サブスクリプションも最低利用料金も不要

最大 1,000 QPS*

サブスクリプション階層に応じてスケール — /qps-limits 参照

開発者アカウント不要

Twitter開発者承認もアプリ審査も不要

詳しくは 料金詳細 で料金表を確認できます。また、 X API概要 では、twitterapi.ioと公式APIの詳細な比較を確認できます。

/07

MCPを使わずにエージェントを組む

すべてのエージェントフレームワークがMCPに対応しているわけではありません。HTTPを直接呼び出す場合は、twitterapi.ioにある次の3つのファイルを最初のリクエストの前に読ませれば、エージェントがAPIの使い方を把握できます。

x402で1回ずつ支払う(アカウント不要)

自分のウォレットを持つエージェント向けに、BaseまたはSolana上のUSDCで1回単位の呼び出しを購入できるx402エンドポイントを別に用意しています。支払いなしで呼び出すと、HTTP 402で価格と支払い先が返ります。エージェントが支払いに署名し、同じリクエストを送り直すと結果が返ります。これはMCPサーバーの機能ではありません。上の12個のMCPツールはAPIキーを使い、x402は読み取り専用エンドポイントに対応しています。下の表はその一例です。結果が0件でも、支払った呼び出しには料金がかかります。

ターミナル
curl -i "https://api.twitterapi.io/x402/twitter/user/info?userName=jack"

レスポンス

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi...   # base64のJSON:価格・ネットワーク・支払い先
{"error":"Payment required"}
x402のルート1回あたりの価格1回で返る件数
/x402/twitter/tweets$0.001ID指定で最大20件のツイート
/x402/twitter/user/info$0.003プロフィール1件
/x402/twitter/tweet/advanced_search$0.0031ページ(最大20件の投稿)
/x402/twitter/user/followers$0.0031ページ(最大200件のフォロワー)
/x402/twitter/user/last_tweets$0.0031ページ(最大20件の投稿)

全ルートと価格:x402ドキュメント、エージェント向けの一覧:/.well-known/x402

402レスポンスの各フィールドを含む支払いの流れは、x402の解説記事(英語)で説明しています。書き込み操作やストリームを使う場合は、ダッシュボードでAPIキーを取得してください。

/08

よくある質問

MCPサーバーとは?

MCP(Model Context Protocol)は、AIアプリケーションが外部ツールやデータソースを共通の方法で呼び出すためのオープン標準です。MCPサーバーは1つの機能を公開します。このサーバーはTwitter/Xデータを公開するため、MCP対応クライアントなら、連携コードを書かなくてもツイート、プロフィール、トレンドを読み取れます。

どのクライアントで使えますか?

MCPに対応しているものであれば使えます。Claude Desktop、Claude Code、Cursor、VS Codeをはじめ、MCP対応のエディタやエージェントで動作します。セットアップはいずれも同じ標準設定です。

Twitter MCP serverは無料ですか?

サーバー自体はMITライセンスの無料オープンソースです。利用するtwitterapi.ioは取得件数に応じた従量課金制で、自分のAPIキーを設定し、ツールが実際に取得したデータ分だけ支払います。

twitterapi.ioのアカウントとAPIキーは必要ですか?

はい。サーバーにはtwitterapi.io APIキーが必要で、TWITTERAPI_IO_API_KEY環境変数で渡します。キーはダッシュボードから約1分で作成できます。

MCPサーバーでできないことは?

完全に読み取り専用です。投稿、返信、いいね、フォロー、DM送信、アカウントへのログインはできません。12個のツールはいずれも公開されているTwitter/Xデータを取得するだけです。

公式X(Twitter)APIとは何が違いますか?

公式X APIを使うにはTwitter開発者アカウントが必要で、機能は制約の大きい料金ティアの内側にあり、価格もエンタープライズ向けです。このサーバーは代わりにtwitterapi.ioと通信します。開発者アカウントは不要、取得件数に応じた従量課金で、公開データへの読み取りアクセスをはるかに低コストで利用できます。

どのMCP仕様バージョンを実装していますか?

現在リリースされている仕様である2025-11-25 Model Context Protocol specificationを対象にしています。そのため、最新のMCPクライアントで動作します。

オープンソースですか?

はい。MITライセンスで、npmのnpxパッケージとしてnpmjs.com/package/@twitterapi_io/mcp-serverで公開されています。

最新版へ更新するには?

設定ではnpx経由でサーバーを起動するため、起動のたびに公開済みの最新版が自動で取得されます。特定のバージョンに固定したい場合は、argsで明示的に指定してください。

レート制限はありますか?

twitterapi.ioは高スループット向けに設計されており、最上位サブスクリプション階層で最大 1,000 QPS に対応します(階層別の詳細は /qps-limits を参照)。サーバー自体は追加の制限を加えません。実際の利用量はレート上限ではなく、APIクレジットと階層によって決まります。

エージェントにリアルタイムのTwitterデータを。

サーバーをインストールし、API キーを設定するだけで、Claude や Cursor は次のメッセージからツイート検索、プロフィール、フォロワー、 トレンドの読み取りができるようになります。