Serpapi MCP Server

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

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

评分 : 2分

下载量 : 7.8K

更新时间 : 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密钥？

为什么我的请求失败？

支持哪些语言和地区？

安装

复制以下命令到你的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视频及字幕等功能的使用方法。您可以根据需求调用不同的API，并按照示例请求进行操作。若遇到问题，可参考故障排除部分。

✨ 主要特性

搜索API：支持Google搜索，可自定义查询内容、结果数量、国家代码、语言代码等参数。
YouTube视频：可获取指定YouTube视频的详细信息。
YouTube字幕：能获取指定YouTube视频的字幕，支持指定字幕语言。

📦 安装指南

文档中未提及安装步骤，暂不提供相关内容。

💻 使用示例

基础用法

搜索API - Google搜索

Google搜索API需要以下参数：

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

示例请求代码如下：

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())

YouTube视频

获取YouTube视频信息需要以下参数：

参数	详情
`v`	YouTube视频ID
`api_key`	SerpAPI密钥

示例请求代码如下：

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字幕

获取YouTube字幕需要以下参数：

参数	详情
`video_url`	YouTube视频的URL或ID
`language`	要获取的字幕语言（默认为英语）

示例请求代码如下：

import youtube_transcript_api

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