gomarble-ai/google-ads-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

146 stars 47 forks Качество 78 Тренд 20MIT

gomarble-ai/google-ads-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/gomarble-ai/google-ads-mcp-server.

Обзор

gomarble-ai/google-ads-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/gomarble-ai/google-ads-mcp-server.

Обзор (машинный перевод)

Сервер Model Context Protocol на базе FastMCP для интеграции Google Ads API с автоматической аутентификацией OAuth 2.0

Подключите API Google Ads напрямую к Claude Desktop и другим MCP-клиентам с помощью бесшовной аутентификации OAuth 2.0, автоматического обновления токенов, запросов GAQL и возможностей поиска ключевых слов.

Ваш браузер не поддерживает тег видео.

Простая настройка в один клик

Для более простой настройки мы предлагаем готовых установщиков:

👉 Скачать установщик - https://gomarble.ai/mcp

Присоединяйтесь к нашему сообществу для помощи и обновлений

👉 Сообщество Slack - ИИ в рекламе

Попробуйте также Facebook ads mcp server

👉 Facebook Ads MCP - Facebook Ads MCP

✨ Особенности

🔐 Automatic OAuth 2.0 — одноразовая аутентификация браузера с автообновлением
🔄 Smart Token Management — автоматически обрабатывает просроченные токены
📊 GAQL Query Execution - Запустите любые запросы на языке запросов Google Ads
🏢 Управление аккаунтами - Список и управление аккаунтами Google Ads
🔍 Исследование ключевых слов — генерация идей для ключевых слов на основе данных о объёме поиска
🚀 FastMCP Framework — построен на современном стандарте MCP
🖥️ Claude Desktop Ready — прямая интеграция с Claude Desktop

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Google Ads MCP Server 🚀

A FastMCP-powered Model Context Protocol server for Google Ads API integration with automatic OAuth 2.0 authentication

Connect Google Ads API directly to Claude Desktop and other MCP clients with seamless OAuth 2.0 authentication, automatic token refresh, GAQL querying, and keyword research capabilities.

Your browser does not support the video tag.

Easy One-Click Setup

For a simpler setup experience, we offer ready-to-use installers:

👉 Download installer - https://gomarble.ai/mcp

Join our community for help and updates

👉 Slack Community - AI in Ads

Try Facebook ads mcp server also

👉 Facebook Ads MCP - Facebook Ads MCP

✨ Features

🔐 Automatic OAuth 2.0 - One-time browser authentication with auto-refresh
🔄 Smart Token Management - Handles expired tokens automatically
📊 GAQL Query Execution - Run any Google Ads Query Language queries
🏢 Account Management - List and manage Google Ads accounts
🔍 Keyword Research - Generate keyword ideas with search volume data
🚀 FastMCP Framework - Built on the modern MCP standard
🖥️ Claude Desktop Ready - Direct integration with Claude Desktop
🛡️ Secure Local Storage - Tokens stored locally, never exposed

📋 Available Tools

Tool	Description	Parameters	Example Usage
`list_accounts`	List all accessible Google Ads accounts	None	“List all my Google Ads accounts”
`run_gaql`	Execute GAQL queries with custom formatting	`customer_id`, `query`, `manager_id` (optional)	“Show me campaign performance for account 1234567890”
`run_keyword_planner`	Generate keyword ideas with metrics	`customer_id`, `keywords`, `manager_id`, `page_url`, date range options	“Generate keyword ideas for ‘digital marketing’”

Note: All tools automatically handle authentication - no token parameters required!

🚀 Quick Start

Prerequisites

Before setting up the MCP server, you’ll need:

Python 3.10+ installed
A Google Cloud Platform account
A Google Ads account with API access

🔧 Step 1: Google Cloud Platform Setup

1.1 Create Google Cloud Project

Go to Google Cloud Console
Create a new project:
- Click “Select a project” → “New Project”

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "google-ads": {
      "command": "/full/path/to/your/project/.venv/bin/python",
      "args": [
        "/full/path/to/your/project/server.py"
      ]
    }
  }
}