runesleo/x-reader

x‑reader とは？

x‑reader は、Python ベースの Agent Skill およびコマンドラインツールで、URL の背後にある実際のコンテンツを取得します。検索エンジンやソーシャルメディアプラットフォームが表示するプレビューだけではありません。X/Twitter、YouTube、ポッドキャスト、WeChat、RSS など、多くのオンラインソースに対応し、AI エージェントに対して、完全なソースが読まれたか、部分的にしか読まれなかったか、または取得できなかったかを通知します。

仕組み

URL → プラットフォーム固有のフェッチャー – サポートされている各サイトには、正規のソースを取得する方法を知っている小さなモジュール（例：twitter.py、youtube.py）があります。oEmbed によるツイートテキスト、yt‑dlp による YouTube トランスクリプト、Bilibili の字幕などです。
エビデンス契約 – フェッチ後、ツールは次の 4 つのステータスのいずれかを返します。
- PASS – 回答に必要なすべてが読まれた。
- PARTIAL – 一部のメディアレイヤー（ビデオ、オーディオ、字幕）が欠落している。
- FAIL – ページを確実に取得できなかった。
- UNKNOWN – 取得したマテリアルが曖昧である。
CLI / JSON 出力 – x-reader <url> は短い人間が読める要約を出力します。--json を追加すると、AI エージェントが消費できる機械可読なペイロードが得られます。
オプションの MCP サーバー – 軽量 HTTP サーバー（mcp_server.py）は、同じ機能（read_url、detect_platform など）を公開するため、Claude Code などのエージェントがツールをリモートで呼び出すことができます。

「ソースファースト」が重要な理由

エージェントは、検索スニペットやツイートのキャプションを引用して質問に答えることがよくありますが、これらは重要なメディア（ビデオ、字幕、ペイウォール付きテキスト）を省略する可能性があります。x‑reader はそのギャップを明確にし、幻覚を防ぎ、利用可能なエビデンスをユーザーに正確に知らせます。

主な機能（README に記載されているとおり）

機能	説明
マルチプラットフォーム対応	X/Twitter、YouTube、Bilibili、WeChat、小红书、Telegram、RSS、一般的な Web 記事、Apple Podcasts など。
メディア処理	添付されたビデオ、字幕を取得し、Groq Whisper（`whisper‑large‑v3`）でオーディオを文字起こしできます。
CLI	`x-reader <url>` でクイックチェック。`x-reader doctor` でセルフテスト。`--json` で構造化出力。
Agent Skill	`npx skills add runesleo/x-reader --skill x-reader` でインストール可能。スキルはインストールせずに一覧表示できます。
MCP サーバー	リモート呼び出し用のオプションの FastMCP 互換サーバー（`x-reader-mcp`）。
セキュリティモデル	取得したすべてのデータを信頼できないものとして扱い、実行せず、明示的にオプトインしない限り Cookie を分離します。
拡張可能な Python ライブラリ	プログラムでの使用のための `UniversalReader` クラス（`await reader.read(url)`）。
エビデンス契約	各フェッチの明示的な `PASS / PARTIAL / FAIL / UNKNOWN` ステータス。

誰が使うのか？

AI エージェント開発者 – モデルが回答する前に実際に元のソースを参照したことを証明する信頼できる方法を必要とする人。
研究者 – どのメディアレイヤーが消費されたかを追跡する必要がある検索拡張生成パイプラインを構築する人。
パワーユーザー – ツイート、ビデオ、記事の完全なコンテンツをダウンロードして検証する CLI を望む人。

インストールスナップショット

# リポジトリから CLI を直接インストール
pip install "x-reader @ git+https://github.com/runesleo/x-reader.git"
# オプションのブラウザフォールバック（Playwright）とメディアツール
pip install "x-reader[browser] @ git+https://github.com/runesleo/x-reader.git"
playwright install chromium

ライセンス

MIT – 個人および商用利用は無料です。

上記の詳細はすべてリポジトリの README から直接取得したものであり、追加の機能は推測されていません。