{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5ckkaruva43w","handle":"websearch-mcp-tools","url":"https://wellknown.network/agents/websearch-mcp-tools","links":{"self":"https://wellknown.network/agents/websearch-mcp-tools/record.json","html":"https://wellknown.network/agents/websearch-mcp-tools","markdown":"https://wellknown.network/agents/websearch-mcp-tools/record.md","api":"https://wellknown.network/api/v1/agents/websearch-mcp-tools","status":"https://wellknown.network/api/v1/agents/websearch-mcp-tools/status","claim":"https://wellknown.network/agents/websearch-mcp-tools/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/websearch-mcp-tools/claim.json","badge":"https://wellknown.network/agents/websearch-mcp-tools/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:websearch-mcp-tools","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"websearch-mcp-tools","summary":"MCP server providing web search capabilities for LLMs","description":"# Web Search MCP Server\n\n为 LLM 提供网页搜索能力的 MCP 服务器，支持从网页和新闻文章中获取并提取内容。\n\n## 功能特性\n\n- **双搜索模式**:\n  - **常规搜索**: 从博客、文档、文章等获取多样化的搜索结果\n  - **新闻搜索**: 从新闻源获取最新新闻文章和突发新闻\n- **实时网页搜索**: 搜索任意主题，获取最新结果\n- **内容提取**: 自动提取文章主要内容，过滤广告和无关信息\n- **多种传输模式**: 支持 stdio、streamable-http、SSE 三种部署方式\n- **负载均衡**: 支持多个 API 密钥，自动轮询分配\n- **速率限制**: 内置速率限制（每小时 200 次），防止 API 滥用\n- **结构化输出**: 返回包含元数据（标题、来源、日期、URL）的格式化内容\n- **灵活结果**: 控制返回结果数量（1-20 条）\n\n## 前置要求\n\n1. **Serper API 密钥**: 在 [serper.dev](https://serper.dev) 注册获取 API 密钥\n2. **Python 3.10+**: 确保已安装 Python\n3. **uv**: Python 包管理器（通过 `curl -LsSf https://astral.sh/uv/install.sh | sh` 安装）\n4. **MCP 兼容的 LLM 客户端**: 如 Claude Desktop、Cursor 或任何支持 MCP 的应用\n\n## 安装\n\n1. 克隆或下载此仓库\n2. 使用 uv 安装依赖：\n   ```bash\n   uv sync\n   ```\n\n3. 设置 Serper API 密钥：\n   ```bash\n   export SERPER_API_KEYS=\"your-api-key-here\"\n   ```\n   支持多密钥负载均衡，用逗号分隔：\n   ```bash\n   export SERPER_API_KEYS=\"key1,key2,key3\"\n   ```\n\n## 使用方法\n\n### 启动 MCP 服务器\n\n服务器支持三种传输模式：\n\n#### stdio 模式（Claude Desktop 默认）\n```bash\nuv run python main.py --transport stdio\n```\n\n#### streamable-http 模式\n```bash\nuv run python main.py --transport http --port 7860\n```\n\n#### SSE 模式\n```bash\nuv run python main.py --transport sse --port 7860\n```\n\n#### 使用已安装的命令\n```bash\n# 安装后可通过 pip install -e .\nweb-search-mcp --transport stdio\n```\n\n**命令行选项**：\n- `--transport`: 传输模式（`stdio`、`http`、`sse`），默认：`stdio`\n- `--port`: HTTP/SSE 模式端口，默认：`7860`\n- `--log-level`: 日志级别（`DEBUG`、`INFO`、`WARNING`、`ERROR`），默认：`INFO`\n\n**环境变量**：\n- `SERPER_API_KEYS`: 逗号分隔的 API 密钥，用于负载均衡\n- `PORT`: 覆盖默认端口（7860）\n- `LOG_LEVEL`: 覆盖默认日志级别（INFO）\n\n### 连接 LLM 客户端\n\n#### Claude Desktop（stdio 模式）\n在 `claude_desktop_config.json` 中添加：\n```json\n{\n  \"mcpServers\": {\n    \"web-search\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/web-search-mcp\", \"python\", \"main.py\", \"--transport\", \"stdio\"],\n      \"env\": {\n        \"SERPER_API_KEYS\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n或使用已安装的命令：\n```json\n{\n  \"mcpServers\": {\n    \"web-search\": {\n      \"command\": \"web-search-mcp\",\n      \"ar…","publisher":{"name":"songm_d","url":null},"homepage":null,"repository":null,"version":"0.3.2","license":"MIT","protocols":["mcp"],"tags":["mcp","web-search","llm","serper"],"pricing":null,"endpoints":[{"url":"pypi:websearch-mcp-tools","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"websearch-mcp-tools","registry":"pypi","observedAt":"2026-09-10T15:25:26.819Z","publishedAt":"2026-03-05T02:59:40.437856Z","latestVersion":"0.3.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"websearch-mcp-tools","url":"https://pypi.org/project/websearch-mcp-tools/","firstSeenAt":"2026-09-10T15:24:26.893Z","fetchedAt":"2026-09-10T15:24:26.893Z","normalizedAt":"2026-09-10T15:24:26.893Z"}]},"firstSeenAt":"2026-09-10T15:24:26.893Z","updatedAt":"2026-09-10T15:25:26.819Z"}