YouMind Search

Search the public Internet with YouMind Search. Combines multiple high-quality providers with YouMind ranking and filtering for better results than using one...

Security Scan

The skill is an instruction-only wrapper for the YouMind web search API and its requirements and instructions are consistent with that purpose.

Purpose & Capability

Name, description, and declared requirement (YOUMIND_API_KEY) align with a web-search integration. The documented endpoints, headers, and request fields match a typical search API usage.

Instruction Scope

SKILL.md's runtime instructions are narrowly scoped to building POST requests to YouMind's /openapi/v1/webSearch and summarizing results. One minor inconsistency: the document references YOUMIND_BASE_URL (and gives an example to set it) but only YOUMIND_API_KEY is declared in the metadata; YOUMIND_BASE_URL appears optional and not required by the registry metadata.

Install Mechanism

There is no install spec and no code files — the skill is instruction-only and does not write code to disk or download external artifacts.

Credentials

The skill only requires a single API key (YOUMIND_API_KEY), which is proportional for accessing a third-party search API. The SKILL.md additionally suggests an optional YOUMIND_BASE_URL override; the registry did not declare that env var, so users should be aware it's used if present.

Persistence & Privilege

The skill does not request persistent installation or elevated privileges; always is false and there are no config-path or system-modifying instructions.

Assessment

This skill appears to be a straightforward wrapper around YouMind's web search API and only needs your YouMind API key. Before installing, verify you trust youmind.com (check the provider's homepage and privacy policy), and avoid sending sensitive or private data through the skill because queries and results go to an external service. Note the SKILL.md mentions an optional YOUMIND_BASE_URL override (for staging); the registry only declared the API key. If you don't have or don't want to share a YouMind API key with the agent, do not enable this skill.

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