runesleo/x-reader

What it solves

x-reader is a universal content reader designed to fetch, transcribe, and digest content from a wide variety of platforms. It solves the problem of fragmented content consumption by providing a unified output format regardless of whether the source is an article, a video, a podcast, or a social media post.

How it works

The project is structured into three composable layers:

1. Python CLI/Library: The core engine that handles platform detection and content fetching. It uses a variety of fetchers (such as Jina Reader, Playwright for anti-scraping, and specific APIs for Bilibili and Telegram) to extract text and metadata.
2. Claude Code Skills: Optional extensions that add advanced capabilities, such as full video and podcast transcription using Whisper (via Groq) and AI-powered content analysis to generate structured reports.
3. MCP Server: An optional layer that exposes the reader's functionality as Model Context Protocol (MCP) tools, allowing AI agents like Claude to read URLs and manage an inbox of fetched content.

Who it’s for

Users who consume content across multiple platforms (YouTube, Bilibili, X/Twitter, WeChat, Xiaohongshu, Telegram, RSS) and want a centralized way to capture and analyze this information using AI tools or a local CLI.

Highlights

• Multi-platform Support: Supports 7+ platforms including YouTube, Bilibili, X, WeChat, and Telegram.
• Unified Schema: Converts diverse content types into a consistent structured format.
• Transcription: Integrates Whisper for audio/video transcription of podcasts and videos.
• Flexible Integration: Can be used as a standalone CLI, a Python library, or an MCP server for AI agents.
• Browser Fallback: Uses Playwright to handle login-required or anti-scraping content on platforms like XHS and WeChat.