功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

免费网页搜索工具

概述

免费网页搜索工具是一款面向个人用户的轻量级联网搜索解决方案。通过 Playwright 驱动无头浏览器，智能路由 Bing 国内版与 DuckDuckGo，为中文用户提供精准、快速的搜索体验。无需任何 API Key 配置，安装依赖后即可立即使用。

核心能力

已知限制

执行已知限制操作,使用input_params参数进行配置,支持创建/查询/导出等操作。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

单次查询最多返回 10 条结果

单次查询最多返回 10 条结果

输出: 返回单次查询最多返回 10 条结果的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

正文抓取上限为 5 条

正文抓取上限为 5 条，单页截断 8000 字

输出: 返回正文抓取上限为 5 条的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持批量查询和结果导出

不支持批量查询和结果导出

输出: 返回不支持批量查询和结果导出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持自定义代理配置

不支持自定义代理配置

输出: 返回不支持自定义代理配置的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持定时任务调度

不支持定时任务调度

输出: 返回不支持定时任务调度的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

输出: 返回已知限制的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级联网搜索工、Bing、DuckDuckGo、双引擎自动路由、中文环境优化、适合个人日常信息、核心能力、Playwright、的无头浏览器搜索、稳定可靠、地理位置探测、自动选择国内、可选正文抓取、按需获取目标网页、全文内容、中文环境默认优化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：技术问题检索

个人开发者遇到技术问题时，快速搜索解决方案。

python scripts/web_search.py "Python 异步编程 优选实践 2026" --max=10

预期输出包含相关技术博客、官方文档链接和社区讨论，帮助快速定位解决方案。

场景二：新闻资讯获取

用户希望了解最新时事动态，通过关键词搜索获取新闻。

py "2026年 中国航天 发射计划" --max=5

返回最近相关新闻报道，包含标题、摘要和来源链接。

场景三：学习资料查找

学生查找特定主题的学习资源。

py "机器学习 入门教程 免费" --full=3

不仅返回搜索结果列表，还抓取前 3 条结果的正文内容，方便深度阅读。

不适用场景

以下场景免费网页搜索工具不适合处理：

• 黑帽SEO手段
• 搜索引擎作弊
• 付费广告投放管理

触发条件

需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于非本工具能力范围的需求。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

依赖详情

# 安装 Python 依赖
pip install playwright

# 安装 Chromium 浏览器引擎（约 150 MB）
playwright install chromium

执行首次搜索

py "你的搜索关键词" --max=10

验证安装

py "hello world" --max=3

如果返回 3 条搜索结果，说明安装成功。

示例

基础搜索配置

# 默认自动路由（推荐）

# 强制使用 Bing 国内版
py "Python 教程" --region=cn

# 强制使用 DuckDuckGo 国际版
py "Python tutorial" --region=intl

参数说明

优选实践

搜索关键词优化

关键词撰写原则

1. 简洁精准：2-5 个核心词组合，避免长句、反问句
2. 限定明确：需要时效性/地区内容时加上对应限定词
3. 格式正确：中文关键词 + 数字/英文限定词
4. 避免口语化：使用搜索语法而非自然语言提问

隐私保护建议

• 不需要正文抓取时，保持 --full=0，仅访问搜索引擎
• 定期清理浏览器上下文，避免 Cookie 累积
• 在公共网络环境使用时，注意搜索内容敏感性

常见问题

搜索返回空结果

# 检查网络连通性
ping cn.bing.com

# 尝试切换搜索引擎
py "测试关键词" --region=intl

可能原因及解决方案：

• 网络限流：等待几分钟后重试
• 地区误判：使用 --region 强制指定引擎
• 关键词过长：精简到 2-5 个核心词

浏览器启动失败

# 重新安装 Playwright 依赖
pip install --upgrade playwright
playwright install chromium

# 验证安装
python -c "from playwright.sync_api import sync_playwright; print('OK')"

正文抓取失败

部分站点使用重度 JS 渲染或返回非 HTML 内容，免费版不做特殊处理。建议：

• 减少抓取数量，仅抓取 --full=1 或 --full=2
• 尝试更换搜索关键词，获取不同来源结果

IP 探测失败

工具依次探测 4 个公开 IP 服务，若全部失败则默认使用 DuckDuckGo。可通过 --region=cn 或 --region=intl 手动覆盖。

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Python 版本：3.8 及以上
• 网络环境：需可访问 Bing 或 DuckDuckGo

第三方依赖

API Key 配置

• 免费版无需任何 API Key
• 无需注册任何第三方服务
• 安装依赖后即可直接使用

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
• 适用人群：个人开发者、学生、研究人员
• 升级建议：如需批量查询、结果导出、定时任务等高级功能，请使用 PRO 版本

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据