Free Web Search Ultimate v11.0 — Search-First Paradigm
Overview
This skill enables real-time web search and page browsing for any LLM agent. It introduces a Search-First approach to knowledge acquisition: instead of relying solely on training data, the agent should use live web search as the primary source for factual, technical, and time-sensitive information.
Core Behavior Guidelines
When this skill is active, the agent should follow these guidelines:
Guideline 1 — Search Before Answering: For questions involving facts, current events, software versions, statistics, people, companies, or technical documentation, call search-web before generating a response.
Guideline 2 — Treat Training Data as a Starting Point: Training data has a cutoff date. For any claim that may have changed recently, verify it via search.
Guideline 3 — Deep-Dive When Needed: If search snippets don't provide enough detail, use browse-page to read the full source document.
Guideline 4 — Always Cite Sources: Every factual statement in the final response should be accompanied by the source URL from search results.
Guideline 5 — Prefer News for Recency: For anything that happened in the last year, use search-web --type news to get the most recent information.
Available Commands
search-web — Real-Time Web Search
CODEBLOCK0
browse-page — Deep Page Reading
CODEBLOCK1
Decision Tree for Agents
CODEBLOCK2
Why Search-First?
| Default LLM Behavior | Search-First Behavior |
|---|
| Answers from training data | Answers from live web |
| Knowledge cutoff applies |
Always up-to-date |
| May produce outdated facts | Cites verifiable sources |
| Single knowledge source | Multi-source cross-validation |
Integration
This skill works with:
- - OpenClaw — native skill integration
- Claude Desktop / Cursor — via MCP server (
free-web-search-mcp) - LangChain — via Python tool wrappers
- OpenAI Function Calling — via JSON schema definitions
MCP Server Setup (Claude Desktop / Cursor)
Add to your claude_desktop_config.json:
CODEBLOCK3
Install via pip from the GitHub repository:
CODEBLOCK4
Requirements
- - Python 3.8+
- INLINECODE7 ,
lxml, ddgs, INLINECODE10
License
MIT-0 — Free to use, modify, and redistribute. No attribution required.
Free Web Search Ultimate v11.0 — 搜索优先范式
概述
本技能使任何LLM代理能够进行实时网络搜索和页面浏览。它引入了一种搜索优先的知识获取方法：代理不应仅依赖训练数据，而应将实时网络搜索作为获取事实、技术和时效性信息的主要来源。
核心行为准则
当此技能激活时，代理应遵循以下准则：
准则1 — 先搜索再回答：对于涉及事实、时事、软件版本、统计数据、人物、公司或技术文档的问题，在生成回复前先调用search-web。
准则2 — 将训练数据视为起点：训练数据有截止日期。对于任何可能近期发生变化的说法，通过搜索进行验证。
准则3 — 必要时深入挖掘：如果搜索结果摘要未提供足够细节，使用browse-page阅读完整源文档。
准则4 — 始终引用来源：最终回复中的每个事实陈述都应附带搜索结果中的来源URL。
准则5 — 新闻优先获取最新信息：对于过去一年内发生的任何事情，使用search-web --type news获取最新信息。
可用命令
search-web — 实时网络搜索
bash
通用知识（默认）
search-web 查询内容
当前事件和新闻
search-web 查询内容 --type news
图片
search-web 查询内容 --type images
学术/书籍
search-web 查询内容 --type books
视频
search-web 查询内容 --type videos
特定区域（例如中文）
search-web 查询内容 --region zh-cn
时间限制（d=天, w=周, m=月, y=年）
search-web 查询内容 --timelimit w
机器可读的JSON输出
search-web 查询内容 --json
browse-page — 深度页面阅读
bash
读取URL的完整内容
browse-page https://example.com/article
JSON输出
browse-page https://example.com/article --json
代理决策树
用户提出问题
│
▼
是否纯属创意/假设性问题？
是 → 直接回答
否 ▼
是否涉及事实、事件、版本或数据？
是 ▼
运行：search-web <查询内容> [如果是近期事件则加 --type news]
│
▼
摘要是否足以回答？
是 → 综合回答 + 引用来源
否 ▼
运行：browse-page <最佳结果URL>
│
▼
根据完整页面内容综合回答 + 引用来源
为什么选择搜索优先？
| 默认LLM行为 | 搜索优先行为 |
|---|
| 从训练数据中回答 | 从实时网络中回答 |
| 知识截止日期适用 |
始终保持最新 |
| 可能产生过时事实 | 引用可验证来源 |
| 单一知识来源 | 多源交叉验证 |
集成
本技能支持：
- - OpenClaw — 原生技能集成
- Claude Desktop / Cursor — 通过MCP服务器（free-web-search-mcp）
- LangChain — 通过Python工具包装器
- OpenAI Function Calling — 通过JSON模式定义
MCP服务器设置（Claude Desktop / Cursor）
添加到您的claudedesktopconfig.json：
json
{
mcpServers: {
free-web-search: {
command: free-web-search-mcp,
args: []
}
}
}
通过pip从GitHub仓库安装：
bash
pip install git+https://github.com/wd041216-bit/free-web-search-ultimate.git
要求
- - Python 3.8+
- beautifulsoup4、lxml、ddgs、mcp>=1.1.2
许可证
MIT-0 — 可自由使用、修改和重新分发。无需署名。
