XTapDown

XTapDown MCP 服务

一个 MCP（Model Context Protocol）服务，可让任何大模型客户端——Claude Desktop、Cursor、Cline、Continue 或你自己的 Agent——直接使用 XTapDown X（Twitter）创作者工具包。

14 个工具，只读、无需身份验证、免费。

工具（14 个）

全面覆盖 XTapDown 的所有 Web 工具——4 个下载工具（视频、GIF、图片、完整存档）整合为一个 download_tweet，因为它们共用同一个 X 联合接口。

工具	描述
download_tweet	下载任意 X 帖子——视频、GIF、图片或文章。返回媒体直链、作者信息和互动数据。涵盖 /twitter-video-downloader、/twitter-gif-downloader、/twitter-image-downloader 和 /tweet-downloader。
get_x_hashtags	针对特定领域的精选 X 话题标签（科技、金融、营销、政治、体育、商业、AI、游戏、写作、健身、设计、综合），以及策略建议。
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 上的实时热门话题——约每小时更新一次。
count_tweet_characters	按 X 规则计算字符数（CJK ×2、表情符号 ×2、URL ×23 t.co），并在可能需要拆分成串文时发出提醒。
split_long_text_into_thread	将长文本拆分为不超过 280 个字符的编号推文，遵循句子/单词边界，并按 t.co URL 规则计算字符数。
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 直链、缩略图、作者账号名和点赞数。

“如果我的受众在 Türkiye，X 上什么时候发布最好？” → get_best_time_to_post_x 返回按天划分的 TRT 时间段。

“我的账号有 50k 粉丝，获得了 1,200 个赞、80 次转发和 150 条回复。互动率是多少？” → calculate_x_engagement_rate 返回 2.86%（良好——中等档）。

“我每月获得 8M 次展示。能符合广告分成资格吗？” → calculate_x_ads_revenue 返回：预计展示次数为 24M / 25M 门槛，尚未达到资格；若达到门槛，预计收入约为 $60/月。

为什么选择 MCP？

X 的 API 在很大程度上对创作者关闭。大多数第三方工具都需要付费订阅，或是在隐藏的速率限制下抓取数据。此服务使用 X 自己的公开联合分发端点（嵌入式小组件也使用同一端点），并结合内置的精选内容数据，因此无需联网即可工作，无需身份验证、没有配额，也没有意外限制。

将其添加到 MCP 客户端后，大模型便可自主获取推文数据，并将 XTapDown 的研究数据应用于你正在处理的任何事项——内容草稿、社交账号审计、策略串文和变现计算。

设计边界

此服务从设计上就是只读的。它没有写入工具、账号、令牌或 OAuth。每个工具要么通过 X 的联合分发端点读取公开数据，要么执行本地计算。两个生成文本的工具（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 创作者广告收入分成的公开条款（25M imp/3mo + 500 verified followers + Premium）

相关项目

• tiktapdown-mcp — TikTok 同类工具
• xtapdown.com — 包含 17 种工具的完整 Web 工具集

许可证

MIT — © Faruk Kolip