English | 中文

A Codex/Claude skill that enables aggressive web research via your OpenAI-compatible Grok endpoint (2api). Perfect for real-time information queries, version checking, and documentation lookup.

• 🔍 Real-time web search through Grok API
• 📋 Structured JSON output with content + sources
• 🔐 Secure config with local override support
• 🌍 Environment variable configuration
• ⚡ Easy one-click installation

# Clone the repository
git clone https://github.com/Frankieli123/grok-skill.git

# Enter the directory
cd grok-skill

# Run the install script (Windows PowerShell)
powershell -ExecutionPolicy Bypass -File .\install.ps1

1. Download ZIP from: https://github.com/Frankieli123/grok-skill/archive/refs/heads/main.zip
2. Extract to any folder
3. Run install.ps1 in PowerShell

After installation, the skill will be located at:

C:\Users\<YourUsername>\.codex\skills\grok-search\

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\grok-search\configure.ps1"

Edit the config file at:

C:\Users\<YourUsername>\.codex\skills\grok-search\config.json

{
  "base_url": "https://your-grok-endpoint.example",
  "api_key": "YOUR_API_KEY",
  "model": "grok-2-latest",
  "timeout_seconds": 60,
  "extra_body": {},
  "extra_headers": {}
}

$env:GROK_BASE_URL="https://your-grok-endpoint.example"
$env:GROK_API_KEY="YOUR_API_KEY"
$env:GROK_MODEL="grok-2-latest"

For security, create config.local.json in the same directory (gitignored):

{
  "api_key": "your-real-api-key-here"
}

python scripts/grok_search.py --query "What is the latest version of Node.js?"

{
  "content": "The synthesized answer...",
  "sources": [
    {"url": "https://example.com", "title": "Source Title"}
  ]
}

Add the following prompt to your global agent configuration:

File: C:\Users\<YourUsername>\.codex\AGENTS.md or ~/.claude/CLAUDE.md

## Web Search Rule

When encountering any of the following situations, ALWAYS use the `grok-search` skill first before providing an answer:

1. Version numbers, release dates, or changelog information
2. API documentation or SDK usage
3. Error messages or troubleshooting
4. Current status of any project, service, or technology
5. Any information that might be time-sensitive or outdated
6. Package installation commands or dependencies
7. Official documentation links

Usage example:
​```bash
python ~/.codex/skills/grok-search/scripts/grok_search.py --query "Your search query here"
​```

After receiving search results, cite the sources in your response.

grok-search/
├── SKILL.md           # Skill definition for Codex/Claude
├── README.md          # This file
├── config.json        # Configuration template
├── install.ps1        # Installation script
├── configure.ps1      # Interactive configuration script
└── scripts/
    └── grok_search.py # Main search script

一个 Codex/Claude 技能插件，通过你的 OpenAI 兼容 Grok 接口（2api）实现激进的联网检索。适用于实时信息查询、版本检查和文档查找。

• 🔍 通过 Grok API 进行实时网络搜索
• 📋 结构化 JSON 输出，包含 content + sources
• 🔐 安全配置，支持本地覆盖
• 🌍 支持环境变量配置
• ⚡ 一键安装

# 克隆仓库
git clone https://github.com/Frankieli123/grok-skill.git

# 进入目录
cd grok-skill

# 运行安装脚本（Windows PowerShell）
powershell -ExecutionPolicy Bypass -File .\install.ps1

1. 从这里下载 ZIP：https://github.com/Frankieli123/grok-skill/archive/refs/heads/main.zip
2. 解压到任意文件夹
3. 在 PowerShell 中运行 install.ps1

安装完成后，技能将位于：

C:\Users\<你的用户名>\.codex\skills\grok-search\

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\grok-search\configure.ps1"

编辑配置文件：

C:\Users\<你的用户名>\.codex\skills\grok-search\config.json

{
  "base_url": "https://your-grok-endpoint.example",
  "api_key": "YOUR_API_KEY",
  "model": "grok-2-latest",
  "timeout_seconds": 60,
  "extra_body": {},
  "extra_headers": {}
}

$env:GROK_BASE_URL="https://your-grok-endpoint.example"
$env:GROK_API_KEY="YOUR_API_KEY"
$env:GROK_MODEL="grok-2-latest"

为了安全，在同目录下创建 config.local.json（已加入 .gitignore）：

{
  "api_key": "你的真实API密钥"
}

python scripts/grok_search.py --query "Node.js 最新版本是什么？"

{
  "content": "综合后的答案...",
  "sources": [
    {"url": "https://example.com", "title": "来源标题"}
  ]
}

将以下提示词添加到你的全局 Agent 配置中：

文件位置： C:\Users\<你的用户名>\.codex\AGENTS.md 或 ~/.claude/CLAUDE.md

## 联网搜索规则

遇到以下任何情况时，必须先使用 `grok-search` 技能进行搜索，然后再回答：

1. 版本号、发布日期或更新日志信息
2. API 文档或 SDK 使用方法
3. 错误信息或故障排除
4. 任何项目、服务或技术的当前状态
5. 任何可能过时或时效性强的信息
6. 包安装命令或依赖项
7. 官方文档链接

使用示例：
​```bash
python ~/.codex/skills/grok-search/scripts/grok_search.py --query "你的搜索查询"
​```

收到搜索结果后，在回答中引用来源。

grok-search/
├── SKILL.md           # Codex/Claude 技能定义文件
├── README.md          # 本文件
├── config.json        # 配置模板
├── install.ps1        # 安装脚本
├── configure.ps1      # 交互式配置脚本
└── scripts/
    └── grok_search.py # 主搜索脚本

MIT License

Issues and PRs are welcome!