twitter-reader

Fetch Twitter/X post content including long-form Articles with full images and metadata. Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media. Supports individual posts and X Articles (long-form content). Automatically downloads all images to l

By daymade · 2,814 installs

npx skills add daymade/claude-code-skills --skill twitter-reader

Source repository · Upstream listing

Twitter Reader Fetch Twitter/X post and article content with full media support. Reading a single post's text: fxtwitter first (2026 08 30) For plain post text, prefer the fxtwitter mirror API — login free, key free, works direct, and returns the full note tweet body in tweet.text (the full text key does not exist; a 2,324 char long form announcement came back complete): replies is a count, not the reply thread. For X Articles with images, use fetch article.py below — fxtwitter does not carry article bodies. Quick Start (Recommended) For X Articles with images, use the new fetch article.py script: Example: This will: Fetch structured data via twitter cli (likes, retweets, bookmarks) Fetch content with images via jina.ai API Download all images to attachments/YYYY MM DD AUTHOR TITLE/ Generate complete Markdown with embedded image references Include YAML frontmatter with metadata Example Output Alternative: Jina API (Text only) ⚠️ Known reliability risk (2026 08 30 live tests) : anonymous r.jina.ai access to x.com gets 403 globally banned for hours when third party users abuse the domain — the ban blocks every anonymous caller, then expires. Verified working again after expiry (anonymous fetch then returns post text), so treat Jina as intermittent , never a load bearing path. The shared key in this repo is also currently out of balance (402 InsufficientBalanceError), which makes fetch tweets.sh — it hard requires JINA API KEY — unusable until recharged. For simple text only fetching: Features Full Article Mode (fetch article.py) ✅ Structured metadata (author, date, engagement metrics) ✅ Automatic image download (all embedded media) ✅ Complete Markdown with local image references ✅ YAML frontmatter for PKM systems ✅ Handles X Articles (long form content) Simple Mode (Jina API) Text only content Intermittent availability (see risk note above); batch script hard requires JINA API KEY Good for quick text extraction when it's up Prerequisites For Full Article Mode uv (Python package manager) No additional setup (twitter cli auto installed) For Simple Mode (Jina) Output Structure What Gets Returned Full Article Mode YAML Frontmatter : source, author, date, likes, retweets, bookmarks Markdown Content : Full article text with local image references Attachments : All downloaded images in dedicated folder Simple Mode Title : Post author and content preview URL Source : Original tweet link Published Time : GMT timestamp Markdown Content : Text with remote media URLs URL Formats Supported https://x.com/USER/status/ID (posts) https://x.com/USER/article/ID (long form articles) https://twitter.com/USER/status/ID (legacy) Scripts fetch article.py Full featured article fetcher with image download: fetch tweet.py Simple text only fetcher using Jina API: fetch tweets.sh Batch fetch multiple tweets (Jina API): Migration from Jina API Old workflow: New workflow: