Twitter MCP Server
Twitter/Xデータを、Claude、Cursor、AIエージェント向けのMCPツールとして利用できます。
Twitter/Xのライブデータを、オープンソースのサーバーがAIクライアントに そのまま接続します — 読み取り専用の12ツール、ワンコマンドでインストール、 Twitter開発者アカウント不要、スクレイピングもなし。
{
"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 キーに置き換えてください。
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 なので、ソースコードを 読む、フォークする、無改変で動かすのも自由です。
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で指定した場所のトレンドトピック。トレンド検知とタイムリーなコンテンツ作成
インストールと設定
サーバーはローカルで npx で実行されます —— clone もビルドも不要です。下の設定を クライアントに追加し、API キーをセットして、再起動するだけです。
Claude Desktop
これを claude_desktop_config.json に貼り付け(Settings → Developer → Edit Config)、Claude を再起動してください。 ファイルの場所は ~/Library/Application Support/Claude/ 、Windows では %APPDATA%\Claude\ です。
{
"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キーに置き換えてください。詳しくは次のセクションを参照してください。
リクエストの流れ
サーバーを接続したら、APIを直接呼び出すことはもうありません。 AIクライアントに普通に質問するだけで、適切なツールが選ばれ、 呼び出され、結果が読み上げられます。実際の往復の例を示します。
- 1
あなたが質問する
ClaudeやCursorで、自然な言葉で入力します。“@elonmuskのプロフィールを取得して。”
- 2
エージェントがツールを呼び出す
モデルは、この依頼がget_user_infoに対応すると判断し、推測した引数で呼び出します。ツール呼び出し{ "name": "get_user_info", "arguments": { "userName": "elonmusk" } } - 3
サーバーがライブデータを返す
twitterapi.io が応答し、サーバーがライブのプロフィール情報を そのままモデルに引き渡します:レスポンス{ "data": { "id": "44196397", "userName": "elonmusk", "name": "Elon Musk", "followers": 239997162, "following": 1142, "isBlueVerified": true, "description": "...", "profilePicture": "https://..." } } - 4
エージェントが回答する
モデルはそれを読み取り、自然な言葉で返答します —— 「@elonmusk の フォロワーは約2.4億、フォローは1,142アカウント、Blue 認証済みです」 といった形で、あるいは表、比較、要望に応じた形で。 連携コードもレート制限処理も、こちら側で書く必要はありません。
同じパターンがすべてのツールに当てはまります —— 「世界で今トレンドは?」 は get_trendsへ、「@sama の最近の AGI に関するツイート」は search_tweetsに振り分けられます。
APIキーの取得
サーバーは、あなた自身の API キーを使って twitterapi.io に認証します。 キーは TWITTERAPI_IO_API_KEY 環境変数で渡します。
- 1.twitterapi.ioにサインインし、ダッシュボードを開きます。
- 2.ダッシュボードからAPIキーをコピーします。
- 3.設定内で
TWITTERAPI_IO_API_KEYとして貼り付け、クライアントを再起動します。
twitterapi.ioを選ぶ理由
サーバーの質は、裏にある API の質で決まります。公式の X(Twitter) API は開発者アカウントが必要で、機能は高額なティアに閉じ込められ、 価格はエンタープライズ向けです。twitterapi.io は逆のアプローチを 取っています:
取得した1,000ツイートあたり。従量課金で、サブスクリプションも最低利用料金も不要
サブスクリプション階層に応じてスケール — /qps-limits 参照
Twitter開発者承認もアプリ審査も不要
詳しくは 料金詳細 で料金表を確認できます。また、 X API概要 では、twitterapi.ioと公式APIの詳細な比較を確認できます。
MCPを使わずにエージェントを組む
すべてのエージェントフレームワークがMCPに対応しているわけではありません。HTTPを直接呼び出す場合は、twitterapi.ioにある次の3つのファイルを最初のリクエストの前に読ませれば、エージェントがAPIの使い方を把握できます。
エージェント用のスキルファイル。どの質問にどのエンドポイントを使うか、APIキーでの認証方法、1回の呼び出しにかかる費用をまとめています。
/llms.txt言語モデル向けのテキスト形式のAPI案内。サービスの概要、主なエンドポイント、ドキュメントの場所を記載しています。
/.well-known/mcp.jsonMCPのディスカバリーマニフェスト。サーバー名、エンドポイント、ツール一覧を、MCPサーバーを探すディレクトリやエージェント向けに公開しています。
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.001 | ID指定で最大20件のツイート |
| /x402/twitter/user/info | $0.003 | プロフィール1件 |
| /x402/twitter/tweet/advanced_search | $0.003 | 1ページ(最大20件の投稿) |
| /x402/twitter/user/followers | $0.003 | 1ページ(最大200件のフォロワー) |
| /x402/twitter/user/last_tweets | $0.003 | 1ページ(最大20件の投稿) |
全ルートと価格:x402ドキュメント、エージェント向けの一覧:/.well-known/x402
402レスポンスの各フィールドを含む支払いの流れは、x402の解説記事(英語)で説明しています。書き込み操作やストリームを使う場合は、ダッシュボードでAPIキーを取得してください。
よくある質問
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 は次のメッセージからツイート検索、プロフィール、フォロワー、 トレンドの読み取りができるようになります。