x-reader

Give your agent a URL. Let x-reader handle the source.

x-reader is a universal content reader for AI agents. It reads X/Twitter, articles, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram, RSS, and the open web, then normalizes the result into structured source content for downstream research, summarization, and automation.

Its differentiator is evidence-aware reading: a search snippet is not the source, a tweet caption is not the attached video, and a video description is not a transcript. When a material source layer is still missing, x-reader keeps that gap explicit instead of pretending the read is complete.

简体中文： README.zh-CN.md · Website: xreader.leolabs.me · Try it in the browser

Set up in one step

Paste this into your AI agent (Claude Code, Codex, Cursor, …):

Set up x-reader on this computer by following the official instructions at https://github.com/runesleo/x-reader/blob/main/install.md.

Your agent installs the skill and the CLI, runs the read-only x-reader doctor self-check, and reads a first link with you. The steps it follows are in install.md; to do it by hand, see below.

Evidence Receipt web utility

The public beta is live for public X, YouTube, and generic web URLs: Product · 中文 · Open app. Paste a URL and it returns the same canonical evidence states used by x-reader: PASS, PARTIAL, FAIL, or UNKNOWN. Results can be copied as a human-readable receipt or JSON, and shared without upgrading missing evidence into success.

Run it locally with x-reader-web, or use the hosted beta above. See Evidence Receipt, the distribution plan, and the public-beta gate.

Install the Agent Skill

npx skills add runesleo/x-reader --skill x-reader

Then give your agent a URL and ask it to read the original source. For example:

Read the original source. If it contains attached video/audio that matters to the answer, consume that too. Tell me what you actually read and what is still missing.

The canonical skill uses an explicit evidence contract:

PASS     original source + all material media needed for the answer were read
PARTIAL  some material layer is still missing
FAIL     the original source could not be fetched reliably
UNKNOWN  retrieved material is too ambiguous to verify

Evidence Receipt web preview (experimental)

Run the same evidence contract through a small local web surface:

pip install -e .
x-reader-web --host 127.0.0.1 --port 8787

The current hosted-MVP policy accepts public X/Twitter, YouTube, and generic web URLs only. It uses a fresh temporary HOME/inbox per request and does not inherit saved browser sessions, Telegram credentials, Groq keys, Obsidian/output paths, or external X cookies.

The web layer does not add a second reader or evidence state machine: it invokes the existing x-reader URL --json path in the isolated environment and projects the result into PASS / PARTIAL / FAIL / UNKNOWN.

See Evidence Receipt for API examples, the isolation boundary, and the mixed-media receipt contract.

v0.3.1: verified before / after