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.