Baidu Search Skill
This skill allows OpenClaw agents to perform web searches via Baidu AI Search Engine (BDSE).
Setup
- API Key: Ensure the BAIDU_API_KEY environment variable is set with your valid API key.
- Environment: The API key should be available in the runtime environment.
Workflow
- The skill executes the Python script located at
scripts/search.py
- The script makes a POST request to the Baidu AI Search API
- The API returns structured search results with titles, URLs, and content snippets
Parameters
request body structure
| param |
type |
required |
default |
description |
| query |
str |
yes |
|
user query content |
| edition |
str |
no |
standard |
Optional value: standard: Full version. lite: Standard version. |
| resource_type_filter |
list[obj] |
no |
[{"type": "web","top_k": 20},{"type": "video","top_k": 0},{"type": "image","top_k": 0},{"type": "aladdin","top_k": 0}] |
Support setting web pages, videos, images, and Aladdin search modes. The maximum value of top_k for web pages is 50, for videos it is 10, for images it is 30, and for Aladdin it is 5 |
| search_filter |
list[obj] |
no |
|
Search and filter based on the sub-conditions under SearchFilter. For the usage method, please refer to the details of the SearchFilter table. |
| block_websites |
list[str] |
no |
|
List of sites that need to be blocked. Filter the search results belonging to this site and its sub-sites in the site list. Example: ["tieba.baidu.com"] |
| search_recency_filter |
str |
no |
|
Filter based on the publication time of the web page. Enumeration values: week: The last 7 days month: The last 30 days semiyear: The last 180 days, year: The last 365 days |
| safe_search |
bool |
no |
false |
Whether to enable secure search or not, if it is enabled, a stricter risk control strategy will be adopted, and some queries that may involve pornography or terrorism will not return search results. |
SearchFilter table
| param |
type |
required |
default |
description |
| match |
obj |
no |
|
filter site condition |
| match.site |
str |
no |
|
Support setting search conditions for specified sites, that is, only conduct content search within the set sites. Currently, it supports setting up 100 sites. Example: ["tieba.baidu.com", "baike.baidu.com"] Note: This is a paid feature and is currently free for a limited time. |
| range |
obj |
no |
|
Range query. It can be used for numeric and date-type fields. The grammar format is as follows: "range" : { "{field}" : { "gte" : " {lowerBound}" , "gt" : "{lowerBound}" , "lte" : "{upperBound}" , "lt" : "{upperBound}" }} Entity (field) pageTime: The name of the entity representing the publication time, indicating a range query for pageTime. Here, pageTime corresponds to the page_time field in the response data. The filtering function for web page publication time is only applicable to available and displayable libraries. Other results such as videos will not be recalled. |
SearchFilter example
{
"match": {
"site": ["tieba.baidu.com", "baike.baidu.com"]
},
"range": {
"pageTime": {
"gte": "now-1w/d",
"lt": "now/d"
}
}
}
range usage description
Query range (lowerBound\upperBound)
- Specify date Specify search date range, format: YYYY-MM-DD, for example: quot; range" : { " page_time" : { " gte" : " 2025-11-01" , " lte" : " 2025-11-04"
- Time units supported by fixed packages: y (year), M (month), w (week), d (day). Currently, the following fixed packages are provided. Any other packages are illegal. Among them, "now" To represent the current time, a mathematical expression can be added after "now" : "-1w" indicates minus one week. "-1M" indicates minus one month; "-1y" indicates minus one year; "/d" indicates the start/end time normalized to the current day.
the fixed time unit enums:
now/d
now-1w/d: One week
now-2w/d: Two weeks
now-1M/d: One month
now-3M/d: Three months
now-6M/d: Six months
now-1y/d: One year
Parameter limitation description:
1.lte usage note: The range range will participate in the calculation of the cache key in the retrieval system. After the lte performs upward rounding and rounding, due to cache, the result timeliness may lag behind the lte value specified by match.
2. The lowerBound and upperBound times must exist simultaneously; otherwise, this function will not take effect.
3. Only one of gte and gt needs to be passed. If both are passed, only gt will take effect
Example Usage
BAIDU_API_KEY=xxx python3 skills/baidu-search/scripts/search.py '{"query":"北京有哪些旅游景区","resource_type_filter":[{"type":"web","top_k":20}],"search_filter":{"match":{"site":["www.weather.com.cn"]}},"search_recency_filter":"year"}'
Current Status
The Baidu search skill is fully functional and can be used to retrieve current information from the web. As demonstrated, it successfully retrieved weather information for Beijing, showing current conditions and forecasts.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: baidu-search3description: Search the web using Baidu AI Search Engine (BDSE). Use this when you need live information, documentation, or to research topics and the built-in web_search is unavailable. Use when this capability is needed.4---56# Baidu Search Skill78This skill allows OpenClaw agents to perform web searches via Baidu AI Search Engine (BDSE).910## Setup11121. **API Key:** Ensure the BAIDU_API_KEY environment variable is set with your valid API key.132. **Environment:** The API key should be available in the runtime environment.1415## Workflow16171. The skill executes the Python script located at `scripts/search.py`182. The script makes a POST request to the Baidu AI Search API193. The API returns structured search results with titles, URLs, and content snippets2021## Parameters2223#### request body structure24| param | type | required| default| description|25|----------|----------|----------|----------|-----------|26| query | str | yes | | user query content|27| edition | str | no | standard |Optional value: standard: Full version. lite: Standard version. |28| resource_type_filter | list[obj] | no | [{"type": "web","top_k": 20},{"type": "video","top_k": 0},{"type": "image","top_k": 0},{"type": "aladdin","top_k": 0}] | Support setting web pages, videos, images, and Aladdin search modes. The maximum value of top_k for web pages is 50, for videos it is 10, for images it is 30, and for Aladdin it is 5|29| search_filter | list[obj] | no | |Search and filter based on the sub-conditions under SearchFilter. For the usage method, please refer to the details of the SearchFilter table.|30| block_websites | list[str] | no | |List of sites that need to be blocked. Filter the search results belonging to this site and its sub-sites in the site list. Example: ["tieba.baidu.com"]|31| search_recency_filter | str | no | |Filter based on the publication time of the web page. Enumeration values: week: The last 7 days month: The last 30 days semiyear: The last 180 days, year: The last 365 days|32| safe_search | bool | no | false |Whether to enable secure search or not, if it is enabled, a stricter risk control strategy will be adopted, and some queries that may involve pornography or terrorism will not return search results.|3334### SearchFilter table35| param | type | required| default| description|36|----------|----------|----------|----------|-----------|37| match | obj | no | |filter site condition|38| match.site | str | no | |Support setting search conditions for specified sites, that is, only conduct content search within the set sites. Currently, it supports setting up 100 sites. Example: ["tieba.baidu.com", "baike.baidu.com"] Note: This is a paid feature and is currently free for a limited time.|39| range | obj | no | |Range query. It can be used for numeric and date-type fields. The grammar format is as follows: "range" : { "{field}" : { "gte" : " {lowerBound}" , "gt" : "{lowerBound}" , "lte" : "{upperBound}" , "lt" : "{upperBound}" }} Entity (field) pageTime: The name of the entity representing the publication time, indicating a range query for pageTime. Here, pageTime corresponds to the page_time field in the response data. The filtering function for web page publication time is only applicable to available and displayable libraries. Other results such as videos will not be recalled.|4041#### SearchFilter example42```json43{44 "match": {45 "site": ["tieba.baidu.com", "baike.baidu.com"]46 },47 "range": {48 "pageTime": {49 "gte": "now-1w/d",50 "lt": "now/d"51 }52 }53}54```5556#### range usage description5758Query range (lowerBound\upperBound)591. Specify date Specify search date range, format: YYYY-MM-DD, for example: quot; range" : { " page_time" : { " gte" : " 2025-11-01" , " lte" : " 2025-11-04" 602. Time units supported by fixed packages: y (year), M (month), w (week), d (day). Currently, the following fixed packages are provided. Any other packages are illegal. Among them, "now" To represent the current time, a mathematical expression can be added after "now" : "-1w" indicates minus one week. "-1M" indicates minus one month; "-1y" indicates minus one year; "/d" indicates the start/end time normalized to the current day. 61the fixed time unit enums:62 now/d 63 now-1w/d: One week 64 now-2w/d: Two weeks 65 now-1M/d: One month 66 now-3M/d: Three months 67 now-6M/d: Six months 68 now-1y/d: One year 6970Parameter limitation description: 711.lte usage note: The range range will participate in the calculation of the cache key in the retrieval system. After the lte performs upward rounding and rounding, due to cache, the result timeliness may lag behind the lte value specified by match. 722. The lowerBound and upperBound times must exist simultaneously; otherwise, this function will not take effect. 733. Only one of gte and gt needs to be passed. If both are passed, only gt will take effect747576## Example Usage7778```bash79BAIDU_API_KEY=xxx python3 skills/baidu-search/scripts/search.py '{"query":"北京有哪些旅游景区","resource_type_filter":[{"type":"web","top_k":20}],"search_filter":{"match":{"site":["www.weather.com.cn"]}},"search_recency_filter":"year"}'80```8182## Current Status8384The Baidu search skill is fully functional and can be used to retrieve current information from the web. As demonstrated, it successfully retrieved weather information for Beijing, showing current conditions and forecasts.8586---87> Converted and distributed by [TomeVault](https://tomevault.io/claim/demerzels-lab) — claim your Tome and manage your conversions.88<!-- tomevault:4.0:skill_md:2026-04-13 -->
tomevault-io