twitterapi

twitterapi.io MCP サーバー

AI エージェントやアプリケーション向けの Twitter / X データ API、twitterapi.io 用の公式 Model Context Protocol サーバーです。

Claude Desktop、Cursor、VS Code Copilot、または任意の MCP クライアントを twitterapi.io に接続すると、自然言語でツイートの検索、ユーザープロフィールの取得、フォロワーや返信、トレンドなどの確認ができます。

機能

twitterapi.io の本番環境で検証済みのエンドポイントに 1 対 1 で対応する、読み取り専用ツールが 12 個あります。

ツール	説明
search_tweets	Twitter の演算子（from:、since:、lang:、has:、…）を使った高度な検索
get_user_info	スクリーンネームによるユーザープロフィールの基本情報
get_user_about	詳細なプロフィール／紹介ページ
get_user_followers	プロフィールのメタデータ全体を含むフォロワー一覧（ページネーション対応）
get_user_followings	プロフィールのメタデータを含むフォロー中のユーザー一覧（ページネーション対応）
get_user_last_tweets	ユーザーの最近のツイート（タイムライン）
get_user_mentions	ユーザーに言及しているツイート
get_tweets_by_ids	ID を指定してツイートを一括取得（最大 100 件）
get_tweet_replies	ツイートへの返信
get_tweet_quotes	ツイートの引用ツイート
get_tweet_retweeters	ツイートをリツイートしたユーザー
get_trends	場所（WOEID）別のトレンドトピック

クイックスタート

1. API キーを取得する

twitterapi.io に登録してください。無料プランを利用できます。

2. MCP クライアントを設定する

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

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

Claude Desktop を再起動します。12 個のツールがすべてのチャットで利用でき、Claude はプロンプトに応じて適切なツールを選択します。

Cursor

Settings → MCP → Add new MCP Server を開きます。

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

VS Code（MCP を使った Copilot Chat）

MCP サーバーの設定に追加します。形式は Claude Desktop／Cursor と同じです。

Claude Code

claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here

3. 使用する

MCP 対応のチャットで、次のように入力します。

「過去 1 週間の AI に関する @elonmusk の最近のツイートを探して」

「@sama のフォロワー一覧を取得して、フォロワー数の多い上位 20 人を表示して」

「現在の日本のトレンドトピックは？」

Claude（またはクライアント）が search_tweets／get_user_followers／get_trends を自動的に選択し、適切なパラメーターを指定して呼び出します。

認証

認証には、MCP クライアントから渡される環境変数 TWITTERAPI_IO_API_KEY を使用します。サーバーがキーを保存したり、ログに記録したりすることはありません。各ツールの呼び出しでは、X-API-Key ヘッダーにキーを設定して https://api.twitterapi.io に送信します。

ページネーション

リスト（フォロワー、返信、検索結果など）を返すツールは、next_cursor フィールドを返します。次のページを取得するには、次回の呼び出しでその値を cursor 引数として渡します。通常、1 ページあたり約 20 件です。

エラー処理

• 429／5xx のレスポンスは、指数バックオフで自動的に再試行されます（3 回、1s／2s／4s）
• ネットワークタイムアウト：リクエストごとに 30s
• 429 以外の 4xx エラーは、元のメッセージとともに LLM にすぐに返されます

ツール — 詳細仕様

各ツールの入力スキーマは MCP の tools/list で公開され、JSON Schema に準拠しています。mcp-inspector を使って npx @twitterapi_io/mcp-server を実行すると、対話形式で確認できます。

npx @modelcontextprotocol/inspector npx -y @twitterapi_io/mcp-server

含まれない機能

このサーバーは、設計上読み取り専用のエンドポイントを公開します。自律型エージェントが安全に使用できるよう、以下の機能は意図的に除外しています。

• ❌ ツイートの投稿、いいね、リツイート、フォロー、DM
• ❌ アカウントへのログイン／2FA
• ❌ プロフィール／バナー／アバターの編集
• ❌ メディアのアップロード
• ❌ アカウントの削除
• ❌ リアルタイムストリーム／Webhook の設定（MCP のリクエスト／レスポンスモデルに適合しません）

これらの機能は、完全な twitterapi.io REST API で利用できます。書き込みアクセスが必要な場合は、REST API を直接ご利用ください。

仕様への準拠

• @modelcontextprotocol/sdk v1 を基盤として構築
• MCP 仕様 2025-11-25（最新版）を対象
• トランスポート：stdio（リモート／ホスト用途向けの Streamable HTTP は v0.2 以降に予定）
• テスト済み：mcp-inspector、Claude Desktop、Cursor、Claude Code

開発

git clone https://github.com/kaitoInfra/twitterapi-io-mcp-server.git
cd twitterapi-io-mcp-server
npm install
npm run build
TWITTERAPI_IO_API_KEY=xxx npm run inspect  # opens mcp-inspector

リンク

• 🔗 twitterapi.io — REST API のホームページと登録
• 📖 twitterapi.io ドキュメント — API の完全なリファレンス
• 🧰 Model Context Protocol — プロトコルのホームページ
• 🐛 問題を報告

ライセンス

MIT © twitterapi.io