A comprehensive Twitter/X intelligence toolkit designed for deep user analysis, trend tracking, and network research.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install readx
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 readx 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 readx?
readx is an advanced intelligence layer for Twitter/X that enables AI agents to perform sophisticated social media forensics. By integrating this toolkit into your Openclaw Skills library, you can transform raw social data into high-level strategic insights. It goes beyond simple data fetching by providing frameworks for calculating engagement metrics, authority ratios, and virality signals.
Whether you are monitoring brand sentiment or researching niche communities, readx provides a standardized interface for accessing the X ecosystem. It functions as both a remote MCP server for seamless integration with AI editors and a direct API for custom scripting, ensuring that your Openclaw Skills remain functional across various development environments.
readx Use Cases
- Competitive analysis of follower quality and engagement rates across multiple profiles.
- Real-time monitoring of viral topics using advanced search operators like min_faves and filter:media.
- Mapping social networks by resolving user IDs and analyzing follower/following patterns.
- Identifying polarizing content through controversy ratio detection and reply-to-like analysis.
How readx Works
- The agent establishes a connection using the readx MCP server URL or a direct API key stored in the environment.
- Usernames are resolved to permanent user IDs via the resolution endpoint to ensure consistent data tracking.
- The skill executes parallel tool calls to fetch timelines, community data, or search results based on the query.
- Raw JSON responses are parsed to extract engagement metrics, media URLs, and pagination cursors.
- The agent applies built-in intelligence formulas to calculate derived metrics like the Virality Ratio or Authority Power.
- Results are synthesized into actionable insights and comparative tables for the end user.
readx Setup
To integrate readx into your Openclaw Skills environment, follow these steps:
- Obtain an API key from readx.cc.
- For MCP-compatible editors, add the following URL to your configuration:
https://readx.cc/mcp?apikey=YOUR_API_KEY. - For direct API usage via Bash, set your environment variable:
export READX_API_KEY='your_api_key_here'
- Alternatively, save your credentials to the standard config path at
~/.config/readx/credentials.json.
readx Data Schema & Taxonomy
The readx skill organizes data through a structured taxonomy to facilitate deep analysis within Openclaw Skills:
| Object | Key Components |
|---|---|
| User Profile | user_id, follower_count, following_count, bio, and authority_ratio |
| Tweet Detail | text, public_metrics (likes, retweets, replies), and media_attachments |
| Search Result | tweet_list, next_cursor for pagination, and search_metadata |
| Network Data | List of followers/following with profile snapshots for quality sampling |
| System | credit_balance and API rate limit status |
readx Advanced Features
- Support for complex boolean search logic and Twitter advanced operators.
- Automated calculation of specialized metrics such as the Save Ratio and Amplification Power.
- Direct API Mode for headless environments and platforms that do not yet support the Model Context Protocol.
- Cursor-based pagination handling for deep-diving into historical tweet timelines.
- Community and List discovery tools to find niche-specific conversations and influencers.
SKILL.md
Loading
Related Openclaw Skills
Echo Test
A lightweight diagnostic skill that mirrors user input and provides a timestamp to verify agent connectivity.
Currency Converter
A real-time financial utility for querying exchange rates and performing currency conversions across global markets.
PPT Generator
Transform spoken scripts into minimalist, high-impact vertical HTML slide decks inspired by Steve Jobs' presentation style.
Telegram Topic Rename
An automated utility for renaming Telegram forum topics and updating visual icons using the Telegram Bot API.
Football Bayes Analysis Agent
A professional-grade football analysis tool that applies Bayesian statistics and tactical periodization to predict match outcomes and game scripts.
NSFC Grant Writer
An expert AI assistant designed to guide researchers through the complex writing, formatting, and strategic planning of NSFC grant applications.
METADATA
Featured*
