# Send Metaso Search V2 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "metaso-search-v2",
    "name": "Metaso Search V2",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/xinmh1338863/metaso-search-v2",
    "canonicalUrl": "https://clawhub.ai/xinmh1338863/metaso-search-v2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/metaso-search-v2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=metaso-search-v2",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "metaso-api.js",
      "package.json",
      "quick-test.js",
      "simple-test.js",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/metaso-search-v2"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/metaso-search-v2",
    "downloadUrl": "https://openagent3.xyz/downloads/metaso-search-v2",
    "agentUrl": "https://openagent3.xyz/skills/metaso-search-v2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/metaso-search-v2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/metaso-search-v2/agent.md"
  }
}
```
## Documentation

### 描述

提供对 Metaso 搜索 API 的直接访问，支持网页搜索、内容读取和智能问答功能。

### 1. 网页搜索 (metaso_web_search)

根据关键词搜索网页、文档、论文、图片、视频、播客等内容。

参数：

q: 搜索查询关键词（必填）
size: 返回结果数量（必填，1-100）
scope: 搜索范围（必填）
includeSummary: 是否包含精简的原文匹配信息（必填）
includeRawContent: 是否通过网页的摘要信息进行召回增强（必填）
conciseSnippet: 是否抓取所有来源网页原文（必填）

### 2. 网页内容读取 (metaso_web_reader)

读取指定 URL 的网页内容。

参数：

url: 要读取的 URL 地址（必填）
format: 输出格式（必填，json 或 markdown）

### 3. 智能问答 (metaso_chat)

基于 RAG 的智能问答服务。

参数：

messages: 用户消息数组（必填）
model: 使用的模型（必填）
scope: 搜索范围（必填）
format: 输出格式（必填）
stream: 是否开启流式输出（必填）
conciseSnippet: 是否返回精简的原文匹配信息（必填）

### 环境变量配置

必要配置：

# Linux/macOS
export METASO_API_KEY="您的API密钥"

# Windows (PowerShell)
$env:METASO_API_KEY="您的API密钥"

OpenClaw 配置：
在 OpenClaw 配置文件 openclaw.json 中添加：

{
  "env": {
    "METASO_API_KEY": "您的API密钥"
  }
}

### 使用方法

import { metasoSearch, metasoReadPage, metasoChat } from './skills/metaso-search/metaso-api.js';

// 搜索
const searchResult = await metasoSearch('人工智能', 2, 'document', true, false, true);

// 读取网页内容
const contentResult = await metasoReadPage('https://example.com', 'json');

// 智能问答
const chatResult = await metasoChat(
  [{ role: 'user', content: '什么是机器学习？' }], 
  'fast', 
  'webpage', 
  'simple', 
  false, 
  true
);

### metaso-api.js - API 核心模块

提供所有 API 方法的实现
包含自动配置加载
错误处理和重试机制
使用 Metaso HTTP API 端点

### quick-test.js - 快速测试脚本

用于快速验证 API 基本功能的简化测试
包含搜索和聊天功能的基本测试

### simple-test.js - 简单功能测试

测试所有 API 功能的详细测试脚本
包含搜索、内容读取和聊天功能的测试

### 运行测试

cd skills/metaso-search
node quick-test.js

### API 密钥未配置

Error: METASO_API_KEY 环境变量未设置，请在使用前配置

解决方法：设置 METASO_API_KEY 环境变量

### 认证失败

Error: API密钥无效

解决方法：检查 API 密钥是否正确

### 版本信息

当前版本: 2.1.0
移除了硬编码的默认 API 密钥
优化了配置管理
简化了文档结构
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: xinmh1338863
- Version: 2.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/metaso-search-v2)
- [Send to Agent page](https://openagent3.xyz/skills/metaso-search-v2/agent)
- [JSON manifest](https://openagent3.xyz/skills/metaso-search-v2/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/metaso-search-v2/agent.md)
- [Download page](https://openagent3.xyz/downloads/metaso-search-v2)