xsearch

Search real-time X posts and trends via the xAI Grok API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/iconidentify/chonkskill --skill xsearch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xsearch
Source: https://github.com/iconidentify/chonkskill/tree/main/skills/xsearch
Command: npx skills add https://github.com/iconidentify/chonkskill --skill xsearch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Real-time access to X posts, trends, and discussions via the xAI Grok API, enabling timely monitoring and contextual understanding with cited sources.

Core Features & Use Cases

  • Real-time topic search using xsearch:search to retrieve synthesis and citations
  • Media-aware search with xsearch:search_with_media to analyze images or video
  • Profile-specific searches with xsearch:profile to fetch posts from a user within date ranges
  • Output is structured with text and citations, ready for agent consumption and decision-making

Quick Start

Ask the agent to search X for a topic using xsearch:search to get real-time posts with citations.

Frequently Asked Questions about xsearch

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

FAQPage Schema
How do I search X for real-time social media posts and trends?▼

Real-time X search is performed via the xsearch:search tool, which retrieves synthesized discussions and citations using the xAI Grok API. It monitors breaking events and public sentiment across specified topics.

Does searching X with this method require an xAI Grok API key?▼

Searching X with these tools requires access to the xAI Grok API key. You must configure this key in your environment to enable real-time data retrieval and citation generation.

Can I retrieve posts from a specific X profile within a date range?▼

You can retrieve posts from a specific X profile using the xsearch:profile tool. This feature supports profile-specific inquiries and allows you to filter user posts by applying optional date filters.

How do I analyze media content like images in X search results?▼

To analyze media content in X search results, use the xsearch:search_with_media tool. This media-aware search capability processes images or video alongside text to provide contextual understanding with citations.

What is the best way to get cited sources when monitoring public sentiment on X?▼

The best way to get cited sources when monitoring public sentiment is to use the real-time X search tools. They output structured text with direct citations ready for agent consumption and decision-making.