Udostępnij przez

SuperMCP (wersja zapoznawcza)

SuperMCP firmy Supermetrics — serwer MCP (Model Context Protocol) zapewniający dostęp do danych marketingowych z połączonych platform, takich jak Google Analytics, Facebook Ads, Google Ads i inne.

Ten interfejs API umożliwia llMs wykonywanie zapytań dotyczących danych marketingowych, odnajdywanie źródeł danych i kont, eksplorowanie dostępnych pól i pobieranie metryk wydajności.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Supermetrics
adres URL https://supermetrics.com
Metadane łącznika
Publisher Supermetrics
Witryna internetowa https://supermetrics.com
Zasady ochrony prywatności https://supermetrics.com/privacy
Kategorie Marketing

Łącznik niestandardowy SuperMCP (supermetryki)

Ten łącznik umożliwia usługom Microsoft Power Automate, Power Apps i Azure Logic Apps wykonywanie zapytań dotyczących danych marketingowych za pośrednictwem serwera MCP SuperMCP .
Służy do odnajdywania źródeł danych i kont, eksplorowania dostępnych pól i uruchamiania zapytań dotyczących wydajności marketingu.

Publisher

Supermetrics

Typ łącznika

Łącznik niestandardowy (Swagger/OpenAPI 2.0)

Usługa/interfejs API

Interfejs API SuperMCP (serwer MCP)

  • Gospodarz:mcp.supermetrics.com
  • Ścieżka podstawowa:/
  • Schemat:https

Wymagania wstępne

Potrzebne będą następujące elementy:

  • Środowisko usługi Power Automate lub Power Apps, w którym można tworzyć łączniki niestandardowe
  • Konto Supermetryki z co najmniej jednym połączonym źródłem danych (np. Google Analytics, Google Ads, Facebook Ads itp.). Jeśli nie masz konta Supermetrics, zostanie utworzone jedno z 14-dniową wersją próbną podczas pierwszego logowania.

Authentication

Ten łącznik używa protokołu OAuth 2.0.

Obsługiwane operacje

Odkrycie

  • Odnajdywanie dostępnych źródeł danych Supermetrics (POST /mcp/data_source_discovery)
  • Odnajdywanie kont dla źródła danych (POST /mcp/accounts_discovery)
  • Odnajdywanie dostępnych pól (POST /mcp/field_discovery)

Zapytanie o dane

  • Uruchamianie zapytania asynchronicznego danych (POST /mcp/data_query)
    • Zwraca wartość schedule_id
  • Pobieranie wyników zapytania asynchronicznego (POST /mcp/get_async_query_results)
    • Użyj wartości , schedule_id dopóki wyniki nie zostaną zwrócone

Narzędzia / zasoby (zazwyczaj zaawansowana widoczność)

  • Pobierz dzisiaj (UTC) (POST /mcp/get_today)
  • Sprawdzanie kondycji (GET /mcp/resources/health)

Support

Licencja

Zastrzeżone — © supermetryki

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Odnajdywanie dostępnych kont dla określonego źródła danych

Odnajdź dostępne konta dla określonego źródła danych Wywołaj to po data_source_discovery, aby uzyskać identyfikatory kont potrzebne do zapytań dotyczących danych.
Odnajdywanie dostępnych pól dla źródeł danych z informacjami o schemacie

Odkryj dostępne pola dla źródeł danych z informacjami o schemacie Wywołaj tę funkcję, aby wyświetlić dostępne metryki i wymiary źródła danych przed wykonaniem zapytania.
Odnajdywanie dostępnych źródeł danych Supermetryki

Odnajdywanie dostępnych źródeł danych Supermetryki Jest to zazwyczaj pierwszy krok — wywołaj je, aby zobaczyć, jakie źródła danych są dostępne przed wykonaniem zapytania o dane.
Pobieranie bieżących informacji o dacie i godzinie UTC

Uzyskaj bieżące informacje o dacie i godzinie UTC Wywołaj tę funkcję, gdy użytkownik wymienia daty względne, takie jak "ostatni miesiąc" lub "wczoraj", aby znać bieżącą datę.
Pobieranie uwierzytelnionych informacji o użytkowniku z supermetryki

Pobieranie uwierzytelnionych informacji o użytkowniku z supermetryki
Pobieranie wyników zapytań dotyczących danych przy użyciu schedule_id

Pobierz wyniki zapytań dotyczących danych przy użyciu schedule_id Użyj tego z schedule_id z data_query, aby pobrać rzeczywiste wyniki zapytania.
Sprawdzanie kondycji

Uzyskaj informacje o kondycji i konfiguracji serwera.
Wykonywanie zapytań dotyczących danych marketingowych ze źródeł danych Supermetryki

Wykonywanie zapytań dotyczących danych marketingowych ze źródeł danych Supermetryki Ta zwraca schedule_id — należy wywołać get_async_query_results, aby uzyskać rzeczywiste dane.

Odnajdywanie dostępnych kont dla określonego źródła danych

ID operacji:
accountsdiscovery

