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: