关于 read-x
read-x 通过公开的 FxTwitter API 获取 X/Twitter 帖子和文章全文,供用户或 Agent 阅读、整理内容;无需 API 凭据或浏览器。
主要功能
- 01获取帖子文本和作者信息
- 02读取嵌入的长篇文章
- 03包含媒体和互动数据
- 04查看回复及帖子上下文
- 05将文章内容整理为 Markdown
适用场景
- 01阅读分享的 X 或 Twitter 帖子
- 02整理 X 长篇文章内容
- 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