SuperAPI AI 工具集

xtapdown-mcp

XTapDown MCP Server 是一个基于 MCP(模型上下文协议)的只读服务器,为 Claude Desktop、Cursor、Cline、Continue 等任意 LLM 客户端提供 14 个 X(Twitter)创作者工具。它通过 X 公开的 syndication 端点获取推文媒体、作者信息与互动数据,并结合 XTapDown 编辑数据,支持推文媒体下载、最佳发帖时间查询、互动率计算、广告收入资格估算、推文钩子生成与长文本拆分为线程等。无需认证、免费、无配额,可通过 stdio 或 HTTP/SSE 模式接入。

访问官网

工具介绍

XTapDown MCP Server 是一个 MCP(Model Context Protocol)服务器,让任意 LLM 客户端——包括 Claude Desktop、Cursor、Cline、Continue 或自建智能体——直接访问 XTapDown 的 X(Twitter)创作者工具集。其定位是为创作者提供推文媒体下载、标签与发布时间参考、互动数据计算等只读能力。

主要能力

服务器共提供 14 个工具,均为只读、零认证、免费。原文提到,四个下载器(视频、GIF、图片、完整存档)合并为单个 download_tweet,因为它们共用同一个 X syndication 端点。原文列出的示例交互包括:

  • 下载推文:返回直接的 MP4、缩略图、作者 handle、点赞数。
  • 查询最佳发帖时间:例如面向土耳其受众时,返回按天划分的 TRT 时间窗口。
  • 计算互动率:例如 5 万粉丝账号获得 1200 赞、80 次转发、150 条回复,返回 2.86%(Good — Mid tier)。
  • 估算广告收入资格:例如每月 800 万展示量时,返回未达门槛、若跨越门槛约每月 60 美元估算收益。 另外,原文提到两个生成文本的工具:generate_tweet_hook(生成推文钩子)与 split_long_text_into_thread(将长文本拆分为线程),它们只把文本返回给调用方,发帖是另一个工具中由人执行的独立动作。

数据来源

  • 推文数据:cdn.syndication.twimg.com/tweet-result(公开、无需认证)。
  • 标签 / 最佳时间 / 钩子 / 基准数据:XTapDown 编辑库,2026 年更新。
  • 互动率计算:基于公开的粉丝数公式(点赞 + 转发 + 回复 + 书签 + 引用)/ 粉丝数 × 100。
  • 广告收入计算:依据 X Premium Creator Ads Revenue Sharing 的公开条款(3 个月内 2500 万展示量 + 500 名认证粉丝 + Premium)。 原文说明,X 的 API 对创作者基本封闭,多数第三方工具需要付费订阅或带隐性速率限制地抓取;该服务器使用 X 自身公开的 syndication 端点(嵌入组件使用的同一端点)加上内联的编辑内容数据,因此无需认证、无配额。

使用方式

原文给出以下接入信息:

  • 加入 claude_desktop_config.json。
  • 在 Cursor / Cline / Continue 中,添加指向该服务器的 stdio MCP 服务器条目。
  • 设置 PORT=3000(或任意端口)可以 HTTP / SSE 模式启动服务器,用于 Smithery 风格托管部署。端点:POST /mcp 与 GET /mcp,遵循 MCP Streamable HTTP 传输规范。 原文未提供具体的配置文件代码块或安装命令内容。

设计边界

原文强调,该服务器在构造上就是只读的:没有写入工具、没有账号、没有 token、没有 OAuth。每个工具要么通过 X 的 syndication 端点读取公开数据,要么做本地计算。审批门是结构性的——即不存在发帖工具,而不是依靠某个开关。 自 1.3.0 起,失败时模型会得到:

  • 每次失败调用设置 isError: true,模型可以据此分支处理,而不是在文本中匹配表情符号。
  • 网络调用 15 秒后超时,并报告为超时,与连接失败区分开。
  • 上游返回 HTTP 429 时,以“rate limited, wait N seconds”(来自 Retry-After,若存在)返回,而不是裸状态码。
  • 受保护账号(403)与已删除帖子(404)作为不同情况报告。 原文同时说明它不做的事:不会在上游之上再添加自己的速率限制。指向某人账号的读取工具仍可能被用于批量收集公开数据,唯一的防御是它只读取 X 已向任何人提供的内容。

适用场景

适用于内容草稿、社交审计、策略线程、变现计算等工作;加入 MCP 客户端后,LLM 可以自主获取推文数据并应用 XTapDown 的研究数据。

其他信息

原文提到存在 TikTok 对应版本 tiktapdown-mcp;xtapdown.com 是包含 17 个工具的完整网页工具集。许可证为 MIT,版权归 Faruk Kolip。