通用内容读取层 · Agent Skill + CLI + MCP

把一个链接,真正读成 AI 能用的内容。

x-reader 是给 AI Agent 用的 Universal Content Reader。你丢给它一个 X、网页、YouTube、B站、播客、微信公众号、小红书、Telegram、RSS 或其他网页链接,它负责识别来源、走正确的读取链路,再把内容统一整理成 Agent 可以继续研究、总结和自动化处理的结构化结果。

一个 Reader,处理不同来源

不要让每个 Agent 都自己再拼一套 scraper。

Agent 只需要把 URL 交给 x-reader。平台识别、不同 fetcher、fallback、结构化输出这些脏活由 reader 层处理,上层拿到的是统一的内容对象,而不是一堆平台特例。

X / Twitter网页文章YouTubeBilibili播客微信公众号小红书TelegramRSS开放网页
核心数据链
1 · 输入URL
2 · 识别与读取platform fetcher
3 · 统一结构UnifiedContent
4 · 交给上层Agent / JSON / MCP

如果视频或音频对任务很重要,读取链可以继续进入字幕、transcript 或本地媒体工具,而不是只拿页面简介冒充媒体内容。

产品本体

先把来源读出来,再谈证据覆盖。

Evidence Receipt 是 reader 上面的可信度机制,不是 x-reader 本身的定义。x-reader 的第一职责,是把不同平台的原始来源真正变成 Agent 可消费的内容。

01
读取原始来源

针对不同平台走不同读取链和 fallback,把 URL 变成实际正文、metadata 或媒体内容。

02
统一成 Agent 可用结构

标题、URL、来源类型、正文和相关 metadata 被整理成统一 payload,而不是让上层自己适配每个平台。

03
需要时继续读媒体

视频、音频如果影响结论,就继续进入字幕、transcript 或转录链,而不是停在 caption / description。

Evidence-aware 是护栏

它还会告诉 Agent:这次到底读完整没有。

这层能力负责防止搜索摘要冒充原文、推文正文冒充附件视频、视频简介冒充口头内容。它增强 reader 的可信度,但不是把 x-reader 变成一个“AI 查错工具”。

PASS任务真正需要的来源层已经读取。
PARTIAL已经拿到有用内容,但仍缺会影响结论的关键层。
FAIL无法可靠获取用户要求的原始来源。
UNKNOWN当前材料不足以确认是否覆盖了目标来源。
四种入口,同一个 Reader

网页用来快速试;Skill / CLI / MCP 才是完整 Agent 工作流。

最省事 · 交给你的 AI 安装

把这句话粘给 Claude Code、Codex 或 Cursor:

按照 https://github.com/runesleo/x-reader/blob/main/install.md 的官方说明,在这台电脑上安装 x-reader。
  1. 复制上面这句话
  2. 粘给你正在用的 AI
  3. 它会装好、跑一遍只读自检 x-reader doctor,再陪你读第一个链接;需要登录或密钥的步骤,它会告诉你怎么自己完成
Hosted 子集网页工具

当前公开版只处理公开 X、YouTube 和普通网页。零安装,适合直接试读和查看 Evidence Receipt。

打开网页版 →
最适合 AgentAgent Skill

当 Agent 收到链接,需要原始内容、transcript、证据或基于来源继续分析时,直接调用 x-reader。

npx skills add runesleo/x-reader --skill x-reader
脚本 / PipelineCLI

单 URL 或批量读取,完整结构化 JSON 输出,方便接自动化。

x-reader URL --json
Agent ToolchainMCP

把 read_url、read_batch、list_inbox、detect_platform 直接暴露成 Agent 工具。

MCP 配置 →
完整 x-reader

不等于这个 Hosted 网页。

完整的本地 / Agent 版本还能处理需要平台 API、浏览器 fallback、本地登录态、字幕或转录的来源。公网 Hosted Beta 为了安全,只开放无需身份的子集。

URL → 平台识别 → fetch / fallback → 必要时补媒体 → UnifiedContent → Agent
它不是什么

不是另一个摘要器,也不只是“检查 AI 有没有撒谎”。

摘要和分析发生在读取之后;Evidence 状态只是告诉上层这次读取到哪。真正可复用的产品资产,是前面那层跨平台 source ingestion / universal reader。

它不做什么

只读、不越界、读不到就直说。

  • 只读。不发帖、不点赞,也不替你登录任何账号。
  • 不编。搜索摘要不当原文,没读到的视频不替它编内容——缺什么就标 PARTIAL 或 FAIL。
  • 密钥你说了算。本地版的 cookie 和密钥存在你自己的电脑上,只有你明确开启后才会发给对应服务(比如转写用的 Groq);网页版只读公开链接,不需要登录。
  • 网页版使用统计隐私。若启用统计,只按天保留最多 90 天的页面请求数、读取状态聚合;不在这些计数中保存提交链接、IP、Cookie 或来源正文。
  • 不听网页的话。读到的网页、推文、字幕都只当资料,不会被当成给 AI 的指令。
最简单的理解方式

给 Agent 一个 URL,剩下的来源读取交给 x-reader。

跨平台一个入口,输出 Agent 能继续使用的结构化内容;缺什么,再明确告诉上层缺什么。