PaperclipOrg
Claude Agent Skill · by Daymade

Twitter Reader

Install Twitter Reader skill for Claude Code from daymade/claude-code-skills.

Install
Terminal · npx
$npx skills add https://github.com/daymade/claude-code-skills --skill twitter-reader
Works with Paperclip

How Twitter Reader fits into a Paperclip company.

Twitter Reader drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md156 lines
Expand
---name: twitter-readerdescription: 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 local attachments folder and generates complete Markdown with proper image references. Preferred over Jina for X Articles with images.--- # Twitter Reader Fetch Twitter/X post and article content with full media support. ## Quick Start (Recommended) For X Articles with images, use the new fetch_article.py script: ```bashuv run --with pyyaml python scripts/fetch_article.py <article_url> [output_dir]``` Example:```bashuv run --with pyyaml python scripts/fetch_article.py \  https://x.com/HiTw93/status/2040047268221608281 \  ./Clippings``` 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 ```Fetching: https://x.com/HiTw93/status/2040047268221608281--------------------------------------------------Getting metadata...Title: 你不知道的大模型训练：原理、路径与新实践Author: Tw93Likes: 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)``` ## Alternative: Jina API (Text-only) For simple text-only fetching without authentication: ```bash# Single tweetcurl "https://r.jina.ai/https://x.com/USER/status/TWEET_ID" \  -H "Authorization: Bearer ${JINA_API_KEY}" # Batch fetchingscripts/fetch_tweets.sh url1 url2 url3``` ## 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- No authentication required beyond Jina API key- Good for quick text extraction ## Prerequisites ### For Full Article Mode- `uv` (Python package manager)- No additional setup (twitter-cli auto-installed) ### For Simple Mode (Jina)```bashexport JINA_API_KEY="your_api_key_here"# Get from https://jina.ai/``` ## Output Structure ```output_dir/├── YYYY-MM-DD-article-title.md       # Main Markdown file└── attachments/    └── YYYY-MM-DD-author-title/        ├── 01-image.jpg        ├── 02-image.jpg        └── ...``` ## 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.pyFull-featured article fetcher with image download:```bashuv run --with pyyaml python scripts/fetch_article.py <url> [output_dir]``` ### fetch_tweet.pySimple text-only fetcher using Jina API:```bashpython scripts/fetch_tweet.py <tweet_url> [output_file]``` ### fetch_tweets.shBatch fetch multiple tweets (Jina API):```bashscripts/fetch_tweets.sh <url1> <url2> ...``` ## Migration from Jina API Old workflow:```bashcurl "https://r.jina.ai/https://x.com/..."# Manual image extraction and download``` New workflow:```bashuv run --with pyyaml python scripts/fetch_article.py <url># Automatic image download, complete Markdown```