grok-searchSearch the web or X/Twitter using xAI Grok server-side tools (web_search, x_search) via the xAI Responses API. Use when you need tweets/threads/users from X, want Grok as an alternative to Brave, or you need structured JSON + citations.
Install via ClawdBot CLI:
clawdbot install notabhay/grok-searchRequires:
Run xAI Grok locally via bundled scripts (search + chat + model listing). Default output for search is pretty JSON (agent-friendly) with citations.
The script looks for an xAI API key in this order:
XAI_API_KEY env var~/.clawdbot/clawdbot.json → env.XAI_API_KEY~/.clawdbot/clawdbot.json → skills.entries["grok-search"].apiKeyskills.entries["search-x"].apiKey or skills.entries.xai.apiKeyUse {baseDir} so the command works regardless of workspace layout.
node {baseDir}/scripts/grok_search.mjs "" --web node {baseDir}/scripts/grok_search.mjs "" --x node {baseDir}/scripts/chat.mjs "" node {baseDir}/scripts/chat.mjs --image /path/to/image.jpg "" node {baseDir}/scripts/models.mjsOutput:
--links-only print just citation URLs--text hide the citations section in pretty output--raw include the raw Responses API payload on stderr (debug)Common:
--max limit results (default 8)--model (default grok-4-1-fast)X-only filters (server-side via x_search tool params):
--days (e.g. 7)--from YYYY-MM-DD / --to YYYY-MM-DD--handles @a,@b (limit to these handles)--exclude @bots,@spam (exclude handles){
"query": "...",
"mode": "web" | "x",
"results": [
{
"title": "...",
"url": "...",
"snippet": "...",
"author": "...",
"posted_at": "..."
}
],
"citations": ["https://..."]
}citations are merged/validated from xAI response annotations where possible (more reliable than trusting the model’s JSON blindly).--x for tweets/threads, --web for general research.Generated Mar 1, 2026
Marketing agencies can use this skill to search X/Twitter for trending topics, user mentions, and competitor activity, enabling real-time campaign adjustments and sentiment analysis. It helps in gathering structured tweet data with citations for client reports and strategy development.
Researchers and academics can leverage web search to gather cited information from reliable sources, while X search helps collect social media data for studies on public opinion or trends. The JSON output with citations ensures data integrity and easy integration into research papers.
Journalists and media outlets can use this skill to quickly find recent tweets or web articles on breaking news, verify sources via citations, and compile structured data for articles or broadcasts. The date filters and handle exclusions aid in focusing on relevant, high-quality content.
Corporations can monitor X/Twitter for customer feedback, complaints, or brand mentions to manage reputation and respond promptly. The skill provides structured JSON results with author details and timestamps, facilitating analysis and action plans to improve customer relations.
Startups can use web and X searches to track competitor announcements, product launches, and market trends, gaining insights for strategic planning. The ability to filter by handles and dates helps in targeted data collection, supporting decision-making and innovation efforts.
Offer a subscription-based service where businesses access enhanced search capabilities, analytics dashboards, and automated reports using this skill. Revenue is generated through tiered pricing based on search volume and advanced features like custom filters or API integrations.
Provide consulting services to help organizations integrate this skill into their workflows, such as setting up automated monitoring systems or developing custom scripts. Revenue comes from project-based fees, ongoing support contracts, and training sessions for users.
Collect and aggregate search data from web and X sources using this skill, then sell anonymized datasets or detailed market research reports to clients in industries like finance or marketing. Revenue is generated through one-time sales or subscription access to updated data feeds.
💬 Integration Tip
Ensure the XAI_API_KEY is securely stored in environment variables or configuration files, and test the scripts locally before deploying in production to handle API rate limits and output formatting.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.