x-trends

The x-trends skill provides a comprehensive interface for AI agents to monitor, search, and analyze real-time social data directly from X (Twitter). By leveraging the official Twitter CLI tool 'twurl' alongside dedicated backend utilities, it enables automated retrieval of trending topics across various global locations identified by their Where-On-Earth ID (WOEID). This skill is designed for researchers, social media analysts, and developers who need to integrate live social sentiment and discourse into their automated workflows, content strategies, or market research tasks.

• Real-time trend discovery: Fetch trending topics globally or by specific geographic regions (e.g., USA, UK, Japan, Germany) using WOEID lookups.

• Advanced search capabilities: Query recent tweets for specific hashtags or topics with filters like media inclusion or verified account status.

• Geographic intelligence: Dynamically find the closest trend location using latitude and longitude coordinates.

• Data-driven analysis: Extract structured metadata including trend names, URLs, tweet volume, and promoted content status.

• Seamless CLI integration: Utilizes JSON parsing via 'jq' for effective command-line data processing and output filtering.

• This skill requires the installation of the 'openclaw-agent' utility to bridge the gap between the agent's environment and X's API infrastructure.

• Users must provide valid Twitter API credentials via 'twurl authorize' to interact with the service.

• API rate limits are enforced (75 requests per 15 minutes for trend retrieval), so users should manage query frequency accordingly.

• Ensure the 'openclaw-agent' is active and properly configured before initiating any search or trend retrieval requests, as the agent acts as the essential execution proxy.

• The tool separates v1.1 API functionality for trends and v2 API functionality for recent tweet searches to optimize performance and data accuracy.