you-web-search

Performs web searches via the You.com Search API with cited, freshness-filtered results.

714|255|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon --skill you-web-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: you-web-search
Source: https://github.com/aaronjmars/aeon/tree/main/skills/you-web-search
Command: npx skills add https://github.com/aaronjmars/aeon --skill you-web-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding current, high-quality web information with proper citations and freshness control requires an authenticated search API rather than generic built-in search, and this Skill provides that path through You.com.

Core Features & Use Cases

  • Authenticated You.com Search: Executes direct API calls with relevance-ranked web and news results including titles, URLs, snippets, and publication dates.
  • Freshness and Live Crawl Control: Filters results by recency (day, week, month, year) and optionally fetches full page content via the livecrawl parameter.
  • Logging and Notification: Delivers formatted results through notifications and appends search activity to daily memory logs for pattern tracking.
  • Use Case: A researcher needs the latest developments on a crypto token before writing a market analysis; the Skill queries You.com with a week freshness filter and returns cited, dated sources.

Quick Start

Search the web using You.com for the latest news on AI regulation from the past week and show me the top cited results.

Frequently Asked Questions about you-web-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web using the You.com API?

Set the YDC_API_KEY environment variable, then the Skill sends an authenticated GET request to the You.com Search API endpoint with your query, count, and safesearch parameters. Results are parsed from the web and news sections into title, URL, snippet, and date fields.

You.com Search API vs built-in WebSearch, which should I use?

You.com provides relevance-ranked results with citations, freshness filters, and optional live page crawling, but requires an API key. Built-in WebSearch has no API dependency and is always available, making it better for general fallback search flows.

What API key do I need for You.com web search?

You need a You.com API key set as the YDC_API_KEY environment variable. The Skill checks for this key before executing and stops with a clear error if it is unset, since unauthenticated calls are not supported.

How do I filter You.com search results by date or freshness?

Set the YOUCOM_FRESHNESS environment variable to day, week, month, year, or a date range. The value is passed as the freshness query parameter, defaulting to week when unset.

Why does the You.com search fail with a 401 or 429 error?

A 401 means the YDC_API_KEY is invalid or rejected, so verify the key value. A 429 indicates the plan's rate limit was hit; reduce scheduling frequency and check your API quota before retrying.