minimax-video

使用智谱网络搜索 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`
age Title",
    "text": "Snippet of the page content..."
  }
]
```

### How the agent should use this

When you need to search the web for information:

1. Run the script with the user's query.
2. Parse the JSON output to extract relevant links and snippets.
3. Use the results to answer the user or to fetch specific pages for deeper reading.

```bash
# Quick search and capture output
RESULTS=$(python3 /path/to/skills/web-multi-search/web_multi_search.py "query here" 2>/dev/null)
echo "$RESULTS" | python3 -c "import json,sys; data=json.load(sys.stdin); [print(r['link'], r['title']) for r in data[:10]]"
```

## Available search engines

| Engine | Status |
|--------|--------|
| Bing | Working |
| Yahoo | Working |
| Startpage | Working |
| Aol | Working |
| Ask | Working |
| Google | Not working (requires JS) |
| DuckDuckGo | Not working (CAPTCHA) |
| Dogpile | Not working (HTTP 403) |
| Mojeek | Not working (HTTP 403) |
| Qwant | Not working (HTTP 403) |
| Torch | Requires TOR proxy |

## Troubleshooting

- **Import errors**: Make sure you installed the library from the GitHub URL with `--no-deps`.
- **Empty results / bans**: Search engines may rate-limit. Increase delay or use fewer pages.
- **Torch engine**: Only works with a running TOR proxy at `socks5://127.0.0.1:9050`.

---

## 中文说明

# Zhipu Web Search（智谱网络搜索）

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

## ⚠️ 安全要求

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

### 安全最佳实践：

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

## 设置

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

**从以下地址获取您的 API key：** 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 key（非硬编码）
- 妥善的错误处理 —— 敏感信息不泄露
- 输入校验（查询长度限制）
- 通用错误消息（不暴露路径/文件提示）

### ⚠️ 注意事项：
- **进程列表可见性**：API key 在 `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`
age Title",
    "text": "Snippet of the page content..."
  }
]
```

### 代理应如何使用

当您需要在网络上搜索信息时：

1. 使用用户的查询运行脚本。
2. 解析 JSON 输出以提取相关链接和摘要。
3. 使用结果回答用户，或获取特定页面以进行更深入的阅读。

```bash
# Quick search and capture output
RESULTS=$(python3 /path/to/skills/web-multi-search/web_multi_search.py "query here" 2>/dev/null)
echo "$RESULTS" | python3 -c "import json,sys; data=json.load(sys.stdin); [print(r['link'], r['title']) for r in data[:10]]"
```

## 可用的搜索引擎

| 引擎 | 状态 |
|--------|--------|
| Bing | 可用 |
| Yahoo | 可用 |
| Startpage | 可用 |
| Aol | 可用 |
| Ask | 可用 |
| Google | 不可用（需要 JS） |
| DuckDuckGo | 不可用（CAPTCHA） |
| Dogpile | 不可用（HTTP 403） |
| Mojeek | 不可用（HTTP 403） |
| Qwant | 不可用（HTTP 403） |
| Torch | 需要 TOR 代理 |

## 故障排查

- **导入错误**：确保您已使用 `--no-deps` 从 GitHub URL 安装了该库。
- **结果为空 / 被封禁**：搜索引擎可能会限速。增大延迟或减少页数。
- **Torch 引擎**：仅在 `socks5://127.0.0.1:9050` 上运行的 TOR 代理可用时才能工作。