Repolode
제출하기
runesleo

runesleo/x-reader

AI 에이전트에 X, YouTube, 팟캐스트, WeChat 등 URL의 구조화된 텍스트와 근거 수준을 제공하는 범용 콘텐츠 리더 MCP 서버입니다.

GitHub에서 보기웹사이트
스타
988
포크
97
열린 이슈
3
마지막 커밋
3일 전

어떤 프로젝트인가요?

x-reader는 URL을 AI 에이전트가 조사, 요약, 자동화에 활용할 수 있는 정규화된 원본 콘텐츠로 변환합니다. X/Twitter, 웹 기사, YouTube, Bilibili, 팟캐스트, WeChat, Xiaohongshu, Telegram, RSS를 지원하며 CLI, Python 라이브러리, MCP 서버 또는 Agent Skill로 사용할 수 있습니다.

각 읽기 결과에는 근거 상태인 PASS, PARTIAL, FAIL 또는 UNKNOWN이 표시됩니다. 첨부된 동영상이나 오디오를 처리하지 않았거나 팟캐스트에서 프로그램 노트만 가져온 경우, 전체 내용을 다룬 것처럼 표시하지 않고 PARTIAL 상태를 유지합니다. 가져온 콘텐츠는 신뢰할 수 없는 데이터로 취급하며, 네트워크 요청 전에 비공개 또는 로컬 주소를 대상으로 하는 URL을 차단합니다.

이 프로젝트에는 공개 X, YouTube 및 일반 웹 URL을 위한 간단한 웹 미리보기와, 어떤 읽기 경로를 사용할 수 있는지 알려주는 `doctor` 명령어가 포함되어 있습니다. Telegram, Groq Whisper 전사, 로그인된 브라우저 세션과 같은 일부 기능을 사용하려면 자격 증명이나 로컬 설정이 필요합니다.

핵심 기능

  • 01X/Twitter, YouTube, Bilibili, 팟캐스트, WeChat, Xiaohongshu, Telegram, RSS 및 웹 페이지를 읽습니다.
  • 02모든 읽기 결과에 PASS, PARTIAL, FAIL 또는 UNKNOWN 근거 상태를 표시합니다.
  • 03read_url, read_batch, list_inbox, detect_platform 도구를 갖춘 MCP 서버를 제공합니다.
  • 04에이전트용 JSON 출력을 지원하는 CLI와 Python 라이브러리 인터페이스를 제공합니다.
  • 05npx skills로 설치할 수 있는 Agent Skill을 제공합니다.
  • 06가져오기 전에 비공개 및 로컬 URL 대상을 차단합니다.

활용 사례

  • AI 어시스턴트에 링크를 전달해 원본 게시물, 동영상 또는 기사를 요약하게 합니다.
  • 요약이 게시물 텍스트뿐 아니라 첨부된 동영상이나 팟캐스트 오디오까지 다루는지 확인합니다.
  • MCP를 통해 Claude Code, Cursor 또는 Codex 워크플로에 여러 플랫폼의 콘텐츠 읽기 기능을 추가합니다.
  • 조사 파이프라인을 위해 소셜 미디어와 동영상 소스에서 구조화된 텍스트를 수집합니다.

빠른 시작

  1. 1

    GitHub에서 CLI 설치하기

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

    URL 읽기

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

    사용 가능한 항목과 누락된 항목 확인하기

    x-reader doctor

사용 전 알아둘 점

  • Xiaohongshu와 같은 일부 플랫폼에서는 브라우저 대체 기능을 사용하려면 추가 설치와 최초 1회 로그인이 필요합니다.
  • Telegram을 읽으려면 본인의 Telegram 인증 정보가 필요합니다.
  • 팟캐스트 및 YouTube 오디오 전체를 받아쓰려면 Groq와 같은 선택적 도구나 API 키가 필요합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱MCP 서버

토픽

#mcp#ai-agents#content-extraction#web-scraping#youtube#twitter#python#mcp-server

자주 묻는 질문

x-reader은(는) 무엇인가요?
AI 에이전트에 X, YouTube, 팟캐스트, WeChat 등 URL의 구조화된 텍스트와 근거 수준을 제공하는 범용 콘텐츠 리더 MCP 서버입니다. x-reader는 URL을 AI 에이전트가 조사, 요약, 자동화에 활용할 수 있는 정규화된 원본 콘텐츠로 변환합니다. X/Twitter, 웹 기사, YouTube, Bilibili, 팟캐스트, WeChat, Xiaohongshu, Telegram, RSS를 지원하며 CLI, Python 라이브러리, MCP 서버 또는 Agent Skill로 사용할 수 있습니다.
x-reader은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
x-reader은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
x-reader은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. x-reader의 마지막 커밋은 2026년 11월 3일입니다.
x-reader은(는) 어디에 사용할 수 있나요?
AI 어시스턴트에 링크를 전달해 원본 게시물, 동영상 또는 기사를 요약하게 합니다. 요약이 게시물 텍스트뿐 아니라 첨부된 동영상이나 팟캐스트 오디오까지 다루는지 확인합니다. MCP를 통해 Claude Code, Cursor 또는 Codex 워크플로에 여러 플랫폼의 콘텐츠 읽기 기능을 추가합니다. 조사 파이프라인을 위해 소셜 미디어와 동영상 소스에서 구조화된 텍스트를 수집합니다.
x-reader는 어떻게 설치하나요?
GitHub에서 CLI 설치하기: pip install "x-reader @ git+https://github.com/runesleo/x-reader.git" URL 읽기: x-reader https://x.com/elonmusk/status/123456 사용 가능한 항목과 누락된 항목 확인하기: x-reader doctor
x-reader은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/runesleo/x-reader

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

deedy5 / ddgs

여러 웹 검색 백엔드를 조회해 텍스트, 이미지, 동영상, 뉴스, 도서 결과를 통합된 형식으로 반환하는 Python 메타검색 라이브러리입니다.

AI·머신러닝#metasearch#web-search#python
3.1천+14 이번 주287PythonMIT업데이트 13일 전