A versatile Python tool for reading X (Twitter) posts using either public Nitter mirrors or RapidAPI for detailed data extraction.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-reader-skill
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 x-reader-skill 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 X-Reader?
X-Reader is a technical utility designed to bridge the gap between AI agents and social media content on X (formerly Twitter). By bypassing the requirement for an official developer account, it allows for seamless data retrieval through two distinct methods: Nitter for free, anonymous scraping and RapidAPI for high-fidelity, structured data.
As part of the broader library of Openclaw Skills, X-Reader provides a standardized way to ingest social signals into your local workflows. It is built to be lightweight, requiring only Python 3.8 and the requests library, making it an ideal choice for developers who need to integrate real-time social data without the administrative overhead of the official X API.
X-Reader Use Cases
- Automating the collection of public status updates for sentiment analysis.
- Monitoring specific X threads to feed context into AI-driven research reports using Openclaw Skills.
- Archiving historical post data for digital marketing audits.
- Developing browser-based or CLI tools that require tweet metadata like like counts and timestamps.
How X-Reader Works
- The user inputs a specific X.com or Twitter.com status URL into the tool.
- The system checks for the presence of a RAPIDAPI_KEY environment variable.
- In Nitter Mode (default), the skill scrapes a public Nitter instance to retrieve post text and basic metadata.
- In RapidAPI Mode, the skill sends a request to a third-party API provider for a more detailed and stable JSON response.
- The skill parses the raw data into a consistent JSON schema.
- The final output is delivered to the console or calling agent for further processing.
X-Reader Setup
# Install the required Python library
pip install requests
# (Optional) To use the high-detail RapidAPI mode, set your API key
export RAPIDAPI_KEY="your_api_key_here"
# Run the skill with a tweet URL
python3 x-reader.py "https://x.com/username/status/1234567890"
X-Reader Data Schema & Taxonomy
The skill returns a structured JSON object. This format is designed for easy integration with other Openclaw Skills in a data pipeline.
| Key | Type | Description |
|---|---|---|
| id | String | The unique numerical ID of the post |
| text | String | The full content of the tweet |
| author | String | The display name of the user |
| username | String | The @handle of the user |
| created_at | String | ISO 8601 timestamp |
| likes | Integer | Total number of likes |
| retweets | Integer | Total number of retweets |
| replies | Integer | Total number of replies |
| url | String | The original source URL |
X-Reader Advanced Features
- Dual-provider logic allows for zero-cost operation with an easy upgrade path for production-grade reliability.
- Environment variable detection enables seamless switching between scraper and API modes without code changes.
- Normalized JSON output ensures compatibility with downstream data processing tools.
- Minimal dependency footprint facilitates easy containerization and deployment within Openclaw Skills environments.
SKILL.md
Loading
Related Openclaw Skills
Git Federation Searcher
A unified search tool for discovering repositories across multiple self-hosted and federated Git instances like Gitea, GitLab, and Forgejo.
ClawdHub CLI
A powerful command-line interface for managing the discovery, installation, and publication of Openclaw Skills.
bioSkills Bioinformatics Suite
A massive meta-skill collection providing 425 specialized bioinformatics capabilities for AI agents across 62 distinct research categories.
Home Assistant Master
A professional-grade operations skill for Home Assistant OS focusing on diagnostics, safety-first automation design, and system maintenance.
Inner Life Chronicle
A sophisticated journaling skill for AI agents that converts daily interactions into structured self-reflections and emotional state updates.
inner-life-dream
A skill that enables AI agents to perform freeform, creative exploration and hypothetical thinking during quiet hours.
Featured*
