XTapDown

XTapDown MCP サーバー

あらゆる LLM クライアント（Claude Desktop、Cursor、Cline、Continue、独自のエージェントなど）から XTapDown の X（Twitter）クリエイターツールキットに直接アクセスできる MCP（Model Context Protocol）サーバーです。

14 個のツールを読み取り専用で利用でき、認証は不要、無料です。

ツール（14 個）

XTapDown のすべてのウェブツールに対応しています。4 種類のダウンローダー（動画、GIF、画像、全アーカイブ）は、同じ X シンジケーションエンドポイントを共有するため、単一の download_tweet に統合されています。

ツール	説明
download_tweet	X の投稿をダウンロードします（動画、GIF、画像、記事）。メディアの直接 URL、投稿者情報、エンゲージメント統計を返します。/twitter-video-downloader、/twitter-gif-downloader、/twitter-image-downloader、/tweet-downloader に対応しています。
get_x_hashtags	ニッチ（tech、finance、marketing、politics、sports、business、ai、gaming、writing、fitness、design、general）に合わせて厳選した X のハッシュタグと、戦略のヒントを提供します。
get_best_time_to_post_x	国別（12 か国）の X への最適な投稿時間帯と、それぞれの時間帯が適している理由を提供します。
generate_tweet_hook	8 つのカテゴリ（好奇心、論争、権威、リスト、ストーリー、質問、数字、視点の転換）にわたる、実証済みのツイート導入文の型を生成します。
calculate_x_engagement_rate	公開されているフォロワー数ベースの計算式と、階層別のベンチマーク範囲を使用してエンゲージメント率を計算します。
calculate_x_ads_revenue	インプレッション数から Premium クリエイター向け広告収益分配の月間支払額を推定し、資格要件も確認します。
get_x_trends	国別（17 か国）の X のリアルタイムトレンドトピックを提供します。およそ 1 時間ごとに更新されます。
count_tweet_characters	X 独自の文字数カウント（CJK ×2、絵文字 ×2、URL は t.co 換算で ×23）を行い、スレッド分割が必要な場合は警告します。
split_long_text_into_thread	長文を、文や単語の区切りと t.co URL の文字数計算を考慮しながら、番号付きの 280 文字以下のツイートに分割します。
build_x_search_url	構造化されたフィルター（from:、since:、min_faves:、lang:、filter:media など）から X の高度な検索 URL を作成します。
generate_fancy_unicode_text	ASCII を装飾 Unicode（太字、斜体、等幅、スクリプト体、二重取り消し線、小型大文字、太字斜体）に変換し、プロフィールやツイートに使えるようにします。
get_tweet_screenshot_url	テーマと背景のプリセットを設定した状態で、XTapDown のスクリーンショットツールへのディープリンクを作成します（PNG のレンダリングはブラウザー上でクライアント側処理として行われます）。
find_viral_tweets_for_niche	ニッチ分野のトップクリエイターと、それぞれが効果を発揮する理由の解説付きで、バズったツイートのテンプレートを 3 つ提供します。
get_x_search_operators_cheatsheet	カテゴリ別にまとめた X 高度な検索演算子の完全なリファレンスです。2026 年版に更新されています。

インストール

Claude Desktop

claude_desktop_config.json に追加します：

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

Cursor / Cline / Continue

次の場所を指定する stdio MCP サーバーのエントリを追加します：

npx -y xtapdown-mcp

ソースからインストール

git clone https://github.com/farukkolip/xtapdown-mcp
cd xtapdown-mcp
npm install
npm run build
node dist/index.js

ホスト型（HTTP）

PORT=3000（または任意のポート）を設定すると、HTTP / SSE モードでサーバーが起動し、Smithery 形式のホスト型デプロイに対応します。エンドポイントは POST /mcp と GET /mcp で、MCP Streamable HTTP トランスポート仕様に準拠しています。

使用例

「このツイートをダウンロードしてください：https://x.com/.../status/...」 → download_tweet が MP4 の直接 URL、サムネイル、投稿者のハンドル、いいね数を返します。

「オーディエンスが Türkiye にいる場合、X への投稿に最適な時間はいつですか？」 → get_best_time_to_post_x が TRT の日ごとの時間帯を返します。

「フォロワーが 5 万人のアカウントで、いいねが 1,200 件、リポストが 80 件、返信が 150 件ありました。エンゲージメント率はいくつですか？」 → calculate_x_engagement_rate が 2.86%（良好 — 中位層）を返します。

「月に 800 万インプレッションを獲得しています。広告収益分配の対象になりますか？」 → calculate_x_ads_revenue は、予測値が 2,400 万／基準の 2,500 万に届かないため、まだ対象外と返します。基準を超えた場合の推定支払額は月額約 60 ドルです。

MCP を選ぶ理由

X の API は、クリエイターに対して大部分が閉ざされています。ほとんどのサードパーティ製ツールは有料サブスクリプションが必要か、非公開のレート制限を設けてスクレイピングしています。このサーバーは、X 独自の公開シンジケーションエンドポイント（埋め込みウィジェットで使われているものと同じもの）と、厳選したインラインコンテンツデータを使用するため、オフラインを気にせず、認証も上限も予想外のこともなく動作します。

MCP クライアントに追加すると、LLM はツイートデータを自律的に取得し、XTapDown のリサーチデータを、コンテンツの下書き、ソーシャル監査、戦略スレッド、収益化の計算など、取り組んでいることに適用できます。

設計上の境界

このサーバーは設計上、読み取り専用です。書き込みツールもアカウントもトークンも OAuth もありません。各ツールは、X のシンジケーションエンドポイントを通じて公開データを読み取るか、ローカルで計算を行います。テキストを生成する 2 つのツール（generate_tweet_hook、split_long_text_into_thread）は、呼び出し元にテキストを返します。投稿は別のツールで人間が行う、独立した操作です。承認ゲートは構造上のものであり、投稿ツールが存在しないこと自体がその役割を果たします。フラグではありません。

失敗時にモデルが受け取る情報（1.3.0 以降）：

• 呼び出しが失敗すると、すべて isError: true が設定されるため、テキスト内の絵文字をパターンマッチングするのではなく、モデルは失敗時の分岐処理を行えます。
• ネットワーク呼び出しは 15 s でタイムアウトし、接続失敗とは区別してタイムアウトとして報告されます。
• 上流からの HTTP 429 は、ステータスコードだけではなく、「レート制限中です。N 秒お待ちください」 として返されます（Retry-After がある場合はその値に基づきます）。
• 保護されたアカウント（403）と削除された投稿（404）は、別々の状況として報告されます。

このサーバーが行わないこと：上流に独自のレート制限を追加することはありません。誰かのデータを対象にした読み取りツールは、今でも公開データの一括収集に使えます。唯一の防御策は、X がすでに誰にでも提供しているデータだけを読み取ることです。

データソース

• ツイートデータ： cdn.syndication.twimg.com/tweet-result（公開、認証不要）
• ハッシュタグ／最適な投稿時間／フック／ベンチマーク： XTapDown の編集ライブラリ、2026 年更新
• エンゲージメント計算： フォロワー数に基づく公開計算式 (likes + reposts + replies + bookmarks + quotes) / followers × 100
• 広告収益の計算： X Premium Creator Ads Revenue Sharing の公開条件（25M imp/3mo + 500 verified followers + Premium）

関連リンク

• tiktapdown-mcp — TikTok 版
• xtapdown.com — 17 個のツールを備えたウェブツールキット

ライセンス

MIT — © Faruk Kolip