twitterapi-io-mcp

twitterapi-io-mcp

MCP を介して Claude や AI アシスタントが利用できる、TwitterAPI.io のオフラインドキュメントです。有効なエンドポイントは 75 個（メソッド／パラメーター／本文をすべて掲載）、ガイドは 32 件、ブログ記事は 24 件です。API キーは不要です。

# Quick install (Claude Code)
claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp

これは何ですか？

Claude、Cursor、VS Code Copilot、その他の AI アシスタントに、TwitterAPI.io のドキュメントへの即時のオフラインアクセスを提供する MCP サーバーです。

• 有効な API エンドポイント 75 個：HTTP メソッド、本文／クエリパラメーター、cURL の例、レスポンススキーマをすべて掲載
• ガイドページ 32 件：料金、認証、レート制限、ウェブフック、ストリーミングを解説
• ブログ記事 24 件：チュートリアルとユースケースを掲載
• v2 の書き込みエンドポイントをすべて掲載：login_cookies、proxy、本文パラメーターを含む
• 非推奨の v1 エンドポイントをすべて削除：現在の v2 エンドポイントのみを掲載
• API キーは一切不要：すべてローカルに同梱

ライブ API 呼び出しを中継する（そのため API キーが必要な）他の Twitter MCP サーバーとは異なり、このサーバーにはドキュメント一式のスナップショットが含まれています。AI アシスタントはローカルで即座に読み取れます。

最近の変更

• v1.2.0：OpenAPI を優先するスクレイパーに書き換え。型付きの構造化パラメーターとレスポンススキーマを追加し、Vercel のチェックポイント問題を解消
• v1.1.x：list_timeline と get_user_timeline を追加し、非推奨の V1 エンドポイントを 7 個削除。セキュリティ修正（hono、ajv、express-rate-limit）
• v1.0.23：プラットフォームに関するお知らせ — Twitter で検索演算子 since:／until: が無効になりました。代わりに since_time:UNIX／until_time:UNIX を使用してください
• v1.0.22：7 個のエンドポイントを追加（get_space_detail、get_tweet_replies_v2、get_user_about など）

変更履歴の全容については、CHANGELOG.md をご覧ください。

免責事項：独立したコミュニティプロジェクトです。TwitterAPI.io とは提携していません。

インストール

以前 twitterapi-docs-mcp として公開されていた場合は、パッケージ名を変更するだけで、その他はそのままです。

必要要件： Node.js 18.18.0 以降

Claude Code（推奨）

# Add globally (all projects)
claude mcp add --scope user twitterapi-io -- npx -y twitterapi-io-mcp

# Or project-only
claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp

# Verify
claude mcp list

Claude Desktop

設定ファイルに追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

VS Code / VS Code Insiders

プロジェクトのルートにある .vscode/mcp.json に追加します。

{
  "servers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "twitterapi-io-mcp"]
    }
  }
}

Docker

docker run -i --rm $(docker build -q .) 2>/dev/null

または、ソースからビルドします。

git clone https://github.com/dorukardahan/twitterapi-io-mcp.git
cd twitterapi-io-mcp && npm install
node index.js

利用可能なツール

ツール	説明	最適な用途
search_twitterapi_docs	すべてのドキュメントを全文検索（あいまい検索、誤字に対応）	キーワードでエンドポイント、ガイド、ブログ記事を探す
get_twitterapi_endpoint	パラメーター、例、レスポンススキーマを含むエンドポイントの詳細なドキュメントを取得	特定の API エンドポイントを詳しく調べる
list_twitterapi_endpoints	エンドポイントを一覧表示。カテゴリーで絞り込み可能	カテゴリーごとに利用可能な内容を確認する
get_twitterapi_guide	ガイドページを取得（料金、認証、レート制限、ウェブフックなど）	プラットフォームのルールや設定方法を理解する
get_twitterapi_url	URL パスまたはページキーを指定してコンテンツを取得	ドキュメントへの直接リンクがある場合
get_twitterapi_pricing	料金の概要をすばやく確認	費用に関する質問
get_twitterapi_auth	認証ガイドをすばやく確認	認証の設定と API キーの使用

