A specialized tool for fetching, filtering, and analyzing real-time trending topics and hashtags on X (Twitter).
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-trends-dijrb
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-dijrb 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 (Twitter) Trends?
The X (Twitter) Trends skill enables developers and researchers to programmatically access real-time social data. By leveraging the twurl CLI and the openclaw-agent, this skill provides a robust interface for retrieving worldwide or location-specific trends. It is a vital component for anyone building social monitoring tools or sentiment analysis workflows within the ecosystem of Openclaw Skills.
Beyond just fetching trend names, the skill allows for deep-dive searches into recent tweets, supporting advanced filters such as verified-only accounts or media-rich content. This ensures that users can not only see what is trending but also understand the context and volume behind the viral conversation.
X (Twitter) Trends Use Cases
- Tracking global or regional viral hashtags for real-time market research.
- Identifying trending topics in specific countries using WOEID filtering.
- Monitoring social sentiment by analyzing the tweet volume of specific trends.
- Filtering search results to find high-quality media or verified tweets related to a current event.
- Building automated reporting tools that aggregate social data via Openclaw Skills.
How X (Twitter) Trends Works
- The user ensures the openclaw-agent is active, which serves as the foundational communication layer.
- Authentication is handled through the twurl CLI using standard X API consumer keys and secrets.
- The skill queries the Twitter API v1.1 to retrieve trending topics based on geographic location IDs (WOEID).
- For deeper analysis, the skill utilizes Twitter API v2 to search for recent tweets associated with those trends.
- JSON responses are processed using jq to filter and present clean, actionable data to the agent.
X (Twitter) Trends Setup
First, install the twurl CLI gem:
gem install twurl
Next, authorize the application with your X API credentials:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
Ensure that the openclaw-agent is downloaded and running on your local machine (Windows or macOS) to enable communication between the CLI and your Openclaw Skills environment.
X (Twitter) Trends Data Schema & Taxonomy
The skill returns structured trend data and search results. The trend objects typically include:
| Property | Description |
|---|---|
| name | The hashtag or trend name. |
| url | Direct link to the search results on X. |
| tweet_volume | Total number of tweets for the trend in the last 24 hours (if available). |
| promoted_content | Indicates if the trend is a paid advertisement. |
X (Twitter) Trends Advanced Features
- Multi-location support using specific WOEIDs for countries like the USA, UK, Japan, and Brazil.
- Coordinate-based trend discovery using latitude and longitude to find the closest trending topics.
- Advanced search operators to filter for verified users or tweets containing specific media types.
- High-performance JSON parsing using jq integration for streamlined data consumption in Openclaw Skills.
- Automated rate-limit management by utilizing the v1.1 and v2 API endpoints strategically.
SKILL.md
Loading
Related Openclaw Skills
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.
x-trends
A specialized tool for retrieving and analyzing real-time trending topics, hashtags, and location-specific popular content on X (Twitter).
x-trends
A powerful utility for retrieving, filtering, and analyzing real-time trending topics and hashtags from X using the twurl CLI.
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-trends
A professional CLI tool for searching, filtering, and analyzing trending topics and hashtags on X (Twitter) by location or global reach.
X (Twitter) Trends
A professional tool for programmatically searching, filtering, and analyzing real-time trending topics on X (Twitter).
METADATA
Featured*
