Baidu Search

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

Security 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.

Purpose & Capability

Name/description (Baidu web search) match the code and required env var. The script calls Baidu's qianfan API and returns web_search references — BAIDU_API_KEY is the expected credential for that API.

Instruction Scope

SKILL.md only instructs running the included Python script with a JSON payload and how to configure BAIDU_API_KEY in OpenClaw config. It references editing ~/.openclaw/openclaw.json and restarting OpenClaw — this is within scope for configuring a skill, but note that storing API keys in a plaintext config file is recommended by the docs and may be a security/privacy consideration for users.

Install Mechanism

This is instruction-only with one script (no install spec). The script imports the third-party 'requests' library but the metadata does not declare that dependency; users will need to ensure 'requests' is installed (pip install requests) or the script will fail. No downloads or remote installers are present.

Credentials

The only required environment variable is BAIDU_API_KEY (declared as primaryEnv) which is proportional to the skill's purpose. The script reads no other environment variables or sensitive system paths.

Persistence & Privilege

always is false and the skill is user-invocable. The skill does not request persistent or elevated platform privileges and does not modify other skills or system settings.

Assessment

This skill appears to do what it says: call Baidu's AI Search API using the BAIDU_API_KEY. Before installing, consider: 1) The script requires the Python 'requests' package but the skill metadata doesn't declare it — install requests (pip) or the script will error. 2) The provided instructions recommend storing BAIDU_API_KEY in ~/.openclaw/openclaw.json (plaintext) — if you prefer, use a secrets store or platform-provided secret mechanism instead of a plain file. 3) The script prints responses to stdout (including returned references) — avoid running it in shared or logged environments if results are sensitive. 4) Verify you trust the skill source before providing a long-lived API key; you may prefer to create a limited-scope key on Baidu if possible. Overall, there are no signs of hidden endpoints or unrelated credential requests.

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

Usage

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

# 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.