x-search

Search X/Twitter posts via the xAI Grok API with filters.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Maxvyr/Maxvyr-omni-skills --skill x-search-maxvyr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-search
Source: https://github.com/Maxvyr/Maxvyr-omni-skills/tree/main/x-search
Command: npx skills add https://github.com/Maxvyr/Maxvyr-omni-skills --skill x-search-maxvyr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you surface timely X/Twitter posts by querying the xAI Grok API, enabling rapid social listening and trend spotting.

Core Features & Use Cases

  • Real-time post search using the Grok API with optional filters for handles and excludes.
  • Date-range filtering to focus on specific periods and trends.
  • Media understanding options (--images and --video) to enrich results with visual context.

Quick Start

Search for posts about your topic on X using the x-search script.

Frequently Asked Questions about x-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search X posts for brand monitoring and trend spotting?

You can search X posts for brand monitoring by querying the xAI Grok API to surface timely content, applying optional filters for specific handles, exclusions, and date ranges to refine results.

Can I filter Twitter search results by date range and specific handles?

Yes, Twitter search results can be filtered by date range and specific handles, allowing you to focus on targeted periods and exclude irrelevant accounts for precise competitive analysis.

Does x-search extract images and video context from social posts?

Yes, x-search extracts visual context from social posts by using media understanding flags for images and video, enriching the text content and citations returned in the structured JSON format.

What is the best way to get structured JSON data from X social listening?

The best way to get structured JSON data from X social listening is using the xAI Grok API, which returns relevant post text content, citations, and usage metrics directly formatted for data extraction.

Do I need an xAI Grok API key to extract Twitter citations and usage metrics?

Yes, you need an xAI Grok API key to extract Twitter citations and usage metrics, as the tool relies on this API to process search queries and return the structured data output.

Why use the Grok API for competitive analysis on X instead of standard search?

Using the Grok API for competitive analysis on X surfaces timely content that standard search misses, providing structured JSON outputs with citations and media understanding for deeper trend spotting.