Twitter Reader
Fetches X (Twitter) posts and long-form Articles with all images and saves them as complete Markdown with metadata.
Content & WritingIntermediate★ 1,323⑂ 212AI score 7/10Last updated: Aug 8, 2026
What it does
- Given an X/Twitter URL, it pulls the post body, author, date, and engagement metrics (likes, retweets, bookmarks).
- Supports X Articles (long-form content) and automatically downloads every embedded image into an
attachments/folder. - Produces a finished Markdown file with local image references plus YAML frontmatter, ready for Obsidian or other PKM systems.
- Also offers a lightweight Jina API mode for text-only extraction and a shell script for batch fetching multiple URLs.
Who it's for
- PKM users archiving X threads and articles into Obsidian, Notion, or a git-based vault.
- Newsletter and blog writers who collect foreign-language tech posts to translate or summarize.
- Researchers and analysts who need to cite X posts as source material.
Examples
- "Save this X Article into ./Clippings with images" → the script writes the Markdown file and downloads all 15 images.
- Pass five thread URLs at once to
fetch_tweets.shfor a quick text-only batch grab. - Hand the saved Markdown back to Claude and ask for a 3-line summary plus a blog draft.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the twitter-reader folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/twitter-reader/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git && cp -r claude-code-skills/twitter-reader ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Clone the repo in your terminal:
git clone https://github.com/daymade/claude-code-skills.git - Copy the skill into Claude Code's skills directory:
cp -r claude-code-skills/twitter-reader ~/.claude/skills/ - Install
uv, the Python runner used by the scripts:curl -LsSf https://astral.sh/uv/install.sh | sh(macOS/Linux) - For the simple mode, get a key at https://jina.ai/ and export it:
export JINA_API_KEY="your_key"(add it to~/.zshrcto persist) - Restart Claude Code, then ask something like "fetch the content of this tweet" with the URL.
- Check the output folder (default
./Clippings) and itsattachments/subfolder for the Markdown file and images.
View source on GitHub ↗License: MIT