you.com Web Search
Free web search, deep research, and content extraction — no mandatory API key for basic search.
Tools
| Need | Tool | Cost | API Key |
|---|
| General web search | INLINECODE0 | Free | ❌ |
| Deep research with citations |
youcom_research | Paid | ✅ |
| Extract content from URLs |
youcom_extract | Paid | ✅ |
Quick Start
Free Search (no setup)
CODEBLOCK0
Research / Extract (requires API key)
CODEBLOCK1
Setup
Free Search
No setup required —
youcom_search works immediately.
Research & Extract (Paid)
- 1. Get an API key at you.com/platform/api-keys
- Add to
~/.openclaw/.env:
YOUCOM_API_KEY=your_key_here
- 3. Restart the gateway: INLINECODE5
youcom_search — Free Web Search
Use for all general web searches. No API key needed.
CODEBLOCK3
| Option | Description |
|---|
| INLINECODE6 | Search term (required) |
| INLINECODE7 , INLINECODE8 |
Results to return, 1–10 (default: 5) |
|
--out,
-o | Write JSON to file instead of stdout |
Output: JSON with query, count, and results[] (title, url, description, snippets).
Tips:
- - Supports search operators:
site:reddit.com, filetype:pdf, INLINECODE16 - Results include social snippets when available
- Uses python3
urllib — no external dependencies
youcom_research — Deep Research (Paid)
Synthesized answer with citations. Requires YOUCOM_API_KEY.
CODEBLOCK4
| Option | Description |
|---|
| INLINECODE19 | Research topic (required) |
| INLINECODE20 , INLINECODE21 |
lite, standard (default), deep, exhaustive |
⚠️ Always confirm cost with user before using paid endpoints.
youcom_extract — Content Extraction (Paid)
Extract clean text from specific URLs. Requires YOUCOM_API_KEY.
CODEBLOCK5
| Option | Description |
|---|
| INLINECODE23 | One or more URLs (space-separated) |
| INLINECODE24 , INLINECODE25 |
Output formats: markdown, html, metadata (default: markdown metadata) |
|
--timeout,
-t | Crawl timeout per URL in seconds 1–60 (default: 10) |
Max 20 URLs per call. Batch larger lists into multiple calls.
When to Use What
| Need | Tool |
|---|
| Quick lookup | INLINECODE28 |
| Comprehensive analysis |
youcom_research |
| Specific page content |
youcom_extract |
| Cloudflare/GitHub blocks |
youcom_search — bypasses them |
Escalation Order
CODEBLOCK6
When free search is insufficient, escalate to paid research.
Troubleshooting
"YOUCOMAPIKEY environment variable is not set"
The API key is not loaded. Source your
.env or restart the gateway:
CODEBLOCK7
"HTTP Error 401 / 403"
Invalid or expired API key. Check or regenerate at
you.com/platform/api-keys.
"HTTP Error 429"
Rate limit hit. Wait 30 seconds and retry.
"name or service not known"
DNS failure. Check internet connection.
Python Dependencies
No third-party dependencies. Uses Python standard library only:
- -
urllib.request — HTTP GET/POST - INLINECODE34 — URL encoding
- INLINECODE35 — JSON parsing
- INLINECODE36 — CLI argument parsing
API Endpoints Used
| Tool | Method | Endpoint |
|---|
| INLINECODE37 | GET | INLINECODE38 |
| INLINECODE39 |
POST |
https://api.you.com/v1/research |
|
youcom_extract | POST |
https://ydc-index.io/v1/contents |
you.com 网页搜索
免费网页搜索、深度研究和内容提取——基础搜索无需强制使用API密钥。
工具
| 需求 | 工具 | 费用 | API密钥 |
|---|
| 通用网页搜索 | youcomsearch | 免费 | ❌ |
| 带引用的深度研究 |
youcomresearch | 付费 | ✅ |
| 从URL提取内容 | youcom_extract | 付费 | ✅ |
快速开始
免费搜索（无需配置）
bash
python3 scripts/youcom_search.py 搜索查询 --num 5
研究/提取（需要API密钥）
bash
export YOUCOM
APIKEY=你的密钥
python3 scripts/youcom_research.py 主题 --depth deep
python3 scripts/youcom_extract.py https://example.com/article
配置
免费搜索
无需配置——youcom_search 可立即使用。
研究与提取（付费）
- 1. 在 you.com/platform/api-keys 获取API密钥
- 添加到 ~/.openclaw/.env：
YOUCOMAPIKEY=你的密钥
- 3. 重启网关：systemctl --user restart openclaw-gateway
youcom_search — 免费网页搜索
用于所有通用网页搜索。无需API密钥。
bash
python3 scripts/youcom_search.py 查询 [--num N]
| 选项 | 描述 |
|---|
| query | 搜索词（必填） |
| --num, -n |
返回结果数量，1–10（默认：5） |
| --out, -o | 将JSON写入文件而非标准输出 |
输出： 包含 query、count 和 results[]（标题、URL、描述、摘要）的JSON。
提示：
- - 支持搜索运算符：site:reddit.com、filetype:pdf、time:week
- 结果在可用时包含社交摘要
- 使用python3 urllib——无外部依赖
youcom_research — 深度研究（付费）
带引用的综合回答。需要 YOUCOMAPIKEY。
bash
python3 scripts/youcom_research.py 主题 [--depth lite|standard|deep|exhaustive]
| 选项 | 描述 |
|---|
| query | 研究主题（必填） |
| --depth, -d |
lite、standard（默认）、deep、exhaustive |
⚠️ 使用付费端点前务必与用户确认费用。
youcom_extract — 内容提取（付费）
从特定URL提取纯文本。需要 YOUCOMAPIKEY。
bash
python3 scripts/youcom_extract.py [...] [--formats markdown html metadata] [--timeout 10]
| 选项 | 描述 |
|---|
| urls | 一个或多个URL（空格分隔） |
| --formats, -f |
输出格式：markdown、html、metadata（默认：markdown metadata） |
| --timeout, -t | 每个URL的爬取超时时间（秒），1–60（默认：10） |
每次调用最多20个URL。 将较大列表分批多次调用。
何时使用何种工具
youcomresearch |
| 特定页面内容 | youcom_extract |
| Cloudflare/GitHub屏蔽 | youcom_search——可绕过 |
升级顺序
youcomsearch（免费）→ youcomresearch（付费，先确认）→ youcom_extract（付费，先确认）
当免费搜索不足时，升级到付费研究。
故障排除
YOUCOMAPIKEY environment variable is not set
API密钥未加载。加载你的 .env 或重启网关：
bash
source ~/.openclaw/.env
systemctl --user restart openclaw-gateway
HTTP Error 401 / 403
API密钥无效或已过期。在
you.com/platform/api-keys 检查或重新生成。
HTTP Error 429
达到速率限制。等待30秒后重试。
name or service not known
DNS故障。检查网络连接。
Python依赖
无第三方依赖。仅使用Python标准库：
- - urllib.request — HTTP GET/POST
- urllib.parse — URL编码
- json — JSON解析
- argparse — CLI参数解析
使用的API端点
| 工具 | 方法 | 端点 |
|---|
| youcomsearch | GET | https://api.you.com/v1/agents/search |
| youcomresearch |
POST | https://api.you.com/v1/research |
| youcom_extract | POST | https://ydc-index.io/v1/contents |