Odnajdź dostępne konta dla określonego źródła danych Wywołaj to po data_source_discovery, aby uzyskać identyfikatory kont potrzebne do zapytań dotyczących danych.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator źródła danych
 ds_id True string

Identyfikator źródła danych, który można pobrać przy użyciu narzędzia data_source_discovery. Przykłady: "FA" for Facebook Ads, "AW" for Google Ads, "GAWA" for Google Analytics.
Kompresuj odpowiedź
 compress boolean

Włącz kompresję toonu dla odpowiedzi

Zwraca

Body
AccountsdiscoveryResponse

Odnajdywanie dostępnych pól dla źródeł danych z informacjami o schemacie

ID operacji:
fielddiscovery

Odkryj dostępne pola dla źródeł danych z informacjami o schemacie Wywołaj tę funkcję, aby wyświetlić dostępne metryki i wymiary źródła danych przed wykonaniem zapytania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator źródła danych
 ds_id True string

Identyfikator źródła danych, który można pobrać przy użyciu narzędzia data_source_discovery. Przykłady: "FA" for Facebook Ads, "AW" for Google Ads, "GAWA" for Google Analytics.
Typ pola
 field_type string

Filtruj według typu pola (wymiar lub metryka)
Kompresuj odpowiedź
 compress boolean

Włącz kompresję toonu dla odpowiedzi

Zwraca

Body
FielddiscoveryResponse

Odnajdywanie dostępnych źródeł danych Supermetryki

ID operacji:
datasourcediscovery

Odnajdywanie dostępnych źródeł danych Supermetryki Jest to zazwyczaj pierwszy krok — wywołaj je, aby zobaczyć, jakie źródła danych są dostępne przed wykonaniem zapytania o dane.

Parametry

Nazwa Klucz Wymagane Typ Opis
Kompresuj odpowiedź
 compress boolean

Włącz kompresję toonu dla odpowiedzi

Zwraca

Body
DatasourcediscoveryResponse

Pobieranie bieżących informacji o dacie i godzinie UTC

ID operacji:
gettoday

Uzyskaj bieżące informacje o dacie i godzinie UTC Wywołaj tę funkcję, gdy użytkownik wymienia daty względne, takie jak "ostatni miesiąc" lub "wczoraj", aby znać bieżącą datę.

Parametry

Nazwa Klucz Wymagane Typ Opis
object

Zwraca

Body
GettodayResponse

Pobieranie uwierzytelnionych informacji o użytkowniku z supermetryki

ID operacji:
userinfo

Pobieranie uwierzytelnionych informacji o użytkowniku z supermetryki

Parametry

Nazwa Klucz Wymagane Typ Opis
object

Zwraca

Body
UserinfoResponse

Pobieranie wyników zapytań dotyczących danych przy użyciu schedule_id

ID operacji:
getasyncqueryresults

Pobierz wyniki zapytań dotyczących danych przy użyciu schedule_id Użyj tego z schedule_id z data_query, aby pobrać rzeczywiste wyniki zapytania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator harmonogramu
 schedule_id True string

Identyfikator harmonogramu zwrócony z żądania data_query. Identyfikator harmonogramu musi być dokładnie taki sam jak zwrócony w odpowiedzi data_query. Traktuj identyfikatory jako nieprzezroczyste. Skopiuj dosłowne. Nie należy skracać, formatować ani parafrazować.
Kompresuj odpowiedź
 compress boolean

Włącz kompresję toonu dla odpowiedzi

Zwraca

Body
GetasyncqueryresultsResponse

Sprawdzanie kondycji

ID operacji:
healthCheck

Uzyskaj informacje o kondycji i konfiguracji serwera.

Zwraca

response
string

Wykonywanie zapytań dotyczących danych marketingowych ze źródeł danych Supermetryki

ID operacji:
dataquery

Wykonywanie zapytań dotyczących danych marketingowych ze źródeł danych Supermetryki Ta zwraca schedule_id — należy wywołać get_async_query_results, aby uzyskać rzeczywiste dane.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator źródła danych
 ds_id True string

Identyfikator źródła danych, który można pobrać przy użyciu narzędzia data_source_discovery. Przykłady: "FA" for Facebook Ads, "AW" for Google Ads, "GAWA" for Google Analytics.
ds_accounts
 ds_accounts True array of string
pola
 fields True array of string
Typ zakresu dat
 date_range_type string

Wybierz jedno z dwóch podejść:

  1. Użyj polecenia "custom" i podaj start_date i end_date.
  2. Użyj zakresu względnego w formacie "last_X_Y" (np. "last_7_days", "last_3_months").
    • Możesz dołączyć ciąg "_inc", aby uwzględnić bieżący okres (np. "last_7_days_inc").

WAŻNE: W przypadku każdej daty względnej wymienionej przez użytkownika najpierw wywołaj narzędzie get_today, aby znać bieżący rok i datę! Jeśli istnieje jakakolwiek niejednoznaczność dotycząca okresu (np. znaczenia "dzisiaj", "w tym tygodniu", "w sierpniu ubiegłego roku" lub podobnych fraz), wywołaj get_today narzędzie, aby potwierdzić bieżący rok i datę, a następnie użyj tej odpowiedzi, aby wypełnić ten parametr.
Data rozpoczęcia
 start_date string

