← 返回
未分类 Key

globalsearch

Unleashes cutting-edge multi-source search technology that instantly synthesizes vast amounts of information across the web, delivering comprehensive and rel...
释放尖端多源搜索技术,即时综合网络海量信息,提供全面且相关的结果。
zzsn402 zzsn402 来源
未分类 clawhub v1.0.0 1 版本 100000 Key: 需要
★ 0
Stars
📥 294
下载
💾 0
安装
1
版本
#latest

概述

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

  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

版本历史

共 1 个版本

  • v1.0.0 当前
    2026-05-08 13:40 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

knowledge-management

Baidu web search

ide-rea
使用百度AI搜索引擎(BDSE)进行网络搜索。适用于获取实时信息、文档资料或研究课题。
★ 244 📥 107,069
knowledge-management

web-tools-guide

user_ec205dbb
MANDATORY before calling web_search, web_fetch, browser, or opencli. Contains required error-handling procedures (web_se
★ 61 📥 157,252
knowledge-management

Obsidian

steipete
操作 Obsidian 仓库(纯 Markdown 笔记)并通过 obsidian-cli 自动化。
★ 441 📥 104,632