Repolode
runesleo

runesleo/x-reader

X、YouTube、ポッドキャスト、WeChatなどのURLから、エビデンス評価付きの構造化テキストをAIエージェントに提供する汎用コンテンツリーダーMCPサーバー。

スター
988
フォーク
97
未解決の Issue
3
最終コミット
5 日前

これは何?

x-readerはURLを、AIエージェントが調査、要約、自動化に利用できる形式に整えたコンテンツへ変換します。X/Twitter、Web記事、YouTube、Bilibili、ポッドキャスト、WeChat、小紅書(Xiaohongshu)、Telegram、RSSに対応し、CLI、Pythonライブラリ、MCPサーバー、Agent Skillとして利用できます。

読み取り結果には、エビデンスの状態としてPASS、PARTIAL、FAIL、UNKNOWNのいずれかが付与されます。添付された動画や音声を取得していない場合や、ポッドキャストから番組の概要欄しか取得できない場合は、全体を網羅したとせず、結果はPARTIALのままです。取得したコンテンツは信頼できないデータとして扱い、プライベートアドレスやローカルアドレスを指すURLはネットワークへのアクセス前にブロックします。

このプロジェクトには、公開されているX、YouTube、一般的なWeb URLを確認できるシンプルなWebプレビューと、どの読み取り経路が利用可能かを報告する`doctor`コマンドが含まれています。Telegram、Groq Whisperによる文字起こし、ログイン済みのブラウザーセッションなど、一部の機能には認証情報やローカル環境での設定が必要です。

主な機能

  • 01X/Twitter、YouTube、Bilibili、ポッドキャスト、WeChat、小紅書(Xiaohongshu)、Telegram、RSS、Webページを読み取ります。
  • 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のワークフローに複数プラットフォームのコンテンツ読み取りを追加する。
  • 調査パイプライン向けに、SNSや動画ソースから構造化テキストを収集する。

クイックスタート

  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など一部のプラットフォームでは、ブラウザーでの代替利用に追加のインストールと初回ログインが必要です。
  • Telegramの読み取りには、ご自身のTelegram認証情報が必要です。
  • ポッドキャストやYouTubeの音声を全文文字起こしするには、Groqなどの任意のツールまたはAPIキーが必要です。

収録されている特集

トピック

よくある質問

x-reader とは?
X、YouTube、ポッドキャスト、WeChatなどのURLから、エビデンス評価付きの構造化テキストをAIエージェントに提供する汎用コンテンツリーダーMCPサーバー。 x-readerはURLを、AIエージェントが調査、要約、自動化に利用できる形式に整えたコンテンツへ変換します。X/Twitter、Web記事、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のワークフローに複数プラットフォームのコンテンツ読み取りを追加する。 調査パイプライン向けに、SNSや動画ソースから構造化テキストを収集する。
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 の数値は毎日更新されます。

関連プロジェクト