web-search-local

无需API密钥的本地网页搜索技能，支持多引擎自动切换和内置缓存。

触发条件

当用户提出以下请求时使用此技能：

• - 搜索/查一下/搜一下 + 关键词
• 帮我找/帮我搜 + 信息
• 需要获取实时网络信息
• 最近/最新 + 某话题
• 查资料/网上查

使用方法

基础搜索

bash
python3 scripts/search.py -q 关键词

指定引擎

bash
python3 scripts/search.py -q 关键词 -e bing # Bing（默认）
python3 scripts/search.py -q 关键词 -e auto # 自动故障转移
python3 scripts/search.py -q 关键词 -e webfetch # urllib回退

常用选项

bash
python3 scripts/search.py -q 关键词 -l 5 # 限制结果数量
python3 scripts/search.py -q 关键词 --fast # 快速模式，跳过cookies
python3 scripts/search.py -q 关键词 --no-cache # 跳过缓存
python3 scripts/search.py -q 关键词 -f text # 文本格式输出
python3 scripts/search.py -q 关键词 -o file.json # 输出到文件
python3 scripts/search.py -q 关键词 -v # 详细日志

引擎选择

默认为bing，失败时使用auto。

缓存机制

• - 位置：~/.cache/web-search-local/
• 过期时间：1小时
• 缓存命中可在亚秒内返回

缓存管理

bash
python3 scripts/search.py --cache-stats # 查看缓存统计
python3 scripts/search.py --cache-clear # 清除缓存

输出格式

JSON（默认）

bash
python3 scripts/search.py -q 关键词 -f json

json
{
query: 搜索关键词,
engine: bing,
count: 3,
results: [
{title: 页面标题, url: https://..., snippet: 摘要描述}
],
elapsed_seconds: 0.58
}

文本

bash
python3 scripts/search.py -q 关键词 -f text

搜索：Python编程
引擎：bing
结果：2
============================================================

1. 1. Python.org - 官方网站

注意事项

• - 中文搜索针对cn.bing.com优化
• 每次搜索有2-5秒延迟（反爬虫策略）
• 缓存命中时无延迟
• 不支持需要登录的内容

详细文档

• - 详细用法和示例：参见references/search-usage.md
• 自动引擎技术规范：参见references/search-auto-engine.md