playbooks

home / skills / openclaw / skills / x-trends-dev

x-trends-dev skill

/skills/anishtr4/x-trends-dev

This skill fetches current top X Trends by country, delivering quick, JSON-ready insights for monitoring trends and scripting.

This is most likely a fork of the x-trends skill from openclaw
npx playbooks add skill openclaw/skills --skill x-trends-dev

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
879 B
---
name: x-trends
description: "Fetches current top trending topics on X (Twitter) for any country using public aggregators."
version: 1.2.0
author: Ani
license: MIT
---

# X Trends Scraper 📉

A professional CLI tool to fetch X (Twitter) trending topics without an account.
Powered by [getdaytrends.com](https://getdaytrends.com).

## Installation

```bash
clawdhub install x-trends
```

## Usage

Run the tool directly:

```bash
# Default (India, Top 20, Table View)
x-trends

# JSON Output (for scripts)
x-trends --json

# Specific Country & Limit
x-trends --country us --limit 5
```

## Features
- **No Login Required**: Uses public aggregators.
- **Volume Data**: Shows tweet counts (<10K, 50K, etc).
- **Multi-Country**: Supports 'us', 'uk', 'india', 'world', etc.
- **JSON Mode**: Easy parsing for other tools.

## Output
Displays a clean, colorized table or raw JSON.

Overview

This skill fetches current top trending topics on X (formerly Twitter) for any country using public trend aggregator services. It provides both a readable table view and a machine-friendly JSON output. The tool does not require an X account and is suitable for quick trend checks or integration into scripts.

How this skill works

The skill scrapes public aggregator pages to collect the latest trending topics for a specified country or region. It extracts headline text, estimated volume bands (like <10K, 50K, etc.), and rank position, then formats results as a colorized table or as JSON. Command-line flags let you choose country, result limit, and output mode for easy automation.

When to use it

  • Quickly checking what topics are trending in a specific country without logging into X.
  • Feeding live trend data into reporting dashboards or alerting systems.
  • Collecting trend snapshots for archival or historical comparison.
  • Automating content research or social listening workflows.
  • Running lightweight trend queries in CI/CD pipelines or scheduled jobs.

Best practices

  • Specify the country code and a reasonable limit to reduce request time and parsing errors.
  • Use the JSON output for downstream automation and logs to simplify parsing.
  • Cache results when running frequent queries to avoid hitting rate limits of the public aggregator.
  • Validate parsed volume bands before aggregating metrics if you need precise numeric counts.
  • Include error handling for network failures and changes to the aggregator HTML structure.

Example use cases

  • A content team runs a cron job to capture daily top trends in multiple countries and store them for headline inspiration.
  • A data engineer pulls JSON trend output into a pipeline to measure cross-country topic emergence.
  • A journalist checks live trending topics in a country before publishing region-specific coverage.
  • A community manager monitors trending conversation starters to craft timely social posts.
  • A researcher archives daily trend snapshots for retrospective analysis of social attention patterns.

FAQ

Do I need an X/Twitter account to use this skill?

No. The skill uses public aggregator pages and does not require logging into X.

Can I get results in a format suitable for automation?

Yes. Use the JSON output mode to receive structured data for scripts and pipelines.