← 返回目录
X

X Reader MCP Server

社区
通用内容阅读器:从任意URL获取结构化内容(文章、视频、播客、推文等)。
GitHub 源仓库 ↗
★ 955 Stars 分类 · 其他 非常热门 源版本 6085af9568f1
50FMRS · D
可靠性
6/20
安全与权限
8/20
维护活跃度
12/20
文档质量
14/20
安装易用性
10/20

该服务器为支持多平台的内容抓取提供了灵活的解决方案,集成简便。然而,它需要较多的可选依赖,且可能涉及登录状态,用户需注意风险。

查看 FMRS 评分方法 →

x-reader 是一个通用的内容读取器,支持从多个平台获取结构化内容。它采用三层架构:Python CLI/库用于基本内容抓取,Claude Code技能用于视频转录和AI分析,以及通过MCP服务器暴露为MCP工具。该服务器提供四个工具:read_url(获取任意URL)、read_batch(并发获取多个URL)、list_inbox(查看已获取内容)、detect_platform(识别URL平台)。支持平台包括YouTube、Bilibili、X/Twitter、微信公众号、小红书、Telegram、RSS、小宇宙、Apple播客等。对于视频,可使用yt-dlp字幕或Whisper转录;对于受限内容,使用Playwright浏览器回退。该项目使用MIT许可证。

工具能力

read_url
获取任意URL的内容,返回统一结构化格式。
read_batch
并发获取多个URL的内容。
list_inbox
查看之前获取的内容列表。
detect_platform
识别给定URL所属的平台。

安装接入

  1. 克隆仓库:git clone https://github.com/runesleo/x-reader.git
  2. 进入目录:cd x-reader
  3. 安装依赖:pip install -e ".[mcp]"
  4. 启动MCP服务器:python mcp_server.py
  5. 配置Claude Desktop:在配置文件中添加mcpServers,指定命令和参数。
claude_desktop_config.json
{
  "mcpServers": {
    "x-reader": {
      "command": "python",
      "args": ["/path/to/x-reader/mcp_server.py"]
    }
  }
}

选型与风险

适合谁

  • 需要从多种来源提取内容的内容聚合器或AI代理。
  • 希望快速获取社交媒体帖子或文章结构化内容的开发者和研究者。
  • 使用Claude Code的用户,希望基于视频/播客进行AI分析。

不适合谁

  • 需要实时流媒体或实时数据抓取的用户。
  • 希望无需安装额外依赖(如ffmpeg、Playwright)即可使用开箱即用MCP服务器的用户。
  • 需要处理需要登录的网站,且未配置会话保存的用户。

所需权限

  • 读取URL并进行网络请求。
  • 可选:通过x-reader login命令保存浏览器会话,用于访问受限内容。
  • 可选:访问环境变量,如GROQ_API_KEY用于Whisper转录。
  • 可选:写入本地文件(如收件箱JSON、Markdown输出)。

风险与副作用

  • 抓取网站可能违反其服务条款。
  • 保存的浏览器会话可能包含敏感信息;应妥善保护。
  • 外部API(如Groq)使用可能有速率限制或成本。
  • 内容可能受版权保护;请确保合法使用。

常见排障

  1. 1. 确保已安装Python 3.10或更高版本。
  2. 2. 对于视频转录,确保安装ffmpeg并设置GROQ_API_KEY。
  3. 3. 对于Playwright回退,运行playwright install chromium。
  4. 4. 检查网络连接,确保能访问目标URL。
  5. 5. 如果MCP连接失败,确认mcp_server.py路径正确且已安装依赖。

使用场景

从公众号帖子、推文、YouTube视频等提取内容以供分析。
批量获取多个URL的内容。
从YouTube、Bilibili、播客获取转录文本。
将抓取的内容嵌入到Anthropic的Claude Code工作流中。

支持客户端

Claude Desktop完整支持