Repolode
runesleo

runesleo/x-reader

Servidor MCP universal de leitura de conteúdo que fornece a agentes de IA textos estruturados e classificados por evidências de X, YouTube, podcasts, WeChat e outras URLs.

Estrelas
988
Forks
97
Issues abertas
3
Último commit
há 5 dias

O que é?

x-reader transforma uma URL em conteúdo de origem normalizado que agentes de IA podem usar em pesquisas, resumos e automações. É compatível com X/Twitter, artigos da web, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram e RSS, e pode ser usado como CLI, biblioteca Python, servidor MCP ou Agent Skill.

Cada leitura recebe um estado de evidência: PASS, PARTIAL, FAIL ou UNKNOWN. Se o vídeo ou áudio anexado não for consumido, ou se um podcast fornecer apenas as notas do programa, o resultado continua como PARTIAL, em vez de alegar cobertura completa. O conteúdo obtido é tratado como dado não confiável, e URLs que apontam para endereços privados ou locais são bloqueadas antes das requisições de rede.

O projeto inclui uma pequena prévia web para URLs públicas de X, YouTube e sites em geral, além de um comando `doctor` que informa quais caminhos de leitura estão prontos. Alguns recursos, como Telegram, transcrição com Groq Whisper e sessões de navegador com login, exigem credenciais ou configuração local.

Recursos principais

  • 01Lê X/Twitter, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram, RSS e páginas da web.
  • 02Classifica cada leitura com os estados de evidência PASS, PARTIAL, FAIL ou UNKNOWN.
  • 03Disponibiliza um servidor MCP com as ferramentas read_url, read_batch, list_inbox e detect_platform.
  • 04Oferece uma CLI com saída JSON para agentes, além de uma interface de biblioteca Python.
  • 05Inclui um Agent Skill que pode ser instalado com npx skills.
  • 06Bloqueia URLs que apontam para destinos privados ou locais antes de buscá-las.

Casos de uso

  • Enviar um link a um assistente de IA para que ele resuma a publicação, o vídeo ou o artigo original.
  • Verificar se um resumo cobre o vídeo ou o áudio do podcast anexado, e não apenas o texto da publicação.
  • Adicionar leitura de conteúdo de várias plataformas a um fluxo de trabalho com Claude Code, Cursor ou Codex por meio de MCP.
  • Coletar textos estruturados de redes sociais e fontes de vídeo para pipelines de pesquisa.

Início rápido

  1. 1

    Instale a CLI pelo GitHub

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

    Leia uma URL

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

    Confira o que está pronto e o que está faltando

    x-reader doctor

Antes de usar

  • A alternativa pelo navegador exige uma instalação adicional e um login único em algumas plataformas, como Xiaohongshu.
  • Para ler o Telegram, você precisa das suas próprias credenciais do Telegram.
  • A transcrição completa de áudio de podcasts e do YouTube requer ferramentas opcionais ou chaves de API, como Groq.

Em coleções

Tópicos

Perguntas frequentes

O que é x-reader?
Servidor MCP universal de leitura de conteúdo que fornece a agentes de IA textos estruturados e classificados por evidências de X, YouTube, podcasts, WeChat e outras URLs. x-reader transforma uma URL em conteúdo de origem normalizado que agentes de IA podem usar em pesquisas, resumos e automações. É compatível com X/Twitter, artigos da web, YouTube, Bilibili, podcasts, WeChat, Xiaohongshu, Telegram e RSS, e pode ser usado como CLI, biblioteca Python, servidor MCP ou Agent Skill.
x-reader é gratuito? Qual é a licença?
x-reader é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
x-reader ainda é mantido?
Manutenção ativa. O último commit de x-reader foi em 3 de nov. de 2026.
Para que posso usar x-reader?
Enviar um link a um assistente de IA para que ele resuma a publicação, o vídeo ou o artigo original. Verificar se um resumo cobre o vídeo ou o áudio do podcast anexado, e não apenas o texto da publicação. Adicionar leitura de conteúdo de várias plataformas a um fluxo de trabalho com Claude Code, Cursor ou Codex por meio de MCP. Coletar textos estruturados de redes sociais e fontes de vídeo para pipelines de pesquisa.
Como instalar x-reader?
Instale a CLI pelo GitHub: pip install "x-reader @ git+https://github.com/runesleo/x-reader.git" Leia uma URL: x-reader https://x.com/elonmusk/status/123456 Confira o que está pronto e o que está faltando: x-reader doctor
Onde consigo x-reader?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/runesleo/x-reader

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados