Twitter Reader

Twitter/X のポストと記事コンテンツを完全なメディアサポート付きで取得します。

クイックスタート（推奨）

X Articles 画像付きの場合は、新しい fetch_article.py スクリプトを使用してください：

uv run --with pyyaml python scripts/fetch_article.py <article_url> [output_dir]

例：

uv run --with pyyaml python scripts/fetch_article.py \
  https://x.com/HiTw93/status/2040047268221608281 \
  ./Clippings

以下を実行します：

• twitter-cli 経由で構造化データを取得（いいね、リツイート、ブックマーク）
• jina.ai API 経由でコンテンツと画像を取得
• すべての画像を attachments/YYYY-MM-DD-AUTHOR-TITLE/ にダウンロード
• 埋め込み画像参照を含む完全な Markdown を生成
• メタデータを含む YAML frontmatter を追加

出力例

Fetching: https://x.com/HiTw93/status/2040047268221608281
--------------------------------------------------
Getting metadata...
Title: 你不知道的大模型训练：原理、路径与新实践
Author: Tw93
Likes: 1648

Getting content and images...
Images: 15

Downloading 15 images...
  ✓ 01-image.jpg
  ✓ 02-image.jpg
  ...

✓ Saved: ./Clippings/2026-04-03-文章标题.md
✓ Images: ./Clippings/attachments/2026-04-03-HiTw93-.../ (15 downloaded)

代替方法：Jina API（テキストのみ）

認証なしでシンプルなテキストのみ取得：

# 単一ツイート
curl "https://r.jina.ai/https://x.com/USER/status/TWEET_ID" \
  -H "Authorization: Bearer ${JINA_API_KEY}"

# バッチ取得
scripts/fetch_tweets.sh url1 url2 url3

機能

フルアーティクルモード（fetch_article.py）

• ✅ 構造化メタデータ（著者、日付、エンゲージメント指標）
• ✅ 自動画像ダウンロード（すべての埋め込みメディア）
• ✅ ローカル画像参照付きの完全な Markdown
• ✅ PKM システム用 YAML frontmatter
• ✅ X Articles（長文コンテンツ）に対応

シンプルモード（Jina API）

• テキストのみのコンテンツ
• Jina API キー以外の認証は不要
• テキスト抽出に便利

前提条件

フルアーティクルモード用

• uv（Python パッケージマネージャー）
• 追加セットアップなし（twitter-cli は自動インストール）

シンプルモード用（Jina）

export JINA_API_KEY="your_api_key_here"
# https://jina.ai/ から取得

出力構造

output_dir/
├── YYYY-MM-DD-article-title.md       # メイン Markdown ファイル
└── attachments/
    └── YYYY-MM-DD-author-title/
        ├── 01-image.jpg
        ├── 02-image.jpg
        └── ...

返却内容

フルアーティクルモード

• YAML Frontmatter: ソース、著者、日付、いいね、リツイート、ブックマーク
• Markdown コンテンツ: ローカル画像参照付きの完全な記事テキスト
• 添付ファイル: 専用フォルダにダウンロードされたすべての画像

シンプルモード

• タイトル: ポスト作成者とコンテンツプレビュー
• URL ソース: 元のツイートリンク
• 公開時刻: GMT タイムスタンプ
• Markdown コンテンツ: リモートメディア URL 付きテキスト

サポート対象の URL フォーマット

• https://x.com/USER/status/ID（ポスト）
• https://x.com/USER/article/ID（長文記事）
• https://twitter.com/USER/status/ID（レガシー）

スクリプト

fetch_article.py

画像ダウンロード機能付きの本格的な記事取得ツール：

uv run --with pyyaml python scripts/fetch_article.py <url> [output_dir]

fetch_tweet.py

Jina API を使用したシンプルなテキストのみ取得ツール：

python scripts/fetch_tweet.py <tweet_url> [output_file]

fetch_tweets.sh

複数のツイートをバッチ取得（Jina API）：

scripts/fetch_tweets.sh <url1> <url2> ...

Jina API からの移行

従来のワークフロー：

curl "https://r.jina.ai/https://x.com/..."
# 手動で画像を抽出してダウンロード

新しいワークフロー：

uv run --with pyyaml python scripts/fetch_article.py <url>
# 自動画像ダウンロード、完全な Markdown