baidu-search

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

3,891 stars

Complexity: easy

About this skill

The 'baidu-search' skill provides AI agents with programmatic access to the Baidu AI Search Engine (BDSE), a prominent search platform, particularly in China. It allows agents to perform web searches and retrieve structured results for a given query. This skill is invaluable for tasks requiring live information, current news, specific documentation, or general research directly from Baidu's extensive index. AI agents can leverage this skill to stay updated on real-time events, gather data within specified date ranges (e.g., 'past 24 hours' or custom date periods), and control the number of search results returned. This enables more precise and context-aware information retrieval than general web browsing. By integrating with Baidu's API, the skill ensures that results are relevant to the Chinese web landscape and other regions where Baidu is strong. Users benefit from the ability to automate information gathering, generate reports based on fresh data, or validate facts using a highly customizable search interface. It empowers agents to act as informed assistants, capable of pulling targeted information quickly and efficiently, especially when Baidu's specific indexing or results are preferred.

Best use case

The primary use case is for AI agents or automated systems that require targeted web search capabilities, especially for content predominantly found or best indexed by Baidu. This skill is ideal for researchers, developers building localized AI applications, or agents needing to gather up-to-date information, monitor news, or perform in-depth research with control over result quantity and freshness, particularly when working within the Chinese digital ecosystem.

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

The skill will return a structured JSON output containing web search results from Baidu, based on the provided query and parameters.

Practical example

Example input

Search Baidu for '最新新闻' (latest news) from the past 24 hours.

Example output

[{"title": "Baidu News: 最新新闻", "url": "https://news.baidu.com/...
", "snippet": "..."}, {"title": "新华社：国内要闻", "url": "https://www.xinhuanet.com/...
", "snippet": "..."}]

When to use this skill

When needing real-time web search results specifically from Baidu.
When searching for information within specific date ranges (e.g., 'past 24 hours' or custom dates).
When an AI agent needs to access web content programmatically with control over result count.
When retrieving information relevant to the Chinese internet landscape.

When not to use this skill

When searching for information not indexed or primarily available via Baidu.
When a simple, general web search (e.g., Google, Bing) is sufficient and Baidu-specific features are not required.
When an API key for Baidu AI Search is not available.
When offline or locally stored data is sufficient for the task.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/baidu-search-bak/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/aysun168/baidu-search-bak/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/baidu-search-bak/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How baidu-search Compares

Feature / Agent	baidu-search	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	easy	N/A

Frequently Asked Questions

What does this skill do?

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

How difficult is it to install?

The installation complexity is rated as easy. You can find the installation instructions above.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

Best AI Skills for ChatGPT

Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.

Best AI Skills for Claude

Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.

AI Agents for Startups

Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.

SKILL.md Source

# Baidu Search

Search the web via Baidu AI Search API.

## Prerequisites

### API Key Configuration
This skill requires a **BAIDU_API_KEY** to be configured in OpenClaw.

If you don't have an API key yet, please visit:
**https://console.bce.baidu.com/ai-search/qianfan/ais/console/apiKey**

For detailed setup instructions, see:
[references/apikey-fetch.md](references/apikey-fetch.md)

## Usage

```bash
python3 skills/baidu-search/scripts/search.py '<JSON>'
```

## Request Parameters

| Param | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| query | str | yes | - | Search query |
| count | int | no | 10 | Number of results to return, range 1-50 |
| freshness | str | no | Null | Time range, two formats: format one is ”YYYY-MM-DDtoYYYY-MM-DD“, and format two includes pd, pw, pm, and py, representing the past 24 hours, past 7 days, past 31 days, and past 365 days respectively |

## Examples

```bash
# Basic search
python3 scripts/search.py '{"query":"人工智能"}'

# Freshness first format "YYYY-MM-DDtoYYYY-MM-DD" example
python3 scripts/search.py '{
  "query":"最新新闻",
  "freshness":"2025-09-01to2025-09-08"
}'

# Freshness second format pd、pw、pm、py example
python3 scripts/search.py '{
  "query":"最新新闻",
  "freshness":"pd"
}'

# set count, the number of results to return
python3 scripts/search.py '{
  "query":"旅游景点",
  "count": 20,
}'
```

## Current Status

Fully functional.

Data & Research