Global Search

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

Form Parameters

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

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