Wymagane, jeśli date_range_type='custom'. Akceptuje:

  • Dokładna data w formacie RRRR-MM-DD (np. '2024-01-01')
  • Data języka naturalnego (np. "wczoraj", "następny poniedziałek")

WAŻNE: W przypadku każdej daty względnej wymienionej przez użytkownika najpierw wywołaj narzędzie get_today, aby znać bieżący rok i datę! Jeśli istnieje niejednoznaczność odwołania do czasu (np. fraz względnych, takich jak "today", "this week", "end of month"), wywołaj get_today narzędzie, aby potwierdzić bieżący rok i datę, a następnie użyj tej odpowiedzi, aby wypełnić ten parametr.
Data zakończenia
 end_date string

Wymagane, jeśli date_range_type='custom'. Akceptuje:

  • Dokładna data w formacie RRRR -MM-DD (np. "2024-01-31")
  • Data języka naturalnego (np. "wczoraj", "ostatni piątek")

WAŻNE: W przypadku każdej daty względnej wymienionej przez użytkownika najpierw wywołaj narzędzie get_today, aby znać bieżący rok i datę! Jeśli istnieje niejednoznaczność odwołania do czasu (np. fraz względnych, takich jak "today", "this week", "end of month"), wywołaj get_today narzędzie, aby potwierdzić bieżący rok i datę, a następnie użyj tej odpowiedzi, aby wypełnić ten parametr.
Strefa czasowa
 timezone string

Opcjonalnie ustaw strefę czasową obliczeń daty (np. "Ameryka/New_York", "Europa/Londyn", "Azja/Tokio"). Używa nazw stref czasowych IANA. Jeśli nie zostanie określony, użyj czasu UTC.
Filtry
 filters string

Filtruj ciąg wyrażenia. Każdy warunek ma postać: [field_name] [operator] [wartość] Warunki mogą być łączone z AND / OR.

Obsługiwane operatory:

  • "==" → równa się
  • '!=' → nie jest równe
  • ">" → większe niż
  • '>=' → większe lub równe
  • "<" → mniejsze niż
  • '<=' → mniejsze lub równe
  • '=@' → zawiera (bez uwzględniania wielkości, tylko wymiary)
  • '!@' → nie zawiera (bez uwzględniania wielkości, tylko wymiarów)
  • '=~' → pasuje do wyrażenia regularnego (tylko wymiary)
  • '!~' → nie pasuje do wyrażenia regularnego (tylko wymiary)

Examples:

  • "country == United States"
  • "country == United States OR country == Canada"
  • "sesje > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Ustawienia
 settings object

Dodatkowa konfiguracja zapytania. Użyj obiektu JSON, na przykład: {"show_all_time_values": true}. Zaawansowana funkcja dla określonych ustawień źródła danych. Pomiń, chyba że masz określone wymagania.
Typ okresu porównania
 compare_type string

Wybierz sposób porównywania wyników z wcześniejszym okresem:

  • "prev_range": poprzedni okres o tej samej długości
  • "prev_year": ten sam okres w poprzednim roku
  • "prev_year_weekday": te same dni robocze w poprzednim roku
  • "custom": okres zdefiniowany przez użytkownika (wymaga compare_start_date i compare_end_date)
Typ wartości porównania
 compare_show string

Jak wyświetlić porównanie:

  • "perc_change": zmiana procentowa (domyślna)
  • "abs_change": zmiana bezwzględna
  • "value": wartość nieprzetworzona z okresu porównania
Data rozpoczęcia okresu porównania
 compare_start_date string

Wymagane, jeśli compare_type='custom'. Data rozpoczęcia niestandardowego okresu porównania w formacie RRRR-MM-DD (np. "2024-01-01").
Data zakończenia okresu porównania
 compare_end_date string

Wymagane, jeśli compare_type='custom'. Data zakończenia niestandardowego okresu porównania w formacie RRRR-MM-DD (np. "2024-01-31").

Zwraca

Body
DataqueryResponse

Definicje

AccountsdiscoveryResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
Schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
data_sources
 data.data_sources array of object
id
 data.data_sources.id string
nazwa
 data.data_sources.name string
kategoria
 data.data_sources.category string

FielddiscoveryResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
źródło danych
 data.data_source string
łączny
 data.total integer
metryki
 data.metrics array of object
id
 data.metrics.id string
nazwa
 data.metrics.name string
opis
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
nazwa
 data.dimensions.name string
opis
 data.dimensions.description string

GetasyncqueryresultsResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
dane
 data.data array of object
items
 data.data object
stan
 data.status string

GettodayResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
date
 data.date date
iso_string
 data.iso_string string
sygnatura czasowa
 data.timestamp integer

UserinfoResponse

Nazwa Ścieżka Typ Opis
sukces
 success boolean
identyfikator_użytkownika
 data.user_id string
e-mail
 data.email string
nazwa
 data.name string

ciąg

Jest to podstawowy typ danych "string".