内容
<div align="center">
# Webify
**自适应网络研究，为 AI 编程代理提供服务**
91% 的深度研究质量 · 5% 的成本 · 在每个 MCP 客户端中都有效
[](https://pypi.org/project/webify-mcp/)
[](LICENSE)
[](https://www.python.org/)
[GrapeRoot](https://graperoot.dev) 开发的技能
**文档：** [中文](docs/README.zh-CN.md) · [日本語](docs/README.ja.md) · [한국어](docs/README.ko.md) · [Español](docs/README.es.md) · [हिन्दी](docs/README.hi.md) · [Français](docs/README.fr.md) · [Deutsch](docs/README.de.md) · [Português](docs/README.pt-BR.md) · [Русский](docs/README.ru.md)
</div>
---
## 2 步安装
```bash
pip install webify-mcp
claude mcp add webify -- webify-mcp
```
就这样。它适用于 Claude Code、Cursor、VS Code、Windsurf 和 Zed。
---
## 功能介绍
Webify 为您的 AI 提供两种网络研究工具 — 两者都比阅读完整页面更便宜：
| 工具 | 使用场景 | 成本 |
|------|------------|------|
| `web_find(query)` | 研究问题，任何需要搜索的内容 | ~$0.003/query |
| `web_lookup(url, query)` | 您知道确切的 URL | ~$0.0005/query |
### web_find — 多源研究
```
查询 → 搜索（Brave/DDG）→ 并行图构建（3–6 个来源）
→ BM25 多方面提取 → Haiku 合成 → 答案
```
根据查询的复杂性调整深度。简单问题会命中 3 个来源。多维研究可扩展到 6+，并具有独立的子方面检索。多次调用它，并使用聚焦的子查询进行深度研究级别的覆盖。
### web_lookup — 单页检索
```
URL → 获取 → 语义图 → BFS 遍历 → ~250–750 个令牌
```
根据您的查询对节点进行评分，只返回相关的子树 — 80–300 个令牌，而不是 WebFetch 放入上下文的 3,000–15,000 个令牌。
---
## 基准测试
针对 Claude 的深度研究的盲 A/B 测试 — 15 个未见查询，随机顺序，Sonnet 评判器评分准确性 + 完整性 + 特异性（1–5 每个）。
| | Webify | 深度研究 |
|--|--------|--------------|
| **质量** | 68/75 · 91% | 73/75 · 97% |
| **每查询成本** | ~$0.003 | ~$0.05+ |
| **延迟** | 30–90s | 80–280s |
| **成本效率** | **18× 更好** | 基线 |
Webify 每次都能找到正确的信息。差距始终是完整性 — 深度研究会读取更多内容。对于大多数查询，这种差异并不重要；对于详尽的研究，请多次调用 `web_find`。
<details>
<summary>每查询分解</summary>
| 查询 | Webify | 深度研究 |
|-------|--------|--------------|
| 电池降解 | 13/15 | 15/15 |
| OAuth 与 OIDC | 13/15 | 15/15 |
| 珊瑚礁白化 | 14/15 | 15/15 |
| CRISPR 基因编辑 | **15/15** | 13/15 |
| 地震和海啸 | 13/15 | 15/15 |
</details>
---
## AI 如何使用它
安装后，AI 会自动使用 Webify 进行网络研究，而不是昂贵的内置工具 — 无需配置。偏好策略已嵌入到软件包本身。
```
> Raft 和 Paxos 共识之间有什么权衡？
→ Claude 调用 web_find() — 搜索，构建图，合成答案
> 在 GitHub API 文档中查找速率限制
→ Claude 调用 web_lookup() — 获取该页面，只返回相关部分
```
---
## 工具特定设置
### Claude Code
```bash
pip install webify-mcp
claude mcp add webify -- webify-mcp
```
### Cursor · Windsurf · VS Code (Continue/Cline) · Zed
将以下内容添加到您的 MCP 配置文件中：
```json
{
"mcpServers": {
"webify": {
"command": "webify-mcp"
}
}
}
```
配置文件位置：
- **Cursor** → `~/.cursor/mcp.json`
- **Windsurf** → `~/.windsurf/settings.json`
- **VS Code / Continue** → `~/.continue/config.json`
- **Zed** → `~/.config/zed/settings.json`
### 任何其他 MCP 客户端
- **命令：** `webify-mcp`
- **传输：** stdio
---
## 更新
```bash
pip install --upgrade webify-mcp
```
---
## 配置
| 环境变量 | 是否必需 | 描述 |
|---------|----------|-------------|
| `ANTHROPIC_API_KEY` | 对于 `web_find` | Haiku 合成 |
| `BRAVE_SEARCH_API_KEY` | 推荐 | 可靠搜索 · [免费 2k/月](https://brave.com/search/api/) |
| `WEBIFY_CACHE_DIR` | 否 | 缓存目录 · 默认 `~/.cache/webify` |
**搜索：** Brave API（如果设置了密钥）→ DuckDuckGo Lite（免费备用，无需密钥）
### 设置密钥
**macOS / Linux** — 添加到 `~/.zshrc` 或 `~/.bashrc`：
```bash
export ANTHROPIC_API_KEY="sk-ant-..."
export BRAVE_SEARCH_API_KEY="BSA..."
```
**Windows (PowerShell)：**
```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-...", "User")
[Environment]::SetEnvironmentVariable("BRAVE_SEARCH_API_KEY", "BSA...", "User")
```
**在您的 MCP 配置文件中**（仅适用于 Webify）：
```json
{
"mcpServers": {
"webify": {
"command": "webify-mcp",
"env": {
"ANTHROPIC_API_KEY": "sk-ant-...",
"BRAVE_SEARCH_API_KEY": "BSA..."
}
}
}
}
```
获取您的密钥：
- Anthropic → https://console.anthropic.com/settings/keys
- Brave Search → https://brave.com/search/api/
---
## CLI 使用
```bash
# 为 URL 构建图
python -m webify build https://docs.python.org/3/library/json.html
# 查找特定信息
python -m webify lookup https://docs.python.org/3/library/json.html "解析 JSON 字符串"
```
## Python 库
```python
import webify
# 多源搜索
result = webify.web_find("mtls 在服务网格中如何工作")
print(result["content"]) # 合成答案
print(result["sources"]) # [{url, title, confidence, tokens}]
# 单页查找
result = webify.smart_lookup("https://docs.python.org/3/library/json.html", "解析 JSON")
print(result["content"]) # 仅相关部分（~376 个令牌）
```
---
## 故障排除
```bash
webify-mcp # 测试服务器（Ctrl+C 退出）
ls ~/.cache/webify/ # 检查缓存
```
- **`webify-mcp: command not found`** → 运行 `pip install webify-mcp`
- **工具未显示** → 在添加配置后重启编辑器
- **`web_find` 错误** → 设置 `ANTHROPIC_API_KEY`
- **`web_find` 返回无结果** → DDG 限流；设置 `BRAVE_SEARCH_API_KEY`
---
## License
[MIT](LICENSE) · Copyright © 2026 [GrapeRoot](https://graperoot.dev)
