Baidu Search
11 versionsSummary
TL;DR: Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
Baidu Search gives your AI agent access to Baidu's AI-powered search engine. When you need live information from the Chinese internet, this skill handles it.
It works well for looking up Chinese-language documentation, news, and research topics that other search engines might not cover as well. Baidu is the dominant search engine in China, so this skill fills a real gap.
Just point your agent at a question and let Baidu AI Search do the work. The results come back ready for your agent to process and summarize.
Use cases
- Searching for Chinese-language documentation and technical resources
- Getting live news and current events from Chinese media sources
- Researching topics where Baidu has better coverage than Western search engines
- Looking up Chinese company information, products, and market data
Installation
Run this command to install the skill on your OpenClaw agent:
npx clawhub@latest install baidu-searchSecurity scan
The skill's code, runtime instructions, and requested credential (BAIDU_API_KEY) are consistent with a Baidu web search integration; nothing in the files indicates hidden exfiltration or unrelated privileges, though a small dependency declaration omission and plaintext key storage guidance should be noted.
SKILL.md
---
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": ["python3"], "env":["BAIDU_API_KEY"]},"primaryEnv":"BAIDU_API_KEY" } }
---
# 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.
Version history
- Added new documentation for API key setup, including a reference guide (references/apikey-fetch.md) - Updated SKILL.md with clearer instructions on API key configuration and setup link - Added _meta.json file for enhanced skill metadata
- Added detailed usage instructions and examples for using the Baidu AI Search API in SKILL.md. - Documented all available request parameters, including query, count, and freshness options. - Updated skill description for clarity on live search and research capabilities. - Included requirements for environment variables and binaries in metadata. - Confirmed the skill is fully functional.
- Updated request parameters: simplified to include only query, count, and freshness. - Added support for new freshness formats ("YYYY-MM-DDtoYYYY-MM-DD" and short codes pd/pw/pm/py). - Default and range for count parameter clarified (default 10, range 1–50). - Examples and usage instructions revised for new parameter set. - Removed advanced resource and search filter options from documentation for simplicity. - _meta.json file removed.
- Added detailed usage instructions and request parameter documentation for the Baidu Search skill. - Described available filters, including resource type, advanced search, website blocking, and date ranges. - Provided example commands for common search tasks. - Outlined current capability: fully functional for live Baidu web, image, and video search.
- Simplified and clarified user documentation in SKILL.md for easier reference. - Improved usage instructions and added concise, updated search parameter tables. - Streamlined parameter descriptions, examples, and filtering guidance. - No code logic changes; documentation updates only.
- Fixed a bug in scripts/search.py to improve stability and/or functionality. - No changes to user-facing features or SKILL.md documentation.
- Environment variable requirement changed from apiKey to BAIDU_API_KEY. - Metadata updated to reflect the new environment variable name.
- Environment variable changed from BAIDU_API_KEY to apiKey for configuration. - Updated documentation to remove explicit setup steps for environment variable. - Example usage updated to reflect new environment variable requirements. - Metadata in SKILL.md and _meta.json adjusted to match the environment variable change.
- Added _meta.json file for enhanced metadata management. - Updated requirement from "python" to "python3" in the skill metadata.
- Added detailed instructions for obtaining the BAIDU_API_KEY, including Baidu Cloud registration and API key retrieval links. - No other workflow or functionality changes.
Initial release of the baidu-search skill. - Enables web search via Baidu AI Search Engine (BDSE) when built-in web_search is unavailable. - Requires a valid BAIDU_API_KEY environment variable for authentication. - Supports advanced search parameters, including filtering by site, date range, content type, and safe search. - Executes a Python script to interact with the Baidu API and returns structured search results. - Provides detailed setup, parameter usage, and example invocation instructions.
Related skills
g_pyAngMulti Search Engine
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.
g_pyAngMulti Search Engine
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.
JakeLinDuckDuckGo Web Search
Web search without an API key using DuckDuckGo Lite via web_fetch. Use as a fallback when web_search fails with missing_brave_api_key error, or whenever you...
LiangTavily Search
Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.
Frequently asked questions
Baidu AI Search Engine (BDSE) is Baidu's AI-enhanced search service. This skill lets your agent query it directly for live web results, which is especially useful for Chinese-language content.
Installation method
Send this prompt to your agent to install the skill
npx clawhub@latest install baidu-searchSkill info
Files
Skill data sourced from ClawHub