Google Trends MCP Server

⚠️ 重要安全通知：切勿将API密钥提交到版本控制中。此包需要通过环境变量设置API密钥。

这是一个MCP（模型上下文协议）服务器，通过Google Trends Scraper API提供对Google Trends数据的访问。

功能

• 状态：检查API的状态和健康状况
• 问题：获取来自Google Trends的趋势问题
• 趋势：获取来自Google Trends的当前趋势话题

安装

选项1：使用npx（推荐）

# 首先设置您的API密钥
export GOOGLE_TRENDS_API_KEY="your-api-key-here"

# 使用npx直接运行
npx @andrewlwn77/google-trends-mcp

选项2：全局安装

npm install -g @andrewlwn77/google-trends-mcp

选项3：本地开发

git clone <repository-url>
cd google-trends-mcp
npm install
npm run build

配置

可选：您可以设置GOOGLE_TRENDS_API_KEY环境变量。如果没有设置，则会使用默认API密钥。

1. 从RapidAPI Google Trends Scraper获取API密钥。
2. 设置环境变量：

   # 选项1：在您的shell中导出
   export GOOGLE_TRENDS_API_KEY="your-api-key-here"
   
   # 选项2：创建一个.env文件（用于本地开发）
   echo "GOOGLE_TRENDS_API_KEY=your-api-key-here" > .env
   

⚠️ 安全：切勿将您的.env文件或API密钥提交到版本控制！

使用

运行服务器

# 如果是全局安装或使用npx
google-trends-mcp

# 对于本地开发
npm start

# 开发时自动重载
npm run dev

可用工具

1. google_trends_status

检查Google Trends API的状态。

参数：

• language（可选）：语言代码（默认："en"）
• country（可选）：国家代码（默认："US"）

2. google_trends_questions

获取来自Google Trends的趋势问题。

参数：

• language（可选）：语言代码（默认："en"）
• country（可选）：国家代码（默认："US"）

3. google_trends_trending

获取来自Google Trends的当前趋势话题。

参数：

• language（可选）：语言代码（默认："en"）
• country（可选）：国家代码（默认："US"）

示例用法与MCP客户端

// 检查API状态
const status = await client.callTool('google_trends_status', {
  language: 'en',
  country: 'US'
});

// 获取趋势问题
const questions = await client.callTool('google_trends_questions', {
  language: 'en',
  country: 'US'
});

// 获取趋势话题
const trending = await client.callTool('google_trends_trending', {
  language: 's',
  country: 'US'
});

配置

服务器可以通过环境变量进行配置：

• GOOGLE_TRENDS_API_KEY：您用于Google Trends Scraper API的RapidAPI密钥（可选，默认为示例密钥）

开发

项目结构

google-trends-mcp/
├── src/
│   ├── index.ts      # 主MCP服务器实现
│   └── types.ts      # TypeScript类型定义
├── tests/
│   ├── integration/  # API集成测试
│   ├── unit/         # 单元测试
│   └── helpers/      # 测试辅助工具
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

类型安全性

此服务器使用TypeScript编写，并提供了完整的类型安全性：

• API参数
• API响应
• 错误处理
• Google Trends数据结构

许可证

MIT