秘塔搜索

Search the web using Metaso AI Search API. Use for live information, documentation, or research topics.

Security Scan

The skill does what it says: a simple wrapper that sends search queries to Metaso's search API using a single METASO_API_KEY environment variable and a small Python script.

Purpose & Capability

Name/description match the behavior. The script POSTs to https://metaso.cn/api/v1/search and returns results. Requested binary (python) and primary env var (METASO_API_KEY) are appropriate for a search API wrapper.

Instruction Scope

SKILL.md instructs running the included Python script with a JSON argument. The runtime instructions only require the API key and do not attempt to read other files, system state, or unrelated environment variables. The 'includeRawContent' option may return full source content from the provider (expected for a search API).

Install Mechanism

This is an instruction-only skill with no install spec, which is low risk. Minor note: the script imports the Python 'requests' library but the SKILL metadata does not declare or install that dependency; the runtime environment must have requests available or the script will fail.

Credentials

Only METASO_API_KEY is required and is justified by the claimed purpose. No other secrets, unrelated credentials, or config paths are requested.

Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence or modify other skills or system configs. It runs only when invoked.

Assessment

This skill is a straightforward wrapper around Metaso's search API. Before installing: (1) Confirm you trust the Metaso provider (https://metaso.cn) because all queries and returned content go to that external service; (2) Store METASO_API_KEY securely (avoid exposing it to shared environments); (3) Ensure the agent runtime has Python and the 'requests' library installed; (4) Be aware that enabling includeRawContent may return large or sensitive text from remote sites; and (5) review provider limits, billing, and privacy policy so you know how query data is handled.

Metaso Search

Search the web via Metaso AI Search API.

Usage

python skills/metaso-search/scripts/search.py '<JSON>'

Request Parameters

Param	Type	Required	Default	Description
q	str	yes	-	Search query
scope	str	no	webpage	Search scope: webpage, news, paper, etc.
size	int	no	10	Number of results (1-50)
page	int	no	1	Page number
conciseSnippet	bool	no	false	Return concise snippet
includeSummary	bool	no	false	Include AI summary
includeRawContent	bool	no	false	Fetch raw content from sources

Examples

# Basic search
python scripts/search.py '{"q":"OpenClaw AI"}'

# With options
python scripts/search.py '{
  "q": "人工智能最新进展",
  "size": 5,
  "includeSummary": true
}'

API Reference

• 官方文档: https://metaso.cn/search-api/playground
• Endpoint: https://metaso.cn/api/v1/search
• Method: POST
• Auth: Bearer token in Authorization header
• Content-Type: application/json

Request Example

curl --location 'https://metaso.cn/api/v1/search' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "q": "搜索关键词",
  "scope": "webpage",
  "size": 10,
  "includeSummary": false,
  "includeRawContent": false,
  "conciseSnippet": false
}'

Response Example

{
  "credits": 3,
  "searchParameters": {
    "q": "搜索关键词",
    "scope": "webpage",
    "size": 10
  },
  "webpages": [
    {
      "title": "标题",
      "link": "https://example.com",
      "snippet": "摘要内容",
      "score": "high",
      "date": "2026-03-22"
    }
  ],
  "total": 25
}

Current Status

✅ Ready to use