AI アシスタント向け

この MCP サーバーを使用する AI アシスタント向けのクイックリファレンスです。

ユーザーの要望	使用するツール	例
エンドポイントを検索する	search_twitterapi_docs	query: "advanced search"
エンドポイントの詳細を確認する	get_twitterapi_endpoint	endpoint_name: "tweet_advanced_search"
すべてのエンドポイントを一覧表示する	list_twitterapi_endpoints	category: "user"（任意）
料金情報を確認する	get_twitterapi_pricing	パラメーター不要
認証ガイドを確認する	get_twitterapi_auth	パラメーター不要
ガイドやページを確認する	get_twitterapi_guide	guide_name: "qps_limits"
URL から取得する	get_twitterapi_url	url: "pricing"

ヒント：

• あいまい検索に対応しており、タイプミスも許容されます。"twet object" でも結果が見つかります
• 絞り込んだ結果を得るには、max_results: 5 を使用してください
• すべてのエンドポイントは現行の v2 で、非推奨のエンドポイントは残っていません

何を質問できますか？

この MCP サーバーでうまく機能する、実際のプロンプトを紹介します。

• 「TwitterAPI.io のレート制限は？」 — get_twitterapi_guide を呼び出します
• 「ツイートの高度な検索エンドポイントを表示して」 — get_twitterapi_endpoint を呼び出します
• 「API で認証する方法は？」 — get_twitterapi_auth を呼び出します
• 「料金はいくら？」 — get_twitterapi_pricing を呼び出します
• 「ユーザー関連のエンドポイントをすべて一覧表示して」 — category: "user" を指定して list_twitterapi_endpoints を呼び出します
• 「Webhook のフィルタールールはどのように機能する？」 — search_twitterapi_docs を呼び出します
• 「ログインが必要な書き込みエンドポイントは？」 — query: "login_cookies" を指定して search_twitterapi_docs を呼び出します
• 「メディアをアップロードしてツイートを作成する方法は？」 — get_twitterapi_endpoint を順番に呼び出します

カテゴリ別の全 75 エンドポイント

カテゴリ	件数	エンドポイント
ユーザー	13	get_user_by_username, get_user_about, search_user, batch_get_user_by_userids, get_user_last_tweets, get_user_timeline, get_user_mention, get_user_followers, get_user_verified_followers, get_user_followings, check_follow_relationship, get_my_info, get_user_followers_ids
その他	2	get_space_detail, bookmarks_v2
トレンド	1	get_trends
ツイート	10	get_tweet_by_ids, get_article, get_tweet_reply, get_tweet_replies_v2, get_tweet_thread_context, get_tweet_quote, get_tweet_retweeter, tweet_advanced_search, bookmark_tweet_v2, unbookmark_tweet_v2
リスト	6	list_timeline, get_list_members, get_list_followers, add_list_member, remove_list_member, get_list_tweets
コミュニティ	9	get_all_community_tweets, create_community_v2, delete_community_v2, join_community_v2, leave_community_v2, get_community_by_id, get_community_members, get_community_moderators, get_community_tweets
アクション	25	user_login_v2, create_tweet_v2, upload_media_v2, like_tweet_v2, unlike_tweet_v2, delete_tweet_v2, retweet_tweet_v2, follow_user_v2, unfollow_user_v2, update_avatar_v2, update_banner_v2, update_profile_v2, login_by_2fa, login_by_email_or_username, upload_image, create_tweet, like_tweet, retweet_tweet, block_user_v2, mute_user_v2, pin_tweet_v2, unblock_user_v2, unmute_user_v2, unpin_tweet_v2, unretweet_tweet_v2
DM	2	send_dm_v2, get_dm_history
Webhook	4	get_webhook_rules, add_webhook_rule, update_webhook_rule, delete_webhook_rule
ストリーム	3	add_user_to_monitor_tweet, remove_user_to_monitor_tweet, get_user_to_monitor_tweet

設定

環境変数	デフォルト値	説明
TWITTERAPI_MCP_DISK_CACHE	1（有効）	ディスクキャッシュを無効にするには 0 に設定します

トラブルシューティング

初回実行時に npx がハングする、または失敗する

初回実行時には、npm からパッケージがダウンロードされます。ハングする場合は、次をお試しください。

npx -y twitterapi-io-mcp@latest

または、グローバルにインストールしてください：npm install -g twitterapi-io-mcp

「Node.js version not supported」

このサーバーには Node.js 18.18.0 以降が必要です。バージョンを確認してください。

node --version

claude mcp add が認識されない

Claude Code CLI がインストールされ、最新の状態であることを確認してください。

claude --version

サーバーは起動するが、ツールが表示されない

サーバー設定を追加した後、MCP クライアントを再起動してください。ほとんどのクライアント（Claude Desktop、Cursor）は、新しい MCP サーバーを検出するために再起動が必要です。

仕組み

┌─────────────┐     MCP (stdio)      ┌──────────────────┐
│   Claude /   │ ◄──────────────────► │ twitterapi-io-mcp│
│  Cursor /    │                      │                  │
│  VS Code     │                      │  Bundled docs    │
└─────────────┘                      │  (75 endpoints)  │
                                     └──────────────────┘
                                       No network needed

プロパティ	値
ランタイム	Node.js 18.18.0+（ES Modules、ビルド不要）
プロトコル	stdio 経由の MCP
キャッシュ	ハイブリッド（メモリ＋ディスク）、24h TTL
検索	ファジーマッチングを使用した N-gram トークン化

1. AI アシスタントが MCP ツール（検索、エンドポイントの取得など）を呼び出します
2. サーバーがバンドルされたドキュメントのスナップショットを検索します
3. ネットワークリクエストなしで、結果がすぐに返されます

作成した理由

プロジェクトで TwitterAPI.io を毎日使っています。エディターと公式ドキュメントサイトを行き来するのにすぐうんざりしたため、ドキュメント全体を MCP サーバーにまとめました。今では、ターミナルを離れずに Claude に質問して回答を得られます。

TwitterAPI.io を通じて Twitter/X API を利用しているなら、コンテキストを切り替える手間を同じように省けます。インストールしたら、あとは気にせず、質問するだけです。

開発

git clone https://github.com/dorukardahan/twitterapi-io-mcp.git
cd twitterapi-io-mcp
npm install
npm test        # Run tests (48 tests)
npm start       # Start server locally
npm run scrape  # Update docs snapshot from twitterapi.io

MCP を使わない場合

お使いの AI ツールが MCP に対応していない場合（OpenClaw など）は、代わりにスキル版をご利用ください。75 個の有効なエンドポイントをすべて収録した単一の Markdown ファイルです。

👉 twitterapi-io-skill — OpenClaw、Claude、GPT、Gemini、およびあらゆる LLM で動作します。

リンク

• npm：twitterapi-io-mcp
• スキル版：dorukardahan/twitterapi-io-skill
• GitHub：dorukardahan/twitterapi-io-mcp
• MCP Registry：registry.modelcontextprotocol.io
• TwitterAPI.io：twitterapi.io

コントリビューション

PR を歓迎します！リポジトリをフォークし、ブランチを作成して変更を加えた後、プルリクエストを送ってください。バグ報告や機能リクエストは GitHub Issues にお寄せください。

ライセンス

MIT

謝辞

• API サービスを提供する TwitterAPI.io
• Model Context Protocol を提供する Anthropic
• MCP TypeScript SDK