AI代理网络搜索与内容提取服务

为AI代理提供优化的网络搜索和内容提取服务,特别支持俄语和CIS地区的Yandex搜索以及全球Google搜索。

  • by AntonKiya
  • TypeScript
  • 混合部署
  • 1 星标
  • 更新于
在 GitHub 查看 AntonKiya/web-compass

使用说明

网络指南针

用于AI代理的MCP服务器——通过Yandex和谷歌进行网络搜索和内容提取,针对RU/CIS和全球结果进行了优化。

为什么

大多数人工智能搜索工具都是围绕英语网络构建的。该项目通过Yandex为俄罗斯和独联体搜索以及全球谷歌搜索添加了一流的支持,使其对需要处理RU/CIS内容的代理非常有用。

工具

每个工具都可以通过MCP(主要)和REST API(次要)获得。

search_yandex

通过Yandex搜索网页。针对俄罗斯和独联体的结果进行了优化。

  • query --搜索查询
  • topK --结果数量(1-10)
  • region — russia (默认)或 cis

search_google

通过谷歌在全球范围内搜索网络。

  • query --搜索查询
  • topK --结果数量(1-10)

extract

按URL获取页面并提取主要可读内容。

  • urls --URL列表(1-10)

search_and_extract_yandex

通过Yandex进行搜索,并在一个管道中从结果中提取内容。

  • query --搜索查询
  • topK --结果数量(1-10)
  • region — russia (默认)或 cis

search_and_extract_google

通过谷歌搜索,并在一个管道中从结果中提取内容。

  • query --搜索查询
  • topK --结果数量(1-10)

每个工具还具有相应的REST端点: POST /search-yandex, POST /search-google, POST /extract, POST /search-and-extract-yandex, POST /search-and-extract-google

连接到MCP客户端

将服务器添加到MCP客户端配置中。Claude Desktop示例(claude_desktop_config.json):

{
  "mcpServers": {
    "web-compass": {
      "url": "http://localhost:3000/mcp",
      "transportType": "streamable-http"
    }
  }
}

对于其他客户(Cursor、Windsurf等),请指向 http://your-host:3000/mcp 和 streamable-http 运输。

在幕后

搜索由 SerpAPI 它提供了对Yandex和谷歌搜索结果的访问,而无需抓取。内容提取用途 Mozilla可读性 --Firefox阅读器模式背后的相同引擎。

需要SerpAPI密钥。得到一个在 蛇网.

将其添加到您的 .env:

SERPAPI_KEY=your_key_here

看 .env.example 获取所需环境变量的完整列表。

跑步

发展:

npm run start:dev

生产:

npm run build && npm run start:prod