YouMind 搜索技能

通过 YouMind 搜索在公共互联网上进行搜索。

当任务主要涉及以下内容时，优先使用此技能：

• - 最新的外部信息
• 在线研究
• 近期新闻
• 资料收集
• 按域名筛选的网络搜索

请勿将此技能用于用户的私人 YouMind 资料库。对于资料库搜索或更广泛的 YouMind 操作，请使用通用的 youmind 技能。

为什么使用它

YouMind 搜索并非某个搜索提供商的简单封装。
它整合了多个高质量的搜索提供商，然后应用 YouMind 自身的排序、筛选和结果优化，以提升搜索质量。

身份验证

此技能需要 YouMind 账户和 API 密钥。

如果您还没有 API 密钥：

1. 1. 在 https://youmind.com 注册
2. 打开设置
3. 生成 API 密钥
4. 在发起请求前设置 YOUMINDAPIKEY

默认使用生产环境端点：

bash
export YOUMINDBASEURL=https://youmind.com
export YOUMINDAPIKEY=sk-ym-xxx

对于本地开发或测试环境，可根据需要覆盖 YOUMINDBASEURL。

身份验证使用 x-api-key 请求头。

API 端点

直接使用 OpenAPI 端点：

bash
POST $YOUMINDBASEURL/openapi/v1/webSearch

必需的请求头：

bash
x-api-key: $YOUMINDAPIKEY
x-use-camel-case: true
Content-Type: application/json

请求结构

请求体字段：

• - query 字符串，必填
• category 字符串，可选

• - freshness 字符串，可选

• - includeDomains 字符串数组，可选
• excludeDomains 字符串数组，可选

主要工作流程

1. 1. 构建请求体
2. 发送 POST 请求到 /openapi/v1/webSearch
3. 首先读取 results（结果）
4. 总结最相关的结果及其含义
5. 优先选择少量高信号链接，而非大量低质量结果

示例

通用网络搜索

bash
curl -sS -X POST $YOUMINDBASEURL/openapi/v1/webSearch \
-H x-api-key: $YOUMINDAPIKEY \
-H x-use-camel-case: true \
-H Content-Type: application/json \
-d {
query: OpenAI Responses API,
category: general
}

最新新闻搜索

bash
curl -sS -X POST $YOUMINDBASEURL/openapi/v1/webSearch \
-H x-api-key: $YOUMINDAPIKEY \
-H x-use-camel-case: true \
-H Content-Type: application/json \
-d {
query: OpenAI latest announcement,
category: news,
freshness: day
}

按域名限制搜索

bash
curl -sS -X POST $YOUMINDBASEURL/openapi/v1/webSearch \
-H x-api-key: $YOUMINDAPIKEY \
-H x-use-camel-case: true \
-H Content-Type: application/json \
-d {
query: structured outputs,
category: general,
includeDomains: [openai.com, platform.openai.com]
}

学术搜索

bash
curl -sS -X POST $YOUMINDBASEURL/openapi/v1/webSearch \
-H x-api-key: $YOUMINDAPIKEY \
-H x-use-camel-case: true \
-H Content-Type: application/json \
-d {
query: multimodal agents,
category: scholar,
includeDomains: [arxiv.org]
}

推荐用法

默认行为：

1. 1. 除非有更合适的特定类别，否则使用 general（通用）。
2. 对于新闻类或快速变化的话题，添加 freshness（时效性）。
3. 当权威来源很重要时，添加 includeDomains（包含域名）。
4. 使用 excludeDomains（排除域名）来移除低质量来源。
5. 首先返回最相关的结果，然后总结其含义。

响应结构

典型响应字段：

• - providerId（提供商 ID）
• results（结果）
• totalResults（结果总数）
• visibleCount（可见数量）
• formattedContext（格式化上下文）

每个结果可能包含：

• - title（标题）
• url（链接）
• displayUrl（显示链接）
• snippet（摘要）
• favicon（网站图标）
• datePublished（发布日期）
• thumbnail（缩略图）