x-trends

What This Skill Does

The x-trends skill empowers the OpenClaw AI agent to interact directly with X (formerly Twitter) to retrieve real-time trending topics and perform granular searches. By leveraging the official twurl CLI utility, this skill bridges the gap between raw API data and actionable insights. It allows you to monitor global conversations, pinpoint localized trends using WOEID (Where On Earth ID) mapping, and filter recent search results based on specific criteria such as media presence or verified account status. Whether you are conducting social listening, tracking brand sentiment, or simply staying informed about current global discourse, this tool provides the technical infrastructure to query X programmatically.

Installation

To utilize this skill, ensure you have Ruby installed to support the twurl gem. Follow these steps:

1. Install the command-line utility: gem install twurl.
2. Authenticate your account: twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET.
3. Install the skill via OpenClaw: clawhub install openclaw/skills/skills/zaycv/x-twitter-trends. Ensure you have jq installed on your system, as it is required for parsing the JSON responses returned by the API.

Use Cases

• Social Listening: Automatically pull the top 10 trends from a specific region to understand what topics are capturing public attention.
• Market Research: Search for hashtags related to your industry to see what verified users or media-heavy posts are circulating.
• Geospatial Analysis: Identify trending topics in specific countries or use coordinate lookup to find the nearest reporting region.
• Content Curation: Quickly gather recent tweets containing specific trends to feed into further analysis workflows.

Example Prompts

1. "What are the top 10 trends in the USA right now?"
2. "Search for the latest 10 tweets about #AI that include media."
3. "Find the trending topics for Japan and return their names and tweet volumes."

Tips & Limitations

• Rate Limiting: The Twitter API enforces a limit of 75 requests per 15-minute window for trend-related endpoints. Avoid rapid-fire polling.
• Data Availability: tweet_volume is not always present for every trend; expect null values for newer or less popular topics.
• Dependencies: This skill relies on both twurl and jq. Ensure your environment path is configured correctly for both.
• Authentication: Always handle your consumer keys securely. Do not hardcode credentials in scripts; use environment variables.