Serpapi MCP Server

该项目是一系列基于SerpAPI和YouTube的MCP服务器，为AI助手提供多种搜索功能，包括Google搜索、新闻、学术、趋势、财经、地图、图片以及YouTube搜索和字幕获取。

搜索工具研究与数据 #搜索服务 #AI集成 #数据获取 #MCP协议 .Python

评分 : 2分

下载量 : 7

更新时间 : 2025-04-29

什么是SerpApi MCP Server?

SerpApi MCP Server是一组基于Model Context Protocol (MCP)的Python服务器，旨在通过整合Google搜索、新闻、学术、趋势、金融、地图、图片以及YouTube搜索和字幕等功能，为AI助手提供强大的搜索能力。

如何使用SerpApi MCP Server?

您只需简单配置并运行服务器，然后将其连接到支持MCP的AI助手（如Claude for Desktop）。通过几个简单的步骤即可开始使用。

适用场景

适用于需要快速获取信息、进行数据分析或内容创作的场景，比如教育、科研、市场分析等领域。

主要功能

Google搜索支持全面的Google搜索功能，包括新闻、学术、趋势、金融、地图和图片。

YouTube搜索轻松找到相关视频并获取其字幕内容。

多种语言和国家支持支持多国语言及地区设置，满足国际化需求。

优势与局限性

优势

快速集成Google和YouTube数据源。

支持多种自定义参数，满足多样化需求。

易于部署且兼容多种AI助手。

高质量API接口确保精准搜索结果。

局限性

需要有效的SerpAPI订阅。

某些高级功能可能受API配额限制。

需要一定的Python基础来配置环境。

如何使用

安装依赖

下载代码并创建虚拟环境，安装所需依赖。

配置API密钥

在.env文件中添加您的SerpAPI密钥。

启动服务器

运行相应的服务器脚本，例如Google搜索服务器。

使用案例

案例1: 学术研究查找关于气候变化的最新学术论文。

案例2: 新闻追踪获取最近关于人工智能的新闻报道。

常见问题

如何申请SerpAPI密钥？

为什么我的请求失败？

支持哪些语言和地区？

相关资源

SerpAPI官方文档

了解SerpAPI的更多功能和参数。

GitHub代码仓库

获取代码和示例配置。

MCP协议说明

了解MCP协议的工作原理。

安装

复制以下命令到你的Client进行配置

{
  "mcpServers": {
    "serpapi-google-search": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_search.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-youtube-search": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_youtube_search.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-news": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_news.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-trend": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_trend.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-scholar": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_scholar.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-finance": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_finance.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-maps": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_maps.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "serpapi-google-images": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/serpapi_google_images.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    },
    "youtube-transcript": {
      "type": "stdio",
      "command": "path/to/python",
      "args": [
        "path/to/serpapi-mcp-server/src/youtube_transcript.py"
      ],
      "env": {
        "PYTHONPATH": "path/to/site-packages"
      }
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 使用指南

本使用指南详细介绍了搜索API、YouTube视频及字幕相关的使用方法，同时包含故障排除、许可证、致谢和相关资源等信息。

🚀 快速开始

本指南将帮助您快速上手使用搜索API、获取YouTube视频信息和字幕。按照以下步骤操作，您可以轻松完成相关请求。

✨ 主要特性

提供Google搜索API，可自定义搜索参数，如结果数量、起始位置、国家和语言等。
支持获取YouTube视频的详细信息和字幕。
包含故障排除指南，帮助您解决常见问题。

📦 安装指南

文档未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

Google搜索

以下是使用Google搜索API的基础示例，您需要提供必要的参数，如api_key和search_term。

import requests

url = "https://google.serper.dev/search"
params = {
    "api_key": "your_api_key",
    "search_term": "Python 教程",
    "num": 10,
    "start": 1,
    "gl": "us",
    "hl": "en"
}

response = requests.get(url, params=params)
print(response.json())

Google搜索API的参数说明如下：

属性	详情
`api_key`	用于身份验证的SerpAPI密钥
`search_term`	要查询的内容
`num`	要获取的结果数量（最大值为100）
`start`	结果的起始位置（从1开始）
`gl`	国家代码（例如，'us' - 美国，'uk' - 英国）
`hl`	语言代码（例如，'en' - 英语，'es' - 西班牙语）
`device`	设备类型（'desktop' - 台式机，'tablet' - 平板，'mobile' - 手机）
`filter`	过滤结果（1 - 启用类似结果和省略结果的过滤，0 - 禁用）

YouTube视频

以下是获取YouTube视频详细信息的基础示例，您需要提供视频ID和API密钥。

import requests

url = "https://youtube.googleapis.com/v3/videos"
params = {
    "part": "snippet,statistics",
    "id": "your_video_id",
    "key": "your_api_key"
}

response = requests.get(url, params=params)
print(response.json())

YouTube视频API的参数说明如下：

属性	详情
`v`	YouTube视频ID
`api_key`	SerpAPI密钥

YouTube字幕

以下是获取YouTube视频字幕的基础示例，您需要提供视频的URL或ID和要获取的字幕语言。

import youtube_transcript_api

transcript = youtube_transcript_api.get_transcript(
    "https://www.youtube.com/watch?v=your_video_id",
    language="zh-CN"
)
print(transcript)

YouTube字幕API的参数说明如下：