YouMind Search Skill

Search the public Internet through YouMind Search.

Prefer this skill when the task is mainly about:

• fresh external information
• online research
• recent news
• source gathering
• domain-filtered web lookup

Do not use this skill for the user's private YouMind library. Use the general

youmind skill for library search or broader YouMind operations.

Why use it

YouMind Search is not a thin wrapper over one search provider.

It combines multiple high-quality search providers, then applies YouMind's own

ranking, filtering, and result shaping to improve quality.

Authentication

This skill requires a YouMind account and API key.

If you do not have an API key yet:

1. Sign up at https://youmind.com
2. Open Settings
3. Generate an API key
4. Set YOUMIND_API_KEY before making requests

Use the production endpoint by default:

export YOUMIND_BASE_URL=https://youmind.com
export YOUMIND_API_KEY=sk-ym-xxx

For local development or staging, override YOUMIND_BASE_URL as needed.

Authentication uses the x-api-key header.

API Endpoint

Use the OpenAPI endpoint directly:

POST $YOUMIND_BASE_URL/openapi/v1/webSearch

Required headers:

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

Request Schema

Request body fields:

• query string, required
• category string, optional
• general
• video
• news
• tweet
• finance
• scholar
• image
• freshness string, optional
• day
• week
• month
• year
• includeDomains string array, optional
• excludeDomains string array, optional

Primary Workflow

1. Build the request body
2. POST to /openapi/v1/webSearch
3. Read results first
4. Summarize the strongest hits and what they imply
5. Prefer a few high-signal links over noisy breadth

Examples

General Web Search

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

Fresh News Search

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

Domain-Restricted Search

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

Scholar Search

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

Recommended Usage

Default behavior:

1. Use general unless a more specific category is clearly better.
2. Add freshness for newsy or fast-changing topics.
3. Add includeDomains when authoritative sources matter.
4. Use excludeDomains to remove low-signal sources.
5. Return the strongest matches first, then summarize what they imply.

Response Shape

Typical response fields:

• providerId
• results
• totalResults
• visibleCount
• formattedContext

Each result may include:

• title
• url
• displayUrl
• snippet
• favicon
• datePublished
• thumbnail