SerpApi MCP Server - Python

SerpApi MCP Server - Python

site icon
2025.04.10 0
Python搜索工具内容生成搜索工具内容生成
SerpApi MCP Server 是一个基于 Python 的 Model Context Protocol (MCP) 服务器集合,旨在为 AI 助手(如 Claude)提供与 SerpAPI 和 YouTube 集成的搜索功能和数据检索能力。该服务器支持多种 Google 服务和 YouTube 的搜索操作,包括 Google 搜索、新闻、学术、趋势、金融、地图、图片以及 YouTube 搜索和视频字幕提取。
View on GitHub

Overview

基本能力

产品定位

SerpApi MCP Server 主要为 AI 助手提供搜索和数据检索功能,使其能够通过 MCP 协议与 SerpAPI 和 YouTube 进行交互。

核心功能

  • Google 搜索 (serpapi_google_search.py)
  • Google 新闻 (serpapi_google_news.py)
  • Google 学术 (serpapi_google_scholar.py)
  • Google 趋势 (serpapi_google_trend.py)
  • Google 金融 (serpapi_google_finance.py)
  • Google 地图 (serpapi_google_maps.py)
  • Google 图片 (serpapi_google_images.py)
  • YouTube 搜索 (serpapi_youtube_search.py)
  • YouTube 字幕 (youtube_transcript.py)

适用场景

  • AI 助手需要实时搜索信息(如新闻、学术论文、金融数据等)。
  • 需要从 YouTube 获取视频信息或字幕。
  • 需要集成多种 Google 服务的数据检索功能。

工具列表

  • serpapi_google_search.py: 提供 Google 搜索功能。
  • serpapi_google_news.py: 提供 Google 新闻搜索功能。
  • serpapi_google_scholar.py: 提供 Google 学术搜索功能。
  • serpapi_google_trend.py: 提供 Google 趋势搜索功能。
  • serpapi_google_finance.py: 提供 Google 金融数据检索功能。
  • serpapi_google_maps.py: 提供 Google 地图搜索功能。
  • serpapi_google_images.py: 提供 Google 图片搜索功能。
  • serpapi_youtube_search.py: 提供 YouTube 视频搜索功能。
  • youtube_transcript.py: 提供 YouTube 视频字幕提取功能。

常见问题解答

  • 无效的 API 密钥: 检查 .env 文件中的 API 密钥配置,确保密钥有效且无多余字符。
  • 请求失败: 检查网络连接、API 调用配额和请求参数格式。

使用教程

使用依赖

  • Python 3.8 或更高版本
  • SerpAPI API 密钥(从 serpapi.com 获取)

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/serpapi-mcp-server.git
cd serpapi-mcp-server
  1. 创建虚拟环境并安装依赖:
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
  1. 创建 .env 文件并添加 API 密钥:
cp .env.example .env
  1. 编辑 .env 文件:
SERPAPI_API_KEY=your_api_key_here

调试方式

  1. 运行服务器:
python src/serpapi_google_search.py  # 或其他服务器文件
  1. 检查日志和错误信息,确保 API 密钥和网络连接正常。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。