Repolode
runesleo

runesleo/x-reader

Servidor MCP universal de lectura de contenido que ofrece a agentes de IA texto estructurado con niveles de evidencia de X, YouTube, podcasts, WeChat y otras URL.

Estrellas
988
Forks
97
Issues abiertos
3
Último commit
hace 4 días

¿Qué es?

x-reader convierte una URL en contenido de origen normalizado que los agentes de IA pueden usar para investigar, resumir y automatizar tareas. Es compatible con X/Twitter, artículos web, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram y RSS, y puede usarse como CLI, biblioteca de Python, servidor MCP o Agent Skill.

Cada lectura se etiqueta con un estado de evidencia: PASS, PARTIAL, FAIL o UNKNOWN. Si no se procesa el video o audio adjunto, o si de un podcast solo se obtienen las notas del programa, el resultado sigue siendo PARTIAL en lugar de afirmar que la cobertura es completa. El contenido obtenido se trata como datos no confiables, y las URL que apuntan a direcciones privadas o locales se bloquean antes de realizar solicitudes de red.

El proyecto incluye una pequeña vista previa web para URL públicas de X, YouTube y sitios web genéricos, además de un comando `doctor` que informa qué rutas de lectura están listas. Algunas capacidades, como Telegram, la transcripción con Groq Whisper y las sesiones de navegador con inicio de sesión, requieren credenciales o configuración local.

Funciones clave

  • 01Lee X/Twitter, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram, RSS y páginas web.
  • 02Etiqueta cada lectura con los estados de evidencia PASS, PARTIAL, FAIL o UNKNOWN.
  • 03Ofrece un servidor MCP con las herramientas read_url, read_batch, list_inbox y detect_platform.
  • 04Incluye una CLI con salida JSON para agentes, además de una interfaz de biblioteca de Python.
  • 05Incluye un Agent Skill que se puede instalar con npx skills.
  • 06Bloquea los destinos de URL privados y locales antes de obtener su contenido.

Casos de uso

  • Dar un enlace a un asistente de IA para que resuma la publicación, el video o el artículo original.
  • Comprobar si un resumen cubre el video o el audio del podcast adjunto, y no solo el texto de la publicación.
  • Añadir lectura de contenido de varias plataformas a un flujo de trabajo de Claude Code, Cursor o Codex mediante MCP.
  • Recopilar texto estructurado de fuentes sociales y de video para flujos de investigación.

Inicio rápido

  1. 1

    Instala la CLI desde GitHub

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

    Lee una URL

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

    Comprueba qué está disponible y qué falta

    x-reader doctor

Antes de usarlo

  • La alternativa mediante navegador requiere una instalación adicional y un inicio de sesión único en algunas plataformas, como Xiaohongshu.
  • Para leer Telegram necesitas tus propias credenciales de Telegram.
  • La transcripción completa del audio de podcasts y YouTube requiere herramientas opcionales o claves de API, como Groq.

En colecciones

Temas

Preguntas frecuentes

¿Qué es x-reader?
Servidor MCP universal de lectura de contenido que ofrece a agentes de IA texto estructurado con niveles de evidencia de X, YouTube, podcasts, WeChat y otras URL. x-reader convierte una URL en contenido de origen normalizado que los agentes de IA pueden usar para investigar, resumir y automatizar tareas. Es compatible con X/Twitter, artículos web, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram y RSS, y puede usarse como CLI, biblioteca de Python, servidor MCP o Agent Skill.
¿x-reader es gratuito? ¿Qué licencia tiene?
x-reader es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿x-reader sigue mantenido?
Mantenimiento activo. El último commit de x-reader fue el 3 nov 2026.
¿Para qué puedo usar x-reader?
Dar un enlace a un asistente de IA para que resuma la publicación, el video o el artículo original. Comprobar si un resumen cubre el video o el audio del podcast adjunto, y no solo el texto de la publicación. Añadir lectura de contenido de varias plataformas a un flujo de trabajo de Claude Code, Cursor o Codex mediante MCP. Recopilar texto estructurado de fuentes sociales y de video para flujos de investigación.
¿Cómo se instala x-reader?
Instala la CLI desde GitHub: pip install "x-reader @ git+https://github.com/runesleo/x-reader.git" Lee una URL: x-reader https://x.com/elonmusk/status/123456 Comprueba qué está disponible y qué falta: x-reader doctor
¿Dónde consigo x-reader?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/runesleo/x-reader

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados