mcpField
R
read-x

read-x

github.com/mikeygonz生产力56 次安装
代码仓库

关于 read-x

read-x 通过公开的 FxTwitter API 获取 X/Twitter 帖子和文章全文,供用户或 Agent 阅读、整理内容;无需 API 凭据或浏览器。

主要功能

  1. 01获取帖子文本和作者信息
  2. 02读取嵌入的长篇文章
  3. 03包含媒体和互动数据
  4. 04查看回复及帖子上下文
  5. 05将文章内容整理为 Markdown

适用场景

  1. 01阅读分享的 X 或 Twitter 帖子
  2. 02整理 X 长篇文章内容
  3. 03查看媒体和互动数据

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mikeygonz/skills --skill read-x

安装后在 Claude Code 中输入/read-x确认已加载。

详细介绍

读取 X

获取 X/Twitter 帖子和文章的完整内容——无需 API 密钥、身份验证或浏览器。

工作原理

使用 FxTwitter API——一个公开、无需身份验证的 API,可返回完整的推文 JSON,包括嵌入的文章、媒体和互动数据。

端点

https://api.fxtwitter.com/{username}/status/{tweet_id}

适用场景

  • 用户分享了 x.com 或 twitter.com URL
  • 用户要求阅读或总结 X 帖子或文章
  • 用户分享了帖子串或 X 长文

不适用场景

  • 用户只是想在 X 上发帖或回复(此工具仅支持读取)
  • URL 不是帖子(例如,x.com/username 个人资料页面)

如何获取

对 fxtwitter URL 使用 web_fetch:

web_fetch: https://api.fxtwitter.com/{username}/status/{tweet_id}
从 URL 中提取信息

给定:https://x.com/elonmusk/status/1234567890

  • username:elonmusk
  • tweet_id:1234567890
  • API URL:https://api.fxtwitter.com/elonmusk/status/1234567890

响应结构

API 返回的 JSON 包含:

  • tweet.text — 推文文本
  • tweet.author — 作者信息(姓名、用户名、关注者数量、简介)
  • tweet.likes、tweet.retweets、tweet.views — 互动数据
  • tweet.article — 完整的长文内容(如果存在)
    • tweet.article.title — 文章标题
    • tweet.article.content.blocks[] — 文章正文(基于区块,类似 Draft.js)
      • 每个区块包含 text、type(unstyled、header-two、blockquote、atomic)和 inlineStyleRanges(Bold、Italic)
  • tweet.media — 附加的图片/视频
  • tweet.replying_to — 如果是回复,则显示回复对象

渲染文章

当 tweet.article 存在时,将其渲染为整洁的 Markdown:

  • header-two → ## 标题
  • blockquote → > 引用
  • Bold 内联样式 → **粗体**
  • Italic 内联样式 → *斜体*
  • 带有 DIVIDER 实体的 atomic → ---
  • entityMap 中的链接 → [文本](url)

限制

  • 仅支持读取(不能发帖、点赞或回复)
  • 部分推文可能无法访问(已删除或来自受保护的账号)
  • 存在速率限制,但日常使用通常不会触及
  • 帖子串:每条推文都需要单独请求(沿着 replying_to 链查找)

评论

支持 Markdown