Twitter Reader

# Twitter/X Reader Skill

A comprehensive skill for reading and extracting data from X (formerly Twitter) tweets using multiple reliable data sources.

## Overview

This skill extracts complete tweet information including text content, author details, engagement statistics, media attachments, and quoted tweets from X/Twitter URLs. It uses a multi-tier approach for maximum reliability and data completeness.

## When to Use

**Primary Triggers:**
- User shares a tweet URL (x.com/*/status/* or twitter.com/*/status/*)
- User asks to "read this tweet" with a URL
- User requests tweet analysis, summary, or data extraction
- User mentions getting information from a specific tweet

**Example User Requests:**
- "What does this tweet say? https://x.com/elonmusk/status/123456789"
- "Can you read this tweet for me?"
- "Summarize this Twitter thread"
- "What are the engagement stats on this tweet?"
- "Extract the media from this tweet"

## Capabilities

### Data Extracted
- **Tweet Content:** Full text with proper formatting
- **Author Information:** Display name and handle (@username)
- **Timestamps:** Both human-readable and original format
- **Engagement Stats:** Likes, retweets, replies, quote tweets
- **Media Attachments:** Photos and videos with direct URLs
- **Quote Tweets:** Full quoted tweet content and author info
- **Thread Context:** When available

### Supported URL Formats
- `https://x.com/username/status/1234567890`
- `https://twitter.com/username/status/1234567890`
- URLs with query parameters (e.g., `?s=20`, `?t=abc123`)
- Mobile URLs (m.twitter.com automatically handled)

## Usage Examples

### Basic Usage
```bash
# Read a single tweet
./scripts/read_tweet.sh "https://x.com/username/status/1234567890"

# Read a full thread (follows reply chain from the same author)
./scripts/read_thread.sh "https://x.com/username/status/1234567890"

# Fallback method using Nitter
./scripts/read_tweet_nitter.sh "https://x.com/username/status/1234567890"
```

### Agent Instructio...

# 🐦 Twitter/X Reader

**Professional-grade tweet extraction and analysis for OpenClaw**

Extract complete tweet data from X/Twitter URLs including content, engagement stats, media, and more. Built for reliability, security, and comprehensive data coverage.

## ✨ Features

- 🔗 **Universal URL Support** - Works with x.com, twitter.com, and mobile URLs
- 📊 **Complete Data Extraction** - Text, author, timestamps, engagement stats, media
- 🎯 **Multi-Source Reliability** - FxTwitter API primary + Nitter fallback
- 🔒 **Security First** - No data collection, fully auditable, open source
- ⚡ **Fast & Reliable** - Optimized for speed with robust error handling
- 🧵 **Thread Aware** - Handles quote tweets and conversation context

## 🚀 Quick Start

Simply share any tweet URL with your OpenClaw agent:

```
"What does this tweet say? https://x.com/elonmusk/status/1234567890"
```

Your agent will automatically extract and present:
- Tweet content with proper formatting
- Author name and handle
- Post timestamp and engagement metrics  
- Any attached media (photos/videos)
- Quoted tweets with full context

## 📋 What Gets Extracted

### Core Data
- **Tweet Text** - Full content with formatting preserved
- **Author Info** - Display name and @handle
- **Timestamps** - Human-readable and original format
- **Source URL** - Canonical link to the tweet

### Engagement Metrics
- **Likes** - Heart reactions count
- **Retweets** - Share count including quote tweets
- **Replies** - Comment count
- **Quotes** - Quote tweet count

### Media Content
- **Photos** - Direct links to full-resolution images
- **Videos** - MP4 URLs when available
- **GIFs** - Animated content links

### Advanced Features
- **Quote Tweets** - Embedded tweet content and author
- **Thread Context** - Related tweet identification
- **Link Preservation** - External URLs maintained in text

## 🔧 Technical Approach

### Primary: FxTwitter API
- **Fast & Reliable** - Sub-second response times
- **No Authentication*...