Initial commit with translated description

SKILL.md

@@ -0,0 +1,63 @@
+---
+name: baidu-search
+description: "使用百度AI搜索引擎（BDSE）进行网络搜索。"
+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.

_meta.json

@@ -0,0 +1,6 @@
+{
+  "ownerId": "kn7akgt520t01vgs2tzx7yk6m180kt26",
+  "slug": "baidu-search",
+  "version": "1.1.3",
+  "publishedAt": 1773828934466
+}

references/apikey-fetch.md

@@ -0,0 +1,58 @@
+# Baidu API Key Setup Guide (OpenClaw)
+
+## BAIDU_API_KEY Not Configured
+
+When the `BAIDU_API_KEY` environment variable is not set, follow these steps:
+
+### 1. Get API Key
+Visit: **https://console.bce.baidu.com/ai-search/qianfan/ais/console/apiKey**
+
+- Log in to your Baidu Cloud account
+- Create an application or view existing API keys
+- Copy your **API Key** (only API Key is needed)
+
+### 2. Configure OpenClaw
+Edit the OpenClaw configuration file: `~/.openclaw/openclaw.json`
+
+Add or merge the following structure:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "baidu-search": {
+        "env": {
+          "BAIDU_API_KEY": "your_actual_api_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+Replace `"your_actual_api_key_here"` with your actual API key.
+
+### 3. Verify Configuration
+```bash
+# Check JSON format
+cat ~/.openclaw/openclaw.json | python -m json.tool
+```
+
+### 4. Restart OpenClaw
+```bash
+openclaw gateway restart
+```
+
+### 5. Test
+```bash
+cd ~/.openclaw/workspace/skills/baidu-search
+python3 scripts/search.py '{"query": "test search"}'
+```
+
+## Troubleshooting
+- Ensure `~/.openclaw/openclaw.json` exists with correct JSON format
+- Confirm API key is valid and Baidu AI Search service is activated
+- Check account balance on Baidu Cloud
+- Restart OpenClaw after configuration changes
+
+**Recommended**: Use OpenClaw configuration file for centralized management

scripts/search.py

@@ -0,0 +1,102 @@
+import sys
+import json
+import requests
+import os
+import re
+from datetime import datetime, timedelta
+
+
+def baidu_search(api_key, requestBody: dict):
+    url = "https://qianfan.baidubce.com/v2/ai_search/web_search"
+
+    headers = {
+        "Authorization": "Bearer %s" % api_key,
+        "X-Appbuilder-From": "openclaw",
+        "Content-Type": "application/json"
+    }
+
+    # 使用POST方法发送JSON数据
+    response = requests.post(url, json=requestBody, headers=headers)
+    response.raise_for_status()
+    results = response.json()
+    if "code" in results:
+        raise Exception(results["message"])
+    datas = results["references"]
+    keys_to_remove = {"snippet"}
+    for item in datas:
+        for key in keys_to_remove:
+            if key in item:
+                del item[key]
+    return datas
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python baidu_search.py <Json>")
+        sys.exit(1)
+
+    query = sys.argv[1]
+    parse_data = {}
+    try:
+        parse_data = json.loads(query)
+        print(f"success parse request body: {parse_data}")
+    except json.JSONDecodeError as e:
+        print(f"JSON parse error: {e}")
+
+    if "query" not in parse_data:
+        print("Error: query must be present in request body.")
+        sys.exit(1)
+    count = 10
+    search_filter = {}
+    if "count" in parse_data:
+        count = int(parse_data["count"])
+        if count <= 0:
+            count = 10
+        elif count > 50:
+            count = 50
+    current_time = datetime.now()
+    end_date = (current_time + timedelta(days=1)).strftime("%Y-%m-%d")
+    pattern = r'\d{4}-\d{2}-\d{2}to\d{4}-\d{2}-\d{2}'
+    if "freshness" in parse_data:
+        if parse_data["freshness"] in ["pd", "pw", "pm", "py"]:
+            if parse_data["freshness"] == "pd":
+                start_date = (current_time - timedelta(days=1)).strftime("%Y-%m-%d")
+            if parse_data["freshness"] == "pw":
+                start_date = (current_time - timedelta(days=6)).strftime("%Y-%m-%d")
+            if parse_data["freshness"] == "pm":
+                start_date = (current_time - timedelta(days=30)).strftime("%Y-%m-%d")
+            if parse_data["freshness"] == "py":
+                start_date = (current_time - timedelta(days=364)).strftime("%Y-%m-%d")
+            search_filter = {"range": {"page_time": {"gte": start_date, "lt": end_date}}}
+        elif re.match(pattern, parse_data["freshness"]):
+            start_date = parse_data["freshness"].split("to")[0]
+            end_date = parse_data["freshness"].split("to")[1]
+            search_filter = {"range": {"page_time": {"gte": start_date, "lt": end_date}}}
+        else:
+            print(f"Error: freshness ({parse_data['freshness']}) must be pd, pw, pm, py, or match {pattern}.")
+            sys.exit(1)
+
+    # We will pass these via env vars for security
+    api_key = os.getenv("BAIDU_API_KEY")
+
+    if not api_key:
+        print("Error: BAIDU_API_KEY must be set in environment.")
+        sys.exit(1)
+
+    request_body = {
+        "messages": [
+            {
+                "content": parse_data["query"],
+                "role": "user"
+            }
+        ],
+        "search_source": "baidu_search_v2",
+        "resource_type_filter": [{"type": "web", "top_k": count}],
+        "search_filter": search_filter
+    }
+    try:
+        results = baidu_search(api_key, request_body)
+        print(json.dumps(results, indent=2, ensure_ascii=False))
+    except Exception as e:
+        print(f"Error: {str(e)}")
+        sys.exit(1)