{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m2y7n7cg3mks","handle":"mcpcn-web-search-mcp","url":"https://wellknown.network/agents/mcpcn-web-search-mcp","links":{"self":"https://wellknown.network/agents/mcpcn-web-search-mcp/record.json","html":"https://wellknown.network/agents/mcpcn-web-search-mcp","markdown":"https://wellknown.network/agents/mcpcn-web-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mcpcn-web-search-mcp","status":"https://wellknown.network/api/v1/agents/mcpcn-web-search-mcp/status","claim":"https://wellknown.network/agents/mcpcn-web-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcpcn-web-search-mcp/claim.json","badge":"https://wellknown.network/agents/mcpcn-web-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcpcn-web-search-mcp/history","tools":"https://wellknown.network/api/v1/agents/mcpcn-web-search-mcp/tools"},"ard":{"identifier":"urn:air::server:mcpcn-web-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcpcn-web-search-mcp","summary":"Multi-source web search MCP server with automatic failover","description":"# Web Search MCP Server\n\n多源网页搜索 MCP 服务器，支持自动故障转移。专为国内用户优化，无需 VPN 即可使用。\n\n## 特性\n\n- **VPN 自动检测**: 自动检测网络环境，开启 VPN 用国际源，未开启用国内源\n- **多搜索源支持**: 国内源（必应中国、百度、搜狗、360）+ 国际源（DuckDuckGo、Google News、Wikipedia）\n- **自动故障转移**: 如果一个源失败，自动尝试下一个\n- **语言检测**: 自动为中日韩文查询调整搜索参数\n- **灵活输出**: 文本（人类可读）或 JSON（结构化）格式\n- **网页抓取**: 从 URL 提取可读内容\n- **无需 API Key**: 所有搜索源均为免费\n\n## 安装\n\n```bash\n# 从源码安装\npip install -e .\n\n# 或使用 uv\nuv pip install -e .\n```\n\n## 搜索源\n\n| 源 | 描述 | 国内可用 |\n|-----|------|---------|\n| `bing_china` | 必应中国 (cn.bing.com) | ✅ |\n| `baidu` | 百度搜索 | ✅ |\n| `sogou` | 搜狗搜索 | ✅ |\n| `so360` | 360搜索 (so.com) | ✅ |\n| `ddg_lite` | DuckDuckGo Lite | ❌ 需VPN |\n| `google_news_rss` | Google News RSS | ❌ 需VPN |\n| `wikipedia` | Wikipedia OpenSearch | ❌ 需VPN |\n\n### 默认优先级\n\n**自动检测 VPN 状态：**\n\n- **VPN 开启**: DuckDuckGo → Google News → Wikipedia → 必应中国 → 百度 → 搜狗 → 360\n- **VPN 关闭**: 必应中国 → 百度 → 搜狗 → 360\n\n首次搜索时会自动检测网络环境（尝试访问 Google），结果会缓存避免重复检测。\n\n## 使用\n\n### 运行服务器\n\n```bash\n# 直接执行\nmcpcn-web-search-mcp\n\n# 或通过 Python\npython -m web_search_mcp.server\n```\n\n### Claude Desktop 配置\n\n添加到 `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"web-search\": {\n      \"command\": \"mcpcn-web-search-mcp\"\n    }\n  }\n}\n```\n\n或使用 `uv`:\n\n```json\n{\n  \"mcpServers\": {\n    \"web-search\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/web-search-mcp\",\n        \"run\",\n        \"mcpcn-web-search-mcp\"\n      ]\n    }\n  }\n}\n```\n\n## 工具\n\n### web_search\n\n使用多个搜索源搜索互联网，支持自动故障转移。\n\n**参数:**\n\n| 名称 | 类型 | 默认值 | 描述 |\n|------|------|--------|------|\n| `query` | string | 必填 | 搜索查询词 |\n| `max_results` | int | 10 | 最大结果数 (1-20) |\n| `format` | string | \"text\" | 输出格式: \"text\" 或 \"json\" |\n| `sources` | string | \"\" | 逗号分隔的源列表 |\n\n**示例:**\n\n```python\n# 文本格式（默认）\nweb_search(query=\"Python 教程\", max_results=5)\n\n# JSON 格式\nweb_search(query=\"最新AI新闻\", format=\"json\")\n\n# 指定搜索源\nweb_search(query=\"机器学习\", sources=\"baidu,bing_china\")\n\n# 仅使用国际源\nweb_search(query=\"machine learning\", sources=\"ddg_lite,wikipedia\")\n```\n\n### fetch_webpage\n\n从 URL 获取并提取可读内容。\n\n…","publisher":null,"homepage":null,"repository":null,"version":"0.1.5","license":"MIT","protocols":["mcp"],"tags":["duckduckgo","mcp","serpapi","web-search","wikipedia"],"pricing":null,"endpoints":[{"url":"pypi:mcpcn-web-search-mcp","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"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"},{"slug":"data.news","name":"News & Feeds","confidence":0.722,"provenance":"derived"}],"categories":["data"],"language":"fr"},"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":"mcpcn-web-search-mcp","registry":"pypi","observedAt":"2026-10-28T10:24:27.783Z","publishedAt":"2026-02-11T05:22:07.755377Z","latestVersion":"0.1.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcpcn-web-search-mcp","url":"https://pypi.org/project/mcpcn-web-search-mcp/","firstSeenAt":"2026-09-10T01:19:18.607Z","fetchedAt":"2026-10-28T10:23:23.986Z","normalizedAt":"2026-10-28T10:23:23.986Z"}]},"firstSeenAt":"2026-09-10T01:19:18.607Z","updatedAt":"2026-10-28T10:24:27.783Z"}