A high-performance data extraction tool for retrieving full tweet content, engagement metrics, and media from X/Twitter URLs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install twitter-reader
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install twitter-reader using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Twitter/X Reader Skill?
The Twitter/X Reader Skill is a robust technical solution designed for AI agents to interface with X (formerly Twitter) without requiring complex authentication. By leveraging a multi-tier approach including the FxTwitter API and Nitter fallbacks, this skill ensures high reliability when fetching tweet text, author metadata, and engagement statistics. It is an essential component for developers building research-oriented Openclaw Skills that require real-time social media data integration.
This tool is specifically optimized for developers and researchers who need structured, machine-readable data from social platforms. By automating the extraction process, it allows AI agents to summarize conversations, track engagement, and retrieve media assets directly from a single URL input, significantly enhancing the utility of Openclaw Skills in automated workflows.
Twitter/X Reader Skill Use Cases
- Summarizing long Twitter threads for quick analysis and reporting
- Extracting high-resolution media and video URLs from social posts for archival
- Monitoring engagement metrics like likes and retweets for digital sentiment analysis
- Archiving specific tweet content and quoted responses for research databases
- Automating the retrieval of information shared via X/Twitter URLs in AI chat interfaces
How Twitter/X Reader Skill Works
- The AI agent receives a valid X/Twitter status URL (x.com or twitter.com) from a user request.
- The system invokes the primary bash script which targets the FxTwitter API to retrieve structured metadata.
- If the primary API source fails or returns an error, the skill automatically switches to a fallback method using Nitter scraping instances.
- The raw data response is processed locally using the jq tool to produce a clean, standardized JSON object.
- The agent parses this JSON to present formatted information to the user or to perform advanced data analysis within the Openclaw Skills environment.
Twitter/X Reader Skill Setup
To integrate this into your environment, ensure you have curl and jq installed on your system. Use the following commands to prepare the Openclaw Skills scripts:
# Grant execution permissions to the scripts
chmod +x scripts/*.sh
# Test the primary extraction script with a sample URL
./scripts/read_tweet.sh "https://x.com/username/status/1234567890"
For macOS users, it is recommended to install gdate via Homebrew (brew install coreutils) for superior timestamp formatting.
Twitter/X Reader Skill Data Schema & Taxonomy
The skill organizes extracted information into a structured format for easy consumption by other Openclaw Skills. The data schema is organized as follows:
| Object | Field | Description |
|---|---|---|
| tweet | text |
The full text content of the post |
| author | handle |
The @username of the tweet creator |
| engagement | likes |
Integer count of likes/favorites |
| media | photos |
Array of full-resolution image URLs |
| media | video |
Direct URL to the MP4 video file if present |
| quoted_tweet | text |
Content of the embedded quote tweet |
Twitter/X Reader Skill Advanced Features
- Thread Unrolling: The
read_thread.shscript automatically follows reply chains from the same author to reconstruct full threads up to 50 tweets deep. - Media Deep-Linking: Identifies and extracts direct MP4 links for videos, GIFs, and full-resolution photo URLs for high-quality previews.
- Recursive Quote Handling: Captures nested quote tweets to provide full conversational context without infinite loops.
- Multi-Source Resilience: Intelligent switching between API endpoints and scraping fallbacks ensures maximum uptime for your Openclaw Skills.
- Safe URL Sanitization: Built-in logic to handle query parameters and mobile URL formats (m.twitter.com) automatically.
SKILL.md
Loading
Related Openclaw Skills
Moltbook Signed Posts
A cryptographic signing framework for Moltbook posts using Ed25519 to establish verifiable agent identity and prevent impersonation.
Fanvue API Skill
A robust integration for managing Fanvue creator workflows including messaging, media posts, and subscriber analytics through OAuth 2.0.
Context Builder
An agentic CLI tool that converts entire directories into structured, relevance-sorted markdown files optimized for LLM ingestion and token efficiency.
Dexter
Dexter is an autonomous agent designed to plan and execute complex financial data analysis for stocks, crypto, and company fundamentals.
Git Commit Template
A standardized framework for creating changelog-ready Git commit messages using structured categories and helper scripts.
Agent-Selfie
A specialized AI image generator that creates consistent, mood-aware avatars and visual identities for autonomous agents.
Featured*
