内容
# 工具列表
**为您的 AI 代理提供网页搜索功能，无需 API 密钥，无需注册。**
适用于任何 MCP 代理（Claude Desktop、Cursor、Windsurf 等）的网页搜索示例。您的代理可以搜索实时网页，获取最近的新闻，并以干净的 Markdown 格式读取任何页面；在后台，它使用 **x402** 通过您控制的钱包在 Base 上以 USDC 支付每次调用的费用。
Superhighway 是 **Wall #001**，是 [walls.sh](https://walls.sh) 的一部分 - 一个 AI 代理付费的业务目录。
## 工具
| 工具 | 功能 | 价格 |
|---|---|---|
| `web_search` | 实时网页搜索 → 排名结果为干净的 JSON | $0.001 |
| `news_search` | 最近的新闻文章，附有发布时间 | $0.001 |
| `image_search` | 图片搜索 → 图片网址、来源页面、缩略图 | $0.001 |
| `scrape` | 读取任何页面 → 标题 + 干净的 Markdown + 文本 | $0.002 |
| `research` | 搜索 + 读取顶部页面，一次调用 | $0.005 |
## 免费试用（无需钱包）
打开 **[superhighway.walls.sh](https://superhighway.walls.sh)** 并在框中运行搜索 - 无需钱包，无需注册。当您准备将其提供给您的代理时，请设置以下 MCP 服务器。
## 5 分钟设置
如果您是新手，请按照 **[TUTORIAL.md](TUTORIAL.md)** 进行 - 钱包 → 充值 → 配置 → 询问，步骤一步步来。
## 安装（Claude Desktop / Cursor / Windsurf）
将以下内容添加到您的 MCP 客户端配置中（`claude_desktop_config.json`，Cursor `mcp.json` 等）：
```json
{
"mcpServers": {
"superhighway": {
"command": "npx",
"args": ["-y", "superhighway-mcp"],
"env": {
"AGENT_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY",
"X402_NETWORK": "base"
}
}
}
}
```
重启您的客户端。您的代理现在拥有五个工具：`web_search`、`news_search`、`image_search`、`scrape` 和 `research`（搜索 + 读取，一次调用）。找到它，读取它，按次支付。
参见 [`examples/claude_desktop_config.json`](examples/claude_desktop_config.json)。
## 获取钱包
`AGENT_PRIVATE_KEY` 是您控制的任何 EVM 钱包，充值少量 **Base 上的 USDC**（每次调用 $0.001-$0.002；汽油费由促进者承担，因此您不需要 ETH）。保持少量余额 - 密钥仅签署微小的 USDC 支付。使用 viem 生成一个：
```bash
node -e 'const {generatePrivateKey}=require("viem/accounts");console.log(generatePrivateKey())'
```
想要先支付 **测试** USDC？设置 `X402_NETWORK=base-sepolia` 并从 [Base Sepolia 水龙头](https://faucet.circle.com) 为地址充值。
## 在代理框架中使用
- **LangChain / LangGraph** → [`examples/langchain_agent.py`](examples/langchain_agent.py)
- **LlamaIndex** → [`examples/llamaindex_agent.py`](examples/llamaindex_agent.py)
- **CrewAI** → [`examples/crewai_agent.py`](examples/crewai_agent.py)
<details><summary>LangChain 快速入门</summary>
将工具加载到 LangChain/LangGraph 代理中 - 参见 [`examples/langchain_agent.py`](examples/langchain_agent.py)：
```bash
pip install langchain-mcp-adapters langgraph langchain-openai
AGENT_PRIVATE_KEY=0x... python examples/langchain_agent.py
```
</details>
## 在 n8n 中使用
安装原生社区节点 - 无需 HTTP 连接：
1. **设置 → 社区节点 → 安装**，输入 `n8n-nodes-superhighway`
2. 在工作流中添加 **Superhighway** 节点，创建 **Superhighway API** 凭证，附带来自 [/pricing](https://superhighway.walls.sh/pricing) 的免费 API 密钥
3. 选择操作（网页搜索、新闻搜索、图片搜索、读取页面、研究），输入查询，执行
完整指南：[将实时网页搜索添加到 n8n、Make 或 Zapier 工作流](https://superhighway.walls.sh/guides/web-search-n8n-make-zapier)
## 不使用 MCP（原始 x402）
任何可以签署 x402 支付的代理都可以直接调用 API - 参见 [`examples/agent.mjs`](examples/agent.mjs)：
```bash
npm i x402-fetch viem
AGENT_PRIVATE_KEY=0x... X402_NETWORK=base node examples/agent.mjs "best espresso machines"
```
## 比较
参见 **[COMPARISON.md](COMPARISON.md)** - Superhighway 与 ScrapingBee / Serper / ScreenshotOne / Google Geocoding（按次付费，无 API 密钥，无注册）。
## 指南
Superhighway.walls.sh 上的逐步文档：
- [将实时网页搜索添加到 Claude Code（或任何 MCP 客户端）](https://superhighway.walls.sh/guides/add-web-search-to-claude-code) - 安装 MCP 服务器，充值钱包，使用五个工具
- [将实时网页搜索添加到 LangChain、LlamaIndex 或 CrewAI 代理](https://superhighway.walls.sh/guides/web-search-langchain-llamaindex-crewai) - MCP 适配器 + Python 框架的 REST API 路径
- [将实时网页搜索添加到 OpenAI Agents SDK 代理](https://superhighway.walls.sh/guides/web-search-openai-agents-sdk) - MCPServerStdio 路径或带有 API 密钥的 @function_tool
- [将实时网页搜索添加到 Pydantic AI 代理](https://superhighway.walls.sh/guides/web-search-pydantic-ai) - MCPServerStdio 路径或带有 API 密钥的 @agent.tool_plain
- [AI 代理可以自行付费的网页搜索 API](https://superhighway.walls.sh/guides/web-search-api-agents-pay-per-call) - x402 按次付费流程，步骤一步步来
- [适用于 AI 代理的图片搜索：直接网址、缩略图和视觉上下文](https://superhighway.walls.sh/guides/image-search-for-ai-agents) - 使用 `/images` 进行视觉定位和多模态代理
- [获取答案，而不是链接：在一次 API 调用中搜索 + 读取顶部页面](https://superhighway.walls.sh/guides/search-and-read-in-one-call) - 解释 `/research` 端点
- [将实时网页搜索添加到 n8n、Make 或 Zapier 工作流](https://superhighway.walls.sh/guides/web-search-n8n-make-zapier) - 原生 n8n 社区节点 + Make/Zapier 的 HTTP 请求
## 链接
- 软件包：https://github.com/patwalls/superhighway-mcp
- 实时 API + 免费演示：https://superhighway.walls.sh
- 指南：https://superhighway.walls.sh/guides
- 目录：https://walls.sh
- x402 协议：https://x402.org
MIT.
