Baidu Qianfan Search

Use this skill to query Baidu Qianfan's web search API and return structured search results without scraping websites directly.

Quick start

1. Store the API key in an environment variable before running scripts:

export QIANFAN_APPBUILDER_API_KEY='...'

Or keep it in a local untracked file such as .env.local and source it manually:

set -a
source ./.env.local
set +a

2. Run the bundled script:

python3 scripts/qianfan_search.py "北京有哪些旅游景区"

3. For raw JSON debugging:

python3 scripts/qianfan_search.py "北京有哪些旅游景区" --raw

Common patterns

Basic web search

python3 scripts/qianfan_search.py "百度千帆平台"

Restrict to specific sites

python3 scripts/qianfan_search.py "天气预报" --site weather.com.cn --site www.weather.com.cn

Filter by recency

python3 scripts/qianfan_search.py "近期 AI 智能体新闻" --recency week

Request images or videos too

python3 scripts/qianfan_search.py "故宫博物院" --web-top-k 5 --image-top-k 5 --video-top-k 3 --raw

Output handling

• Default mode prints a normalized JSON object with query, count, items, and discovered raw_keys.
• --raw prints the full upstream JSON for troubleshooting or adapting to API changes.
• If Baidu changes response fields, inspect raw output first, then patch scripts/qianfan_search.py.

Security rules

• Never place the real API key in SKILL.md or references/.
• Never publish .env.local to ClawHub.
• Before packaging or publishing, delete any local secret files from the skill folder or ensure the publisher excludes them.

References

• Read references/api.md for the concise endpoint and parameter summary.
• Use scripts/qianfan_search.py as the canonical wrapper for the API.