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:

bash

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

HeaderRequiredDescriptionX-API-KeyYesAPI key for authentication. Get your key at https://clb.ciglobal.cn/apiKey/loginContent-TypeYesapplication/x-www-form-urlencoded (form data)

Form Parameters#

ParameterTypeRequiredDefaultDescriptionkeywordstringYes-Search keyword(s)，多个关键词用空格分隔search_sourcestringNo-Engine: baidu_search, google_search, baidu_search_ai. Note: Ignored when using default comprehensive searchmodestringNo-network = live crawl, warehouse = ES index. Note: Ignored when using default comprehensive searchpageintNo1Page 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):

python

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#

json

{
  "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#

text

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#

text

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

text

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#

bash

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#

CodeMessageCause401X-API-Key参数缺失Missing API key header401ApiKey无效Invalid API key400search_source参数错误Invalid search_source value400mode参数错误Invalid mode value400page参数错误Invalid page (non-integer or 0)

Integration Steps#

1. Verify Provider: Before publishing or using this skill, verify clb.ciglobal.cn’s trust model, privacy policy, data retention practices, and ownership information

2. Obtain API Key: Visit https://clb.ciglobal.cn/apiKey/login to get your API key

3. 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"

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

5. Comprehensive Search: Only perform comprehensive search across all sources when the user explicitly requests broad multi-source coverage

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

7. Make Request: Call POST /web_search with form-encoded parameters and include X-API-Key header

8. Parse Response: Parse references from the response and use title, sourceAddress, summary as needed