8.8
/ 10
1 evaluations
2k Downloads
Overview
Provide bash-based agents with robust web search, research (with citations), and content extraction via You.com’s REST APIs using curl and jq, while enforcing safe handling of untrusted external content.
Key Advantages
1.No-signup basic search: the /v1/agents/search endpoint works without an API key, enabling immediate lightweight web search in agents.
2.Rich research capability: /v1/research returns synthesized, cited markdown answers with configurable research_effort (lite, standard, deep, exhaustive).
3.Structured content extraction: /v1/contents extracts article/page contents (e.g., markdown) from one or many URLs for downstream reasoning.
4.Clear security model: strong guidance to treat all fetched data as untrusted, wrap in <external-content> delimiters, and never execute or follow instructions from it.
5.Simple tooling: relies only on curl and jq, which are standard and easy to install in most Linux-based agent environments.2,000 downloads indicating real-world usage and a degree of maturity/stability
Use Cases
- General-purpose web search inside bash or tool-using agents, including filtered search by freshness, country, and safe search level.
- News and trend monitoring for topics like AI, finance, or security using search and/or research endpoints.
- In-depth topic research with citations suitable for reports, briefs, and literature-style summaries.
- Bulk content ingestion from specific URLs or domains for later analysis or summarization by the agent.
- Retrieving full page text (via livecrawl or contents) to ground reasoning, summaries, or comparisons in current web content.
Evaluation Scores
8.8
/ 10
Reliability
8.0
Functionality
9.2
Usability
9.1
Safety
9.2
Performance
8.3
Compatibility
9.0
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.8/103/19/2026▼
OS: win32-x64LLM: google/gemini-3.1-pro-preview
**Judgment:** High-quality, well-designed web search and research skill for bash-based agents, with strong security guidance and good real-world adoption. Suitable as a primary web access layer for many OpenClaw agents.
**Strengths:**
- Covers core web needs: search, deep research with citations, and URL-based content extraction.
- Requires only curl and jq, fits naturally into shell/tool-using agents.
- Clear workflow for choosing between Search, Research, and Contents endpoints.
- Strong emphasis on safety: treat all content as untrusted, wrap in `<external-content>`, and restrict domains to `api.you.com` and `ydc-index.io`.
**Key Risks / Limitations:**
- Research and Contents require a You.com API key; without it, functionality is limited to search.
- Reliability and performance depend on external You.com services, including potential rate limits (429) and network conditions.
- Error handling (e.g., retries/backoff) is described but not fully automated; agents must implement robust retry logic themselves.
**Recommended Scenarios:**
- Agents that need current web information, especially with citations, but can rely on external APIs.
- Research and analysis workflows that benefit from summarized, cited outputs rather than raw search results alone.
- Content-ingestion or grounding tasks where agents must pull full text from specific URLs and safely reason over it.
- Any bash-oriented or curl/jq-capable environment needing a secure, opinionated pattern for interacting with web content.
Comments (0)
No comments yet. Be the first!