minimax-tts

使用智谱网络搜索 API 进行互联网搜索。当用户请求网络搜索、最新新闻或需要当前信息时使用。

# Zhipu Web Search

Use Zhipu's web search API to search the internet.

## ⚠️ Security Requirements

**This skill requires `MINIMAX_API_KEY` environment variable to be set before use.**

### Security Best Practices:

1. **DO NOT store API keys in ~/.bashrc** - keys can be leaked
2. **DO NOT source shell configuration files** - prevents arbitrary code execution  
3. **Set environment variable directly** when running the script
4. **Be aware** API key will be visible in process list (ps aux)

## Setup

```bash
# Set API key as environment variable
export MINIMAX_API_KEY="your_api_key"
```

**Get your API key from:** https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys

## Usage

### Quick Search

```bash
export MINIMAX_API_KEY="your_key"

curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4-flash",
    "messages": [{"role": "user", "content": "搜索: YOUR_QUERY"}],
    "tools": [{"type": "web_search", "web_search": {"search_query": "YOUR_QUERY"}}]
  }' | jq -r '.choices[0].message.content'
```

### Using the Script

```bash
export MINIMAX_API_KEY="your_key"
./search.sh "搜索内容"
```

## Security Analysis

### ✅ What's Safe:
- No sourcing of ~/.bashrc or shell config files
- Uses jq for JSON escaping (prevents injection)
- Uses HTTPS with TLS 1.2+
- API key via environment variable (not hardcoded)
- Proper error handling - sensitive info not leaked
- Input validation (query length limit)
- Generic error messages (no path/file hints)

### ⚠️ Considerations:
- **Process list visibility**: API key visible in `ps aux`
  - Use in trusted environments only
- **Endpoint**: `https://open.bigmodel.cn` (official Zhipu API)

## Safety Features

| Feature | Implementation |
|---------|----------------|
| JSON escaping | jq --arg prevents injection |
| Input validation | Query length ≤500 chars |
| TLS | Force TLS 1.2+ |
| Error handling | Generic messages, no leaks |
| Timeout | 30 second curl timeout |

## When to Use

- User says "search for", "look up", "find information about"
- User asks "what's the latest news about"
- User needs current information from the web

## API Endpoint

**Official:** `https://open.bigmodel.cn/api/paas/v4/chat/completions`

---

## 中文说明

# 智谱网络搜索

使用智谱的网络搜索 API 来搜索互联网。

## ⚠️ 安全要求

**此技能在使用前需要设置 `MINIMAX_API_KEY` 环境变量。**

### 安全最佳实践：

1. **请勿将 API 密钥存储在 ~/.bashrc 中** - 密钥可能会泄露
2. **请勿 source shell 配置文件** - 防止任意代码执行
3. 在运行脚本时**直接设置环境变量**
4. **注意** API 密钥将在进程列表中可见（ps aux）

## 设置

```bash
# Set API key as environment variable
export MINIMAX_API_KEY="your_api_key"
```

**从此处获取你的 API 密钥：** https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys

## 用法

### 快速搜索

```bash
export MINIMAX_API_KEY="your_key"

curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4-flash",
    "messages": [{"role": "user", "content": "搜索: YOUR_QUERY"}],
    "tools": [{"type": "web_search", "web_search": {"search_query": "YOUR_QUERY"}}]
  }' | jq -r '.choices[0].message.content'
```

### 使用脚本

```bash
export MINIMAX_API_KEY="your_key"
./search.sh "搜索内容"
```

## 安全分析

### ✅ 安全之处：
- 不 source ~/.bashrc 或 shell 配置文件
- 使用 jq 进行 JSON 转义（防止注入）
- 使用 HTTPS 和 TLS 1.2+
- 通过环境变量提供 API 密钥（非硬编码）
- 适当的错误处理 - 不泄露敏感信息
- 输入验证（查询长度限制）
- 通用错误消息（无路径/文件提示）

### ⚠️ 注意事项：
- **进程列表可见性**：API 密钥在 `ps aux` 中可见
  - 仅在受信任的环境中使用
- **端点**：`https://open.bigmodel.cn`（官方智谱 API）

## 安全特性

| 特性 | 实现 |
|---------|----------------|
| JSON 转义 | jq --arg 防止注入 |
| 输入验证 | 查询长度 ≤500 字符 |
| TLS | 强制 TLS 1.2+ |
| 错误处理 | 通用消息，无泄露 |
| 超时 | 30 秒 curl 超时 |

## 何时使用

- 用户说 "search for"、"look up"、"find information about"
- 用户问 "what's the latest news about"
- 用户需要来自网络的当前信息

## API 端点

**官方：** `https://open.bigmodel.cn/api/paas/v4/chat/completions`