Repolode
runesleo

runesleo/x-reader

面向 AI 智能体的通用内容阅读器,可把 X、YouTube、播客、微信等链接转为结构化内容。

Star
988
Fork
97
未关闭 Issue
3
最近提交
4天前

这是什么?

x-reader 可以把一个链接转换为标准化的原始内容,供 AI 智能体用于调研、摘要和自动化处理。支持的来源包括 X/Twitter、网页文章、YouTube、哔哩哔哩、播客、微信公众号、小红书、Telegram 和 RSS,使用方式有命令行、Python 库、MCP 服务和 Agent Skill 四种。

每次阅读都会标注证据状态:PASS、PARTIAL、FAIL 或 UNKNOWN。如果附带的视频或音频没有被读取,或播客只拿到节目简介,结果会标为 PARTIAL,不会假装已完整阅读。抓取到的内容被视为不可信数据,指向内网或本地地址的 URL 会在请求前被拦截。

项目还提供面向公开 X、YouTube 和通用网页链接的轻量网页预览,以及可报告各读取通道就绪状态的 doctor 命令。Telegram、Groq Whisper 转写和登录态浏览器等功能需要额外的凭据或本地配置。

核心功能

  • 01支持读取 X/Twitter、YouTube、哔哩哔哩、播客、微信公众号、小红书、Telegram、RSS 和网页。
  • 02每次读取都标注 PASS、PARTIAL、FAIL 或 UNKNOWN 证据状态。
  • 03提供 MCP 服务,包含 read_url、read_batch、list_inbox 和 detect_platform 工具。
  • 04命令行支持 JSON 输出,方便智能体调用,也提供 Python 库接口。
  • 05可通过 npx skills 安装 Agent Skill。
  • 06抓取前会拦截指向内网和本地地址的 URL。

适用场景

  • 让 AI 助手读取一个链接并总结原始帖子、视频或文章。
  • 核实摘要是否覆盖了附带视频或播客音频,而不只是帖子文字。
  • 通过 MCP 为 Claude Code、Cursor 或 Codex 工作流增加多平台内容读取能力。
  • 为研究流程从社交和视频来源收集结构化文本。

快速上手

  1. 1

    从 GitHub 安装命令行工具

    pip install "x-reader @ git+https://github.com/runesleo/x-reader.git"
  2. 2

    读取一个链接

    x-reader https://x.com/elonmusk/status/123456
  3. 3

    检查哪些已就绪、哪些缺失

    x-reader doctor

使用前须知

  • 部分平台的浏览器回退需要额外安装,小红书等平台可能需要一次性本地登录。
  • 读取 Telegram 需要你自己的 Telegram 凭证。
  • 完整的播客和 YouTube 音频转写需要可选工具或 Groq 等 API 密钥。

收录于专题

标签

常见问题

x-reader 是什么?
面向 AI 智能体的通用内容阅读器,可把 X、YouTube、播客、微信等链接转为结构化内容。 x-reader 可以把一个链接转换为标准化的原始内容,供 AI 智能体用于调研、摘要和自动化处理。支持的来源包括 X/Twitter、网页文章、YouTube、哔哩哔哩、播客、微信公众号、小红书、Telegram 和 RSS,使用方式有命令行、Python 库、MCP 服务和 Agent Skill 四种。
x-reader 可以免费使用吗?用的什么许可证?
x-reader 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
x-reader 还在维护吗?
活跃维护中。x-reader 最近一次提交是在 2026年11月3日。
x-reader 适合用来做什么?
让 AI 助手读取一个链接并总结原始帖子、视频或文章。 核实摘要是否覆盖了附带视频或播客音频,而不只是帖子文字。 通过 MCP 为 Claude Code、Cursor 或 Codex 工作流增加多平台内容读取能力。 为研究流程从社交和视频来源收集结构化文本。
x-reader 怎么安装和运行?
从 GitHub 安装命令行工具: pip install "x-reader @ git+https://github.com/runesleo/x-reader.git" 读取一个链接: x-reader https://x.com/elonmusk/status/123456 检查哪些已就绪、哪些缺失: x-reader doctor
在哪里获取 x-reader?
源代码和安装说明在 GitHub 上:https://github.com/runesleo/x-reader

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目