\r \r

Global Search\r

\r This skill performs multi-source web search through an external service and can aggregate results across multiple sources when the user explicitly asks for comprehensive coverage.\r \r

⚠️ Privacy and Security Notice\r

\r Important: This skill sends the user’s search query to an external web search service at https://clb.ciglobal.cn/web_search. Please be aware:\r \r

• Data Transmission: Queries are transmitted to a third-party service and may be associated with your account\r
• API Key Required: The only runtime credential is GLOBAL_SEARCH_API_KEY\r
• Credential Storage: Store the API key securely using environment variables or your system's credential manager. Do not hardcode it in scripts\r
• User Consent: If a query may contain sensitive, personal, confidential, or internal information, ask the user to confirm before sending it to the external service\r
• Sensitive Query Filter: Do not send passwords, tokens, session cookies, private keys, personal identifiers, internal-only content, or other confidential data\r
• Data Minimization: Prefer shortening, generalizing, or redacting unnecessary sensitive details before searching\r
• Scope Limitation: Use this skill only for legitimate search purposes\r
• Provider Verification: The provider clb.ciglobal.cn is an external third-party service. Its trustworthiness, retention policy, and privacy practices should be verified by the skill publisher before distribution; users should not assume it has been independently vetted\r
• Account Association: The API key associates search activity with your account, so search history may be logged or retained by the provider\r \r

Credential Configuration\r

\r Required Environment Variable:\r

• GLOBAL_SEARCH_API_KEY: API key obtained from https://clb.ciglobal.cn/apiKey/login\r \r Recommended Setup:\r

# Set environment variable (Linux/Mac)\r
export GLOBAL_SEARCH_API_KEY="your_api_key_here"\r
\r
# Set environment variable (Windows PowerShell)\r
$env:GLOBAL_SEARCH_API_KEY="your_api_key_here"\r
```\r
\r
Alternatively, configure the API key in your agent's credential manager or secrets storage.\r
\r
## When to Use\r
\r
Apply this skill when the user:\r
- Asks to search the web or gather information online\r
- Needs news articles or references by keyword\r
- Wants to retrieve content from diverse online sources\r
- Requires comprehensive, real-time web search with maximum coverage\r
\r
Use comprehensive search only when the user explicitly requests broad multi-source coverage. For simple lookups, prefer the minimum necessary query scope.\r
\r
## API Overview\r
\r
**Endpoint:** `POST /web_search`\r
\r
**Base URL:** `https://clb.ciglobal.cn`\r
\r
**Authentication:** Required header `X-API-Key`. Get your API key at https://clb.ciglobal.cn/apiKey/login\r
\r
**Note:** This skill sends user queries to an external web search service. Please ensure you have obtained proper authorization before using this service.\r
\r
## Request\r
\r
For comprehensive search (default behavior), the skill will use the script from overall.md to perform 4 parallel API calls automatically:\r
- **Call 1**: `search_source=baidu_search`, `mode=network` (百度新闻/资讯)\r
- **Call 2**: `search_source=google_search`, `mode=network` (谷歌新闻/资讯)\r
- **Call 3**: `search_source=baidu_search_ai`, `mode=network` (百度 AI 搜索)\r
- **Call 4**: `mode=warehouse` (Elasticsearch 索引库，忽略 search_source)\r
\r
### Headers\r
| Header | Required | Description |\r
|--------|----------|-------------|\r
| X-API-Key | Yes | API key for authentication. Get your key at https://clb.ciglobal.cn/apiKey/login |\r
| Content-Type | Yes | `application/x-www-form-urlencoded` (form data) |\r
\r
### Form Parameters\r
| Parameter | Type | Required | Default | Description |\r
|-----------|------|----------|---------|-------------|\r
| keyword | string | Yes | - | Search keyword(s)，多个关键词用空格分隔 |\r
| search_source | string | No | - | Engine: `baidu_search`, `google_search`, `baidu_search_ai`. Note: Ignored when using default comprehensive search |\r
| mode | string | No | - | `network` = live crawl, `warehouse` = ES index. Note: Ignored when using default comprehensive search |\r
| page | int | No | 1 | Page number (starts from 1) |\r
\r
\r
\r
### Comprehensive Search (All Sources)\r
当用户明确要求进行全面搜索（即同时搜索所有可用来源）时，使用 `overall.md` 中的脚本进行搜索，而不是使用下面的示例代码。\r
\r
When the user explicitly wants to search across ALL available sources simultaneously (comprehensive search), you should:\r
\r
\r
**Example Implementation (Python asyncio):**\r
```python\r
import aiohttp\r
import asyncio\r
import os\r
\r
API_URL = "https://clb.ciglobal.cn/web_search"\r
# Get API key from environment variable (recommended)\r
API_KEY = os.environ.get("GLOBAL_SEARCH_API_KEY", "your_api_key_here")\r
\r
if API_KEY == "your_api_key_here":\r
    raise ValueError("Please set GLOBAL_SEARCH_API_KEY environment variable or provide your API key")\r
\r
headers = {\r
    "X-API-Key": API_KEY,\r
    "Content-Type": "application/x-www-form-urlencoded"\r
}\r
\r
SEARCH_CONFIGS = [\r
    {"name": "百度搜索", "mode": "network", "search_source": "baidu_search"},\r
    {"name": "谷歌搜索", "mode": "network", "search_source": "google_search"},\r
    {"name": "百度 AI 搜索", "mode": "network", "search_source": "baidu_search_ai"},\r
    {"name": "全库搜", "mode": "warehouse", "search_source": None}\r
]\r
\r
async def fetch_search(session, semaphore, config, keyword, page):\r
    async with semaphore:\r
        data = {\r
            "keyword": keyword,\r
            "page": page,\r
            "mode": config['mode'],\r
        }\r
        if config['search_source']:\r
            data["search_source"] = config['search_source']\r
        \r
        async with session.post(API_URL, headers=headers, data=data) as response:\r
            result = await response.json()\r
            return result.get('references', [])\r
\r
async def comprehensive_search(keyword, page=1):\r
    async with aiohttp.ClientSession() as session:\r
        semaphore = asyncio.Semaphore(5)  # Max 5 concurrent requests\r
        tasks = [fetch_search(session, semaphore, config, keyword, page) \r
                 for config in SEARCH_CONFIGS]\r
        results = await asyncio.gather(*tasks)\r
        # Flatten all references into one list\r
        all_references = [ref for refs in results for ref in refs]\r
        return all_references\r
\r
asyncio.run(comprehensive_search("人工智能"))\r
```\r
\r
### Parameter Constraints\r
- `search_source`: One of `baidu_search`, `google_search`, `baidu_search_ai`\r
- `mode`: One of `network`, `warehouse`\r
- When `mode=warehouse`, search is performed against the Elasticsearch index and ignores `search_source`\r
- When `mode=network`, use `search_source` to select Baidu, Google, or Baidu AI search\r
\r
## Response Format\r
\r
```json\r
{\r
  "code": 200,\r
  "message": "success",\r
  "references": [\r
    {\r
      "title": "Article title",\r
      "sourceAddress": "https://example.com/article",\r
      "origin": "Source name",\r
      "publishDate": "2025-03-24 12:00:00",\r
      "summary": "Article summary or snippet"\r
    }\r
  ]\r
}\r
```\r
\r
## Usage Examples\r
\r
### Example 1: Search Baidu news\r
```\r
POST https://clb.ciglobal.cn/web_search\r
Headers: X-API-Key: \x3Cyour_api_key>, Content-Type: application/x-www-form-urlencoded\r
Body (form): keyword=人工智能&search_source=baidu_search&mode=network&page=1\r
```\r
\r
### Example 2: Search Google news\r
```\r
POST https://clb.ciglobal.cn/web_search\r
Headers: X-API-Key: \x3Cyour_api_key>, Content-Type: application/x-www-form-urlencoded\r
Body (form): keyword=AI&search_source=google_search&mode=network&page=1\r
```\r
\r
### Example 3: Search warehouse (ES index)\r
```\r
POST https://clb.ciglobal.cn/web_search\r
Headers: X-API-Key: \x3Cyour_api_key>, Content-Type: application/x-www-form-urlencoded\r
Body (form): keyword=机器学习&mode=warehouse&page=1\r
```\r
\r
### Example 4: cURL\r
```bash\r
curl -X POST "https://clb.ciglobal.cn/web_search" \\r
  -H "X-API-Key: \x3Cyour_api_key>" \\r
  -H "Content-Type: application/x-www-form-urlencoded" \\r
  -d "keyword=科技新闻&search_source=baidu_search&mode=network&page=1"\r
```\r
\r
## Error Codes\r
\r
| Code | Message | Cause |\r
|------|---------|-------|\r
| 401 | X-API-Key参数缺失 | Missing API key header |\r
| 401 | ApiKey无效 | Invalid API key |\r
| 400 | search_source参数错误 | Invalid search_source value |\r
| 400 | mode参数错误 | Invalid mode value |\r
| 400 | page参数错误 | Invalid page (non-integer or 0) |\r
\r
## Integration Steps\r
\r
1. **Verify Provider:** Before publishing or using this skill, verify `clb.ciglobal.cn`’s trust model, privacy policy, data retention practices, and ownership information\r
2. **Obtain API Key:** Visit https://clb.ciglobal.cn/apiKey/login to get your API key\r
3. **Configure Credentials:** Set the `GLOBAL_SEARCH_API_KEY` environment variable with your API key\r
   - Linux/Mac: `export GLOBAL_SEARCH_API_KEY="your_api_key_here"`\r
   - Windows: `$env:GLOBAL_SEARCH_API_KEY="your_api_key_here"`\r
4. **API Base URL:** `https://clb.ciglobal.cn`\r
5. **Comprehensive Search:** Only perform comprehensive search across all sources when the user explicitly requests broad multi-source coverage\r
6. **Sensitive Query Check:** If the user’s query includes sensitive, personal, confidential, or internal data, refuse to transmit it and ask for a redacted or generalized query instead\r
7. **Make Request:** Call `POST /web_search` with form-encoded parameters and include `X-API-Key` header\r
8. **Parse Response:** Parse `references` from the response and use `title`, `sourceAddress`, `summary` as needed\r