z.ai-web-search

# Z.AI Web Search

AI-optimized web search using Z.AI Web Search API. Designed for LLMs – returns structured results with titles, URLs, summaries, site names and favicons.

## Search

```bash
node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 15
node {baseDir}/scripts/search.mjs "query" --domain sohu.com
node {baseDir}/scripts/search.mjs "query" --recency oneWeek
node {baseDir}/scripts/search.mjs "query" --days 7
```

## Options

- `-n <count>`: Number of results (default: 10, max: 50)
- `--domain <domain>`: Limit results to specified domain (e.g. `sohu.com`, `www.example.com`)
- `--recency <filter>`: Time range – `oneDay`, `oneWeek`, `oneMonth`, `oneYear`, `noLimit` (default)
- `--days <n>`: Shorthand for recency (1→oneDay, 7→oneWeek, 30→oneMonth, 365→oneYear)

## Extract content from URL

```bash
node {baseDir}/scripts/extract.mjs "https://example.com/article"
```

Note: Z.AI does not provide an extract API. This script uses native fetch to retrieve pages and strips HTML for basic text extraction. For richer content, use search results (they include summaries).

## Setup

- Get API key at [Z.AI Platform](https://chat.z.ai)
- Set `ZAI_API_KEY` in your environment
- Docs: [Web Search Guide](https://docs.z.ai/guides/tools/web-search)

# Z.AI Web Search

Web search skill using [Z.AI Web Search API](https://docs.z.ai/guides/tools/web-search). Returns structured results (title, URL, summary, site name) optimized for LLM processing.

## Setup

1. Get an API key from [Z.AI Platform](https://chat.z.ai)
2. Set environment variable: `export ZAI_API_KEY="your-api-key"`

## Usage

### Search

```bash
node scripts/search.mjs "your search query"
node scripts/search.mjs "economic news" -n 15
node scripts/search.mjs "news" --domain sohu.com --days 7
```

### Extract (basic)

```bash
node scripts/extract.mjs "https://example.com/article"
```

Note: Z.AI has no extract API. The extract script uses native fetch + HTML stripping as a fallback.

## Options

| Option | Description |
|--------|-------------|
| `-n <count>` | Number of results (1–50, default 10) |
| `--domain <domain>` | Limit to domain (e.g. `sohu.com`) |
| `--recency <filter>` | `oneDay`, `oneWeek`, `oneMonth`, `oneYear`, `noLimit` |
| `--days <n>` | Shorthand for recency |

## API Reference

- [Web Search Guide](https://docs.z.ai/guides/tools/web-search)
- [Web Search API](https://docs.z.ai/api-reference/tools/web-search)