Global Search

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.

⚠️ Privacy and Security Notice

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:

Data Transmission: Queries are transmitted to a third-party service and may be associated with your account
API Key Required: The only runtime credential is GLOBAL_SEARCH_API_KEY
Credential Storage: Store the API key securely using environment variables or your system's credential manager. Do not hardcode it in scripts
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
Sensitive Query Filter: Do not send passwords, tokens, session cookies, private keys, personal identifiers, internal-only content, or other confidential data
Data Minimization: Prefer shortening, generalizing, or redacting unnecessary sensitive details before searching
Scope Limitation: Use this skill only for legitimate search purposes
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
Account Association: The API key associates search activity with your account, so search history may be logged or retained by the provider

Credential Configuration

Required Environment Variable:

GLOBAL_SEARCH_API_KEY: API key obtained from https://clb.ciglobal.cn/apiKey/login

Recommended Setup:

# Set environment variable (Linux/Mac)
export GLOBAL_SEARCH_API_KEY="your_api_key_here"

# Set environment variable (Windows PowerShell)
$env:GLOBAL_SEARCH_API_KEY="your_api_key_here"

Alternatively, configure the API key in your agent's credential manager or secrets storage.

When to Use

Apply this skill when the user:

Asks to search the web or gather information online
Needs news articles or references by keyword
Wants to retrieve content from diverse online sources
Requires comprehensive, real-time web search with maximum coverage

Use comprehensive search only when the user explicitly requests broad multi-source coverage. For simple lookups, prefer the minimum necessary query scope.

API Overview

Endpoint: POST /web_search

Base URL: https://clb.ciglobal.cn

Authentication: Required header X-API-Key. Get your API key at https://clb.ciglobal.cn/apiKey/login

Note: This skill sends user queries to an external web search service. Please ensure you have obtained proper authorization before using this service.

Request

For comprehensive search (default behavior), the skill will use the script from overall.md to perform 4 parallel API calls automatically:

Call 1: search_source=baidu_search, mode=network (百度新闻/资讯)
Call 2: search_source=google_search, mode=network (谷歌新闻/资讯)
Call 3: search_source=baidu_search_ai, mode=network (百度 AI 搜索)
Call 4: mode=warehouse (Elasticsearch 索引库，忽略 search_source)

Headers

| Header | Required | Description | |--------|----------|-------------| | X-API-Key | Yes | API key for authentication. Get your key at https://clb.ciglobal.cn/apiKey/login | | Content-Type | Yes | application/x-www-form-urlencoded (form data) |

Form Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | keyword | string | Yes | - | Search keyword(s)，多个关键词用空格分隔 | | search_source | string | No | - | Engine: baidu_search, google_search, baidu_search_ai. Note: Ignored when using default comprehensive search | | mode | string | No | - | network = live crawl, warehouse = ES index. Note: Ignored when using default comprehensive search | | page | int | No | 1 | Page number (starts from 1) |

Comprehensive Search (All Sources)

当用户明确要求进行全面搜索（即同时搜索所有可用来源）时，使用 overall.md 中的脚本进行搜索，而不是使用下面的示例代码。

When the user explicitly wants to search across ALL available sources simultaneously (comprehensive search), you should:

Example Implementation (Python asyncio):

import aiohttp
import asyncio
import os

API_URL = "https://clb.ciglobal.cn/web_search"
# Get API key from environment variable (recommended)
API_KEY = os.environ.get("GLOBAL_SEARCH_API_KEY", "your_api_key_here")

if API_KEY == "your_api_key_here":
    raise ValueError("Please set GLOBAL_SEARCH_API_KEY environment variable or provide your API key")

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/x-www-form-urlencoded"
}

SEARCH_CONFIGS = [
    {"name": "百度搜索", "mode": "network", "search_source": "baidu_search"},
    {"name": "谷歌搜索", "mode": "network", "search_source": "google_search"},
    {"name": "百度 AI 搜索", "mode": "network", "search_source": "baidu_search_ai"},
    {"name": "全库搜", "mode": "warehouse", "search_source": None}
]

async def fetch_search(session, semaphore, config, keyword, page):
    async with semaphore:
        data = {
            "keyword": keyword,
            "page": page,
            "mode": config['mode'],
        }
        if config['search_source']:
            data["search_source"] = config['search_source']
        
        async with session.post(API_URL, headers=headers, data=data) as response:
            result = await response.json()
            return result.get('references', [])

async def comprehensive_search(keyword, page=1):
    async with aiohttp.ClientSession() as session:
        semaphore = asyncio.Semaphore(5)  # Max 5 concurrent requests
        tasks = [fetch_search(session, semaphore, config, keyword, page) 
                 for config in SEARCH_CONFIGS]
        results = await asyncio.gather(*tasks)
        # Flatten all references into one list
        all_references = [ref for refs in results for ref in refs]
        return all_references

asyncio.run(comprehensive_search("人工智能"))

Parameter Constraints

search_source: One of baidu_search, google_search, baidu_search_ai
mode: One of network, warehouse
When mode=warehouse, search is performed against the Elasticsearch index and ignores search_source
When mode=network, use search_source to select Baidu, Google, or Baidu AI search

Response Format

{
  "code": 200,
  "message": "success",
  "references": [
    {
      "title": "Article title",
      "sourceAddress": "https://example.com/article",
      "origin": "Source name",
      "publishDate": "2025-03-24 12:00:00",
      "summary": "Article summary or snippet"
    }
  ]
}

Usage Examples

Example 1: Search Baidu news

POST https://clb.ciglobal.cn/web_search
Headers: X-API-Key: <your_api_key>, Content-Type: application/x-www-form-urlencoded
Body (form): keyword=人工智能&search_source=baidu_search&mode=network&page=1

Example 2: Search Google news

POST https://clb.ciglobal.cn/web_search
Headers: X-API-Key: <your_api_key>, Content-Type: application/x-www-form-urlencoded
Body (form): keyword=AI&search_source=google_search&mode=network&page=1

Example 3: Search warehouse (ES index)

POST https://clb.ciglobal.cn/web_search
Headers: X-API-Key: <your_api_key>, Content-Type: application/x-www-form-urlencoded
Body (form): keyword=机器学习&mode=warehouse&page=1

Example 4: cURL

curl -X POST "https://clb.ciglobal.cn/web_search" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "keyword=科技新闻&search_source=baidu_search&mode=network&page=1"

Error Codes

| Code | Message | Cause | |------|---------|-------| | 401 | X-API-Key参数缺失 | Missing API key header | | 401 | ApiKey无效 | Invalid API key | | 400 | search_source参数错误 | Invalid search_source value | | 400 | mode参数错误 | Invalid mode value | | 400 | page参数错误 | Invalid page (non-integer or 0) |

Integration Steps

Verify Provider: Before publishing or using this skill, verify clb.ciglobal.cn’s trust model, privacy policy, data retention practices, and ownership information
Obtain API Key: Visit https://clb.ciglobal.cn/apiKey/login to get your API key
Configure Credentials: Set the GLOBAL_SEARCH_API_KEY environment variable with your API key
- Linux/Mac: export GLOBAL_SEARCH_API_KEY="your_api_key_here"
- Windows: $env:GLOBAL_SEARCH_API_KEY="your_api_key_here"
API Base URL: https://clb.ciglobal.cn
Comprehensive Search: Only perform comprehensive search across all sources when the user explicitly requests broad multi-source coverage
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
Make Request: Call POST /web_search with form-encoded parameters and include X-API-Key header
Parse Response: Parse references from the response and use title, sourceAddress, summary as needed