youmind-search

# 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: ```bash 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: ```bash POST $YOUMIND_BASE_URL/openapi/v1/webSearch ``` Required headers: ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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`