xai-grok

Use xAI Grok API with Agent Tools for real-time web and X (Twitter) search and synthesis. Requires XAI_API_KEY.

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 26, 2025

When & Why to Use This Skill

This Claude skill leverages the xAI Grok API to provide autonomous, real-time research capabilities across the web and X (Twitter). By integrating live search tools, it allows for the synthesis of up-to-the-minute information, sentiment analysis, and comprehensive reporting with citations, effectively bridging the gap between static AI training data and the live web.

Use Cases

  • Real-time News & Sentiment Analysis: Track breaking news and public reaction on X (Twitter) to understand current trends and public discourse as they unfold.
  • Market & Competitive Intelligence: Conduct deep-dive research into the latest industry developments, competitor announcements, and emerging market shifts using live web data.
  • Fact-Checking & Verification: Verify the accuracy of recent events or claims by cross-referencing multiple real-time sources and social media updates for comprehensive validation.
namexai-grok
descriptionUse xAI Grok API with Agent Tools for real-time web and X (Twitter) search and synthesis. Requires XAI_API_KEY.

xAI Grok Research Skill

This skill utilizes the xAI Grok API and its Agent Tools for autonomous research, including real-time web and X platform search.

Setup

  1. Dependencies: Requires the xai-sdk.

    pip install xai-sdk python-dotenv
    
  2. API Key Configuration: The skill requires the XAI_API_KEY.

    # If the script fails due to a missing key, run the following:
    echo "It seems the xAI API key is not set up."
    read -p "Enter your xAI API key: " GROK_KEY
    echo "XAI_API_KEY=$GROK_KEY" >> .env
    if [ -f .gitignore ] && ! grep -q ".env" .gitignore; then echo ".env" >> .gitignore; fi
    echo "API key saved to .env."
    

Usage

Use the scripts/grok_research.py script. Grok will autonomously use the enabled tools.

Command

python3 scripts/grok_research.py --query "<query>" [--model <model_name>] [--web-search] [--x-search]

Parameters

  • --query (Required): The research query.
  • --model (Optional): Defaults to grok-4.1-fast-reasoning (optimized for tools).
  • --web-search (Optional): Enable web search tool.
  • --x-search (Optional): Enable X (Twitter) search tool.

Example

python3 scripts/grok_research.py --query "What is the current public sentiment and news coverage on the latest AI regulations?" --web-search --x-search

Output

The script streams the agent's thought process (to stderr) for visibility and outputs the final synthesized answer (to stdout) with citations.