grok-search
Search 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.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Search 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.
How to use
Zainstaluj skill grok-search w swoim środowisku agenta (np. Claude, Copilot). Upewnij się, że masz zainstalowany Node.js – jest wymagany do uruchomienia skryptów.
Uzyskaj klucz API od xAI (XAI_API_KEY) i ustaw go jako zmienną środowiskową. Skill będzie szukać klucza w kolejności: zmienna XAI_API_KEY, plik ~/.clawdbot/clawdbot.json, lub konfiguracja skill'u. Jeśli używasz pliku konfiguracyjnego, dodaj klucz pod ścieżką env.XAI_API_KEY lub skills.entries["grok-search"].apiKey.
Aby wyszukać w sieci, użyj komendy z flagą --web, np. "node {baseDir}/scripts/grok_search.mjs "twoja fraza" --web". Wynik pojawi się jako sformatowany JSON z cytowaniami i linkami.
Aby wyszukać na X/Twitterze, użyj flagi --x zamiast --web. Możesz dodać filtry: --days 7 (ostatnie 7 dni), --from YYYY-MM-DD / --to YYYY-MM-DD (zakres dat), --handles @profil1,@profil2 (konkretne konta). Przykład: "node {baseDir}/scripts/grok_search.mjs "hashtag" --x --days 7 --handles @uzytkownik".
Dostosuj wyjście za pomocą flag: --max N (domyślnie 8 wyników), --links-only (tylko adresy URL), --text (ukryj sekcję cytowań), --model grok-4-1-fast (zmień model). Flaga --raw wyświetli pełny payload API na stderr do debugowania.
Jeśli potrzebujesz czatu z Grokiem zamiast wyszukiwania, użyj skryptu chat.mjs: "node {baseDir}/scripts/chat.mjs "twoja wiadomość"". Dla analizy obrazów dodaj flagę --image /ścieżka/do/obrazu.jpg.