AI Skills
twitter-reader

twitter-reader

熱門

擷取 Twitter/X 貼文內容，包含完整圖片與元資料的長文章（X Articles）。當 Claude 需要取得推文/文章內容、作者資訊、互動數據及嵌入媒體時使用。支援單篇貼文與 X Articles（長文內容）。自動下載所有圖片至本地附件資料夾，並產生包含正確圖片引用的完整 Markdown。針對附帶圖片的 X Articles，優先推薦使用本工具而非 Jina。

1310星標
212分支
更新於 2026/8/1
獲取技能源代碼

相關技能

network-config-validation24萬omni-resilience7.2萬security-research7萬
SKILL.md
唯讀
名稱
twitter-reader
描述

擷取 Twitter/X 貼文內容，包含完整圖片與元資料的長文章（X Articles）。當 Claude 需要取得推文/文章內容、作者資訊、互動數據及嵌入媒體時使用。支援單篇貼文與 X Articles（長文內容）。自動下載所有圖片至本地附件資料夾，並產生包含正確圖片引用的完整 Markdown。針對附帶圖片的 X Articles，優先推薦使用本工具而非 Jina。

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：來源（source）、作者（author）、日期（date）、按讚數（likes）、轉推數（retweets）、書籤數（bookmarks）
  • 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