Grok Search
Enhanced web search via Grok API. Standalone CLI only (no MCP dependency).
Implementation Layout
scripts/groksearch_cli.py - CLI entrypoint and compatibility facadescripts/groksearch/ - internal modules for config, HTTP retry, Grok provider, Tavily calls, formatting, and commands
Execution Methods
Run scripts/groksearch_cli.py via Bash:
# Prerequisites: pip install httpx tenacity
# Environment: GROK_API_URL, GROK_API_KEY (required); TAVILY_API_KEY (optional)
# Web search (Grok only)
python scripts/groksearch_cli.py web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10]
# Web search with Tavily extra sources (parallel + URL-deduplicated merge)
python scripts/groksearch_cli.py web_search --query "..." --extra-sources 5
# Fetch webpage (default: Grok)
python scripts/groksearch_cli.py web_fetch --url "https://..." [--out file.md]
# Fetch via Tavily extract endpoint
python scripts/groksearch_cli.py web_fetch --url "https://..." --via tavily
# Map a website's structure (Tavily)
python scripts/groksearch_cli.py web_map --url "https://docs.example.com" [--instructions "API only"] [--max-depth 2] [--max-breadth 20] [--limit 50] [--timeout 150]
# Check config
python scripts/groksearch_cli.py get_config_info [--no-test]
# Switch model
python scripts/groksearch_cli.py switch_model --model "grok-2-latest"
# Toggle built-in tools
python scripts/groksearch_cli.py toggle_builtin_tools --action on|off|status [--root /path/to/project]
Tool Routing Policy
Forced Replacement Rules
| Scenario |
Disabled |
Force Use |
| Web Search |
WebSearch |
CLI web_search |
| Web Fetch |
WebFetch |
CLI web_fetch |
Tool Capability Matrix
| Tool |
Parameters |
Output |
web_search |
query(required), platform/min_results/max_results(optional), extra_sources(int, 0=disabled) |
[{title,url,description,provider?}] |
web_fetch |
url(required), out(optional), via(grok|tavily, default grok) |
Structured Markdown |
web_map |
url(required), instructions/max_depth/max_breadth/limit/timeout(optional) |
{base_url,results,response_time} JSON |
get_config_info |
no_test(optional) |
{api_url,status,connection_test,tavily_*} |
switch_model |
model(required) |
{previous_model,current_model} |
toggle_builtin_tools |
action(on/off/status), root(optional) |
{blocked,deny_list} |
Search Workflow
Phase 1: Query Construction
- Intent Recognition: Broad search →
web_search | Deep retrieval → web_fetch
- Parameter Optimization: Set
platform for specific sources, adjust result counts
Phase 2: Search Execution
- Start with
web_search for structured summaries
- Use
web_fetch on key URLs if summaries insufficient
- Retry with adjusted query if first round unsatisfactory
Phase 3: Result Synthesis
- Cross-reference multiple sources
- Must annotate source and date for time-sensitive info
- Must include source URLs:
Title [<sup>1</sup>](URL)
Error Handling
| Error |
Recovery |
| Connection Failure |
Run get_config_info, verify API URL/Key |
| No Results |
Broaden search terms |
| Fetch Timeout |
Try alternative sources |
Anti-Patterns
| Prohibited |
Correct |
| No source citation |
Include Source [<sup>1</sup>](URL) |
| Give up after one failure |
Retry at least once |
| Use built-in WebSearch/WebFetch |
Use GrokSearch tools/CLI |
1---2name: grok-search3description: Enhanced web search and real-time content retrieval via Grok API with forced tool routing. Use when: (1) Web search / information retrieval / fact-checking, (2) Webpage content extraction / URL parsing, (3) Breaking knowledge cutoff limits for current information, (4) Real-time news and technical documentation, (5) Multi-source information aggregation. Triggers: "search for", "find information about", "latest news", "current", "fetch webpage", "get content from URL". IMPORTANT: This skill REPLACES built-in WebSearch/WebFetch with Grok Search tools.4---56# Grok Search78Enhanced web search via Grok API. Standalone CLI only (no MCP dependency).910## Implementation Layout1112- `scripts/groksearch_cli.py` - CLI entrypoint and compatibility facade13- `scripts/groksearch/` - internal modules for config, HTTP retry, Grok provider, Tavily calls, formatting, and commands1415## Execution Methods1617Run `scripts/groksearch_cli.py` via Bash:1819```bash20# Prerequisites: pip install httpx tenacity21# Environment: GROK_API_URL, GROK_API_KEY (required); TAVILY_API_KEY (optional)2223# Web search (Grok only)24python scripts/groksearch_cli.py web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10]2526# Web search with Tavily extra sources (parallel + URL-deduplicated merge)27python scripts/groksearch_cli.py web_search --query "..." --extra-sources 52829# Fetch webpage (default: Grok)30python scripts/groksearch_cli.py web_fetch --url "https://..." [--out file.md]3132# Fetch via Tavily extract endpoint33python scripts/groksearch_cli.py web_fetch --url "https://..." --via tavily3435# Map a website's structure (Tavily)36python scripts/groksearch_cli.py web_map --url "https://docs.example.com" [--instructions "API only"] [--max-depth 2] [--max-breadth 20] [--limit 50] [--timeout 150]3738# Check config39python scripts/groksearch_cli.py get_config_info [--no-test]4041# Switch model42python scripts/groksearch_cli.py switch_model --model "grok-2-latest"4344# Toggle built-in tools45python scripts/groksearch_cli.py toggle_builtin_tools --action on|off|status [--root /path/to/project]46```4748## Tool Routing Policy4950### Forced Replacement Rules5152| Scenario | Disabled | Force Use |53|----------|----------|-----------|54| Web Search | `WebSearch` | CLI `web_search` |55| Web Fetch | `WebFetch` | CLI `web_fetch` |5657### Tool Capability Matrix5859| Tool | Parameters | Output |60|------|------------|--------|61| `web_search` | `query`(required), `platform`/`min_results`/`max_results`(optional), `extra_sources`(int, 0=disabled) | `[{title,url,description,provider?}]` |62| `web_fetch` | `url`(required), `out`(optional), `via`(grok\|tavily, default grok) | Structured Markdown |63| `web_map` | `url`(required), `instructions`/`max_depth`/`max_breadth`/`limit`/`timeout`(optional) | `{base_url,results,response_time}` JSON |64| `get_config_info` | `no_test`(optional) | `{api_url,status,connection_test,tavily_*}` |65| `switch_model` | `model`(required) | `{previous_model,current_model}` |66| `toggle_builtin_tools` | `action`(on/off/status), `root`(optional) | `{blocked,deny_list}` |6768## Search Workflow6970### Phase 1: Query Construction71- **Intent Recognition**: Broad search → `web_search` | Deep retrieval → `web_fetch`72- **Parameter Optimization**: Set `platform` for specific sources, adjust result counts7374### Phase 2: Search Execution751. Start with `web_search` for structured summaries762. Use `web_fetch` on key URLs if summaries insufficient773. Retry with adjusted query if first round unsatisfactory7879### Phase 3: Result Synthesis801. Cross-reference multiple sources812. **Must annotate source and date** for time-sensitive info823. **Must include source URLs**: `Title [<sup>1</sup>](URL)`8384## Error Handling8586| Error | Recovery |87|-------|----------|88| Connection Failure | Run `get_config_info`, verify API URL/Key |89| No Results | Broaden search terms |90| Fetch Timeout | Try alternative sources |9192## Anti-Patterns9394| Prohibited | Correct |95|------------|---------|96| No source citation | Include `Source [<sup>1</sup>](URL)` |97| Give up after one failure | Retry at least once |98| Use built-in WebSearch/WebFetch | Use GrokSearch tools/CLI |
Dianel555