# skill-baidu-search

**Repository Path**: zhuai_club/skill-baidu-search

## Basic Information

- **Project Name**: skill-baidu-search
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
name: baidu-search
description: Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
metadata: { "openclaw": { "emoji": "🔍︎",  "requires": { "bins": ["baidu-search"], "env":["BAIDU_API_KEY"]},"primaryEnv":"BAIDU_API_KEY" } }
---

# Baidu Search

Search the web via Baidu AI Search API using Go implementation.

## Usage

```bash
# Using the compiled executable
./baidu-search '{"query":"人工智能"}'

# Running from source
go run baidu_search.go '{"query":"人工智能"}'
```

## Request Parameters

| Param | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| query | str | yes | - | Search query |
| edition | str | no | standard | `standard` (full) or `lite` (light) |
| resource_type_filter | list[obj] | no | web:20 | Resource types: web (max 50), video (max 10), image (max 30), aladdin (max 5) |
| search_filter | obj | no | - | Advanced filters (see below) |
| block_websites | list[str] | no | - | Sites to block, e.g. ["tieba.baidu.com"] |
| search_recency_filter | str | no | year | Time filter: `week`, `month`, `semiyear`, `year` |
| safe_search | bool | no | false | Enable strict content filtering |

## SearchFilter

| Param | Type | Description |
|-------|------|-------------|
| match.site | list[str] | Limit search to specific sites, e.g. ["baike.baidu.com"] |
| range.pageTime | obj | Date range for page_time field (see below) |

### Date Range Format

Fixed date: `YYYY-MM-DD`
Relative time (from current day): `now-1w/d`, `now-1M/d`, `now-1y/d`

| Operator | Meaning |
|----------|---------|
| gte | Greater or equal (start) |
| lte | Less or equal (end) |

## Examples

```bash
# Basic search
./baidu-search '{"query":"人工智能"}'

# Filter by time and site
./baidu-search '{ 
  "query":"最新新闻", 
  "search_recency_filter":"week", 
  "search_filter":{"match":{"site":["news.baidu.com"]}} 
}'

# Resource type filter
./baidu-search '{ 
  "query":"旅游景点", 
  "resource_type_filter":[{"type":"web","top_k":20},{"type":"video","top_k":5}] 
}'
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| BAIDU_API_KEY | yes | Baidu API key for authentication |

## API Endpoint

```
https://qianfan.baidubce.com/v2/ai_search/web_search
```

## Current Status

Fully functional.

## Build Instructions

```bash
# Compile the executable
go build -o baidu-search baidu_search.go

# Run the executable
./baidu-search '{"query":"test"}'
```