Serpapi MCP Server

This project is a series of MCP servers based on SerpAPI and YouTube, providing AI assistants with various search functions, including Google Search, News, Scholar, Trends, Finance, Maps, Images, as well as YouTube Search and caption retrieval.

Search tools Research and data #Search Service #AI Integration #Data Acquisition #MCP Protocol .Python

rating : 2 points

downloads : 7.9K

update time : 2025-04-29

Open Site

What is SerpApi MCP Server?

SerpApi MCP Server is a set of Python servers based on the Model Context Protocol (MCP). It aims to provide powerful search capabilities for AI assistants by integrating functions such as Google Search, News, Scholar, Trends, Finance, Maps, Images, as well as YouTube Search and captions.

How to use SerpApi MCP Server?

You simply need to configure and run the server, and then connect it to an AI assistant that supports MCP (such as Claude for Desktop). You can start using it through a few simple steps.

Applicable Scenarios

It is suitable for scenarios that require quick access to information, data analysis, or content creation, such as education, scientific research, and market analysis.

Main Features

Google Search

Supports comprehensive Google Search functions, including News, Scholar, Trends, Finance, Maps, and Images.

YouTube Search

Easily find relevant videos and obtain their caption content.

Support for Multiple Languages and Countries

Supports language and region settings of multiple countries to meet internationalization needs.

Advantages

Quickly integrate Google and YouTube data sources.

Support multiple custom parameters to meet diverse needs.

Easy to deploy and compatible with multiple AI assistants.

High - quality API interfaces ensure accurate search results.

Limitations

Requires a valid SerpAPI subscription.

Some advanced features may be limited by API quotas.

Requires a certain foundation in Python to configure the environment.

How to Use

Install Dependencies

Download the code, create a virtual environment, and install the required dependencies.

Configure API Key

Add your SerpAPI key to the .env file.

Start the Server

Run the corresponding server script, such as the Google Search server.

Usage Examples

Case 1: Academic Research

Find the latest academic papers on climate change.

Case 2: News Tracking

Get the latest news reports on artificial intelligence.

Frequently Asked Questions

How to apply for a SerpAPI key?

Why did my request fail?

Which languages and regions are supported?

Related Resources

SerpAPI Official Documentation

Learn more about SerpAPI's functions and parameters.

GitHub Code Repository

Get the code and example configurations.

MCP Protocol Description

Understand how the MCP protocol works.

Installation

Copy the following command to your Client for configuration

{
  "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"
      }
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 Usage Guide

This guide provides detailed information on using various APIs, including search APIs, YouTube video retrieval, and YouTube subtitle extraction. It also covers troubleshooting tips, licensing details, acknowledgments, and useful resources.

📚 Documentation

Search API

Google Search

api_key: SerpAPI key for authentication.
search_term: The content to be queried.
num: The number of results to retrieve (maximum value is 100).
start: The starting position of the results (starting from 1).
gl: Country code (e.g., 'us' - United States, 'uk' - United Kingdom).
hl: Language code (e.g., 'en' - English, 'es' - Spanish).
device: Device type ('desktop' - Desktop, 'tablet' - Tablet, 'mobile' - Mobile).
filter: Filter results (1 - Enable filtering of similar and omitted results, 0 - Disable).

Example Request

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 Video

v: YouTube video ID.
api_key: SerpAPI key.

Example Request

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 Subtitles

video_url: URL or ID of the YouTube video.
language: The language of the subtitles to retrieve (default is English).

Example Request

import youtube_transcript_api

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