Google Ads MCP: az egész fiókfa építése az ügynöködből, egy atomi művelettel

Van Google Ads MCP-szerver? Igen. A Hermoso egy tárhelyezett Google Ads MCP-szerver. Add hozzá a https://app.hermoso.ai/mcp címet a Claude-hoz, a ChatGPT-hez vagy a Cursorhoz, és kösd össze egyszer a Google Ads fiókoddal. Az asszisztensed ezután kereső, megjelenítési és Performance Max kampányokat épít, kulcsszóötleteket keres, beállítja a költségkereteket, az ajánlatokat és a célzást, és jelentéseket futtat. Kampány bekapcsolásához mindig kell a kifejezett megerősítésed.

A Google Ads egy fa, és a fák azok a helyek, ahol a szkriptelt kampányépítés általában elromlik. Létrehozol egy költségkeretet, aztán egy kampányt, aztán egy hirdetéscsoportot, aztán egy hirdetést. Ha a hirdetés a negyedik lépésnél elutasításra kerül, három árva objektum marad, és egy költségkeret, amit nem akartál. Ennek kézi takarítása az oka, amiért a legtöbben feladják a Google Ads automatizálását.

A Hermoso MCP-szervere az egész fát egyetlen atomi műveletben építi fel, ideiglenes erőforrás-azonosítókat használva, hogy a gyerekelemek hivatkozhassanak olyan szülőkre, amelyek még nem léteznek. Vagy létrejön a kampány, a hirdetéscsoport, a hirdetés és a kulcsszavak mind, vagy egyik sem. Egy elutasított hirdetés azt is jelenti, hogy a költségkeret sem jött létre.

Egyszer telepítsd: a Claude.ai-ban vagy a Claude Desktopban illeszd be a https://app.hermoso.ai/mcp címet a Settings → Connectors alá, és hagyd jóvá a Hermoso fiókoddal. Kódoló ügynökben ez egy parancs: /plugin marketplace add hermoso-ai/hermoso, majd /plugin install hermoso@hermoso a Claude Code-ban, codex plugin marketplace add hermoso-ai/hermoso, majd codex plugin add hermoso@hermoso a Codexben, vagy npx skills add hermoso-ai/hermoso -a cursor a Cursorban (az -a után a saját ügynököd nevét add meg), majd jelentkezz be egyszer a npx -y hermoso auth login paranccsal. A teljes beállítás a MCP és CLI oldalon található.

A Google Ads eszközei

Építés. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets az oldalhivatkozásokhoz, kiemelt szövegekhez és strukturált részletekhez.

Beállítás. set_google_ads_budget, set_google_ads_bidding (hat stratégia), set_google_ads_targeting (földrajzi és nyelvi célzás), find_google_ads_locations, set_google_ads_networks (Keresési partnerek és Megjelenítés be- vagy kikapcsolása), create_google_ads_conversion_action és list_google_ads_conversion_actions.

Kutatás. A google_ads_keyword_ideas a Keyword Plannert a beszélgetésbe hozza: valódi havi keresési volumen, versenyhelyzet és az oldal tetején látható ajánlattartományok, kulcsszavakból, céloldalból vagy egy teljes weboldalból kiindulva.

Olvasás és módosítás. list_google_ads_campaigns, google_ads_report tetszőleges GAQL-hez, google_ads_change_history arra, hogy mi változott a fiókban és mikor, delete_google_ads_object egy objektum törléséhez, és set_google_ads_status, az egyetlen megerősítéshez kötött kapcsoló, amely valódi költést indít.

A create_google_ads_campaign dry-run módot is elfogad, így az ügynök a teljes fát ellenőrizheti az élő API-val szemben anélkül, hogy bármit létrehozna. Ez jó alapértelmezés, ha az ügynök egy tervet javasol, amit neked kell jóváhagynod.

Amit az ügynököd megtehet a Google Ads MCP-vel

Minden sor valódi eszköz a szerveren. Kérdezd közérthetően, és az ügynök eldönti, melyiket futtassa.

Példa kérések

Ezek bármelyikét beillesztheted a Claude-ba, a ChatGPT-be vagy a Cursorba, miután a Hermoso össze van kötve.

• “Keress 30 kulcsszót a projektmenedzsment appunkhoz, havi 1000 feletti kereséssel az USA-ban, és csoportosítsd őket szándék szerint.”
  A google_ads_keyword_ideas visszaadja a Keyword Planner volumeneit, versenyhelyzetét és ajánlattartományait, az ügynök pedig csoportosítja őket.
• “Építs szüneteltetett Keresési kampányt ezekre a kulcsszavakra: napi $50, USA és Kanada, angol, konverziók maximalizálása.”
  A create_google_ads_campaign egy atomi műveletben építi fel a költségkeretet, a kampányt, a hirdetéscsoportot, a hirdetést és a kulcsszavakat, szüneteltetve, majd visszaolvassa.
• “Építs Performance Max kampányt a Shopify katalógusunkhoz a Merchant Center feedünk használatával.”
  A list_merchant_accounts kiválasztja az üzletet, majd a create_google_ads_performance_max_campaign szüneteltetve építi meg a feeddel együtt.
• “Mely keresési kifejezések költöttek pénzt tavaly, konverzió nélkül? Add hozzá a legrosszabb tízet negatív kulcsszóként.”
  A google_ads_report lekéri a keresési kifejezések jelentését, majd az add_google_ads_keywords hozzáadja a negatív kulcsszavakat.
• “Adj négy oldalhivatkozást a márkakampányunkhoz: árak, demó, esettanulmányok és kapcsolat.”
  Az add_google_ads_assets létrehozza az oldalhivatkozásokat, és a kampányhoz csatolja őket.
• “Kapcsold ki a Keresési partnereket minden kampányon, és mutasd meg a változás előtt és után.”
  A set_google_ads_networks először beolvassa az aktuális beállítást, majd kampányonként módosítja.
• “Pénteken valaki átírta az ajánlatainkat. Mi változott?”
  A google_ads_change_history időpontokkal együtt listázza a változásokat.
• “Kapcsold össze a GA4-tulajdonságunkat, hogy a regisztrációk konverzióként számítsanak a Google Ads-ban.”
  A link_google_ads_to_analytics összeköti a kettőt, a create_analytics_key_event pedig a regisztrációs eseményt kulcseseményként jelöli meg.

A Performance Max ugyanígy épül

A create_google_ads_performance_max_campaign a Google csatornákon átívelő kampánytípusát építi (Keresés, YouTube, Megjelenítés, Discover, Gmail és Maps egyetlen kampányból), és egyetlen atomi műveletben építi, mert a Google pontosan ezt kívánja: a költségkeret, a kampány, a helyszíni és nyelvi célzás, a hirdetéscsoport és minden eszközkapcsolat egyszerre megy fel, így egy elutasított eszköz nem hagy félkész kampányt maga után. Szüneteltetve jön létre, és az egész fát a Google-től olvassa vissza, mielőtt az ügynököd azt mondaná, hogy létezik.

A Google eszköz-minimumait a rendszer ellenőrzi, mielőtt bármi elküldésre kerülne, így egy hiányzó négyzet alakú kép egyértelmű üzenet, nem egy homályos API-elutasítás: 3–15 címsor legfeljebb 30 karakterrel, 1–5 hosszú címsor legfeljebb 90 karakterrel, 2–5 leírás legfeljebb 90 karakterrel, egy üzleti név legfeljebb 25 karakterrel, és legalább egy logó, egy marketingkép és egy négyzet alakú marketingkép. Először az upload_google_ads_asset segítségével töltsd fel a képeket, és add meg az erőforrásneveket. A YouTube-videó opcionális. Ha kihagyod, a Google generálhat egyet a hirdetéscsoportból.

A Performance Max nem használ kulcsszavakat és nem használ kézi ajánlattételt: csak a konverziók optimalizálására törekszik. Ezért az építés elutasít minden olyan fiókot, ahol nincs engedélyezett konverziós művelet, ahelyett, hogy olyan kampányt hozna létre, amely nem tud optimalizálni, és két kiutat is megnevez: hozz létre egyet a create_google_ads_conversion_action segítségével, vagy használj olyan stratégiát, amelyhez nem kell. A márkairányelvek az új PMax kampányoknál a Google Ads API v21 óta alapértelmezetten be vannak kapcsolva, ami megváltoztatja, hová csatlakozik az üzleti név és a logó; a Hermoso ezeket a kampányhoz csatolja helyetted.

A bevásárló-feedes (kiskereskedelmi) Performance Max ugyanígy működik: add meg a merchantCenterId értéket, és a kampány a Merchant Center katalógusodat hirdeti, a feedLabel pedig egyetlen feedre szűkíti. Ugyanúgy épül és olvasódik vissza, mint a fenti kampány. A visszaolvasás azt a Merchant Center-fiókot és feedcímkét jelenti, amelyet a Google ténylegesen eltárolt, így láthatod, hogy valóban kiskereskedelmi kampány, és nem csak a mi szavunkat kell elfogadnod. A teljes feedet egyetlen gyökér listázási csoport alatt hirdeti; a feed márka, kategória vagy egyedi címke szerinti particionálása nincs megépítve, és név szerint elutasítja, nem csendben figyelmen kívül hagyja, így soha nem hiheted azt, hogy szűkítettél, ha nem szűkítettél.

Merchant Center, hogy az ügynök tudja, mit ad el

“Miért nem látszik ez a termék?” olyan kérdés, amire a Google Ads jelentései szerkezetileg nem tudnak válaszolni, mert egy elutasított terméknek nincs megjelenése, amiről jelentést lehetne adni. Ez a válasz a Merchant Centerben van, és ugyanaz a Google-kapcsolat eléri, külön bejelentkezés nélkül.

Az ügynököd a list_merchant_accounts segítségével listázhatja a Merchant Center-fiókokat, amelyeket a csatlakoztatott Google-fiókod elér (egy ügynökségnek általában több van, ezért inkább rákérdez, melyik üzletről van szó, ahelyett, hogy találgatna), a list_merchant_products segítségével olvashatja egy feed termékeit (a tényleges katalógust, amelyet egy Shopping vagy kiskereskedelmi Performance Max kampány kiszolgál), és a list_merchant_issues segítségével olvashatja a Google által a fiókra vonatkozóan jelzett fiókszintű problémákat. Ez elég ahhoz, hogy valóban létező termékekről írj hirdetésszöveget, valóban élő árakkal, és megmagyarázd egy néma kampány okát.

Írni is tud. A create_merchant_data_source API-termékfeedet hoz létre, az upsert_merchant_product terméket tesz bele, az update_merchant_product a naponta változó mezőket (ár és elérhetőség) módosítja, a delete_merchant_product és a delete_merchant_data_source pedig megerősítés után töröl. A list_merchant_data_sources megmutatja, mely feedek fogadnak el valóban írást.

Három dolog jó tudni előre. A Google minden Merchant API-hívást blokkol, amíg a Hermoso Cloud-projektje nincs regisztrálva a Merchant Center-fiókodhoz, ezért a register_merchant_developer egyszer elvégzi ezt az összekötést, és név szerint mondja ki, mit csinál. Ez nem egy hibás kapcsolat, és az újracsatlakozás nem oldja meg. A termékírások csak egy API adatforrásba kerülhetnek: a fájl-feedek, az automatikus feedek és a Merchant Center saját felülete által létrehozott feed mind normálisan listázódik, de mindegyik elutasít minden írást, ezért a Hermoso feloldja helyetted az írható feedet, létrehoz egyet, ha nincs, és név szerint elutasít, ha több is van, ahelyett, hogy a termékedet olyan piacra tenné, amelyet a kampányaid esetleg nem céloznak. Az upsert_merchant_product teljes soros írás, míg az update_merchant_product foltozás. Az elsőnek küldd el az összes megtartandó mezőt, a másodiknak csak a módosítandókat.

Mindez nem jelenti azt, hogy a katalógusodat át kell költöztetned. Ha a feed már a Shopify-ban vagy a platformodon van, maradhat ott, és az ügynök olvashatja; az írások azokra az esetekre valók, amikor még nincs feed, vagy amikor egyetlen ár vagy elérhetőség javítása most kell, nem a következő szinkronizálásnál.

Google Analytics 4, hogy lásd, mit csináltak a kattintások

A Google Ads jelentéskészítése a kattintásnál véget ér. Ami utána történik (a munkamenet, a regisztráció, a rendelés) a Google Analyticsben van, és ugyanaz a Google-bejelentkezés eléri (ez külön kapcsolat, mert saját engedélyt igényel).

Az ügynököd a list_analytics_properties segítségével megállapíthatja, melyik GA4-tulajdonságot olvassa. Erre azért van szükség, mert minden Analytics-hívás numerikus tulajdonság-azonosítót kér, te viszont a G-XXXXXXXXX mérési azonosítót látod a követőkódodban. Ezután az analytics_report a munkameneteket, a felhasználókat, a konverziókat és a bevételt adja vissza csatorna, forrás/médium, kampány, céloldal, ország, eszköz vagy dátum szerinti bontásban, az analytics_realtime pedig megmutatja, ki van épp az oldalon. Tehát a “építsd meg a kampányt” és a “mondd meg, mennyit hozott” ugyanaz a beszélgetés.

Írni is tud, és ez az a rész, ami közvetlenül visszatáplálja a Google Ads-ba: a create_analytics_key_event egy olyan eseményt jelöl kulcseseménynek, amelyet a GA4 már gyűjt, és ez az, amit a Google Ads konverzióként importál. A konverziós művelet pedig az, nélkül egyik intelligens ajánlattételi stratégia sem működhet, amelyről ez az oldal szól. A create_analytics_custom_dimension egy eseményparamétert regisztrál, hogy a jelentések szerint lehessen bontani, a list_analytics_definitions pedig megmutatja, mit mér már a tulajdonság, mielőtt bármelyiket hozzáadnád. Két dolog örökre igaz: ez csak GA4, mert az API-ban nincs Universal Analytics felület, és egyéni dimenzió archiválható, de sosem törölhető, tulajdonságonként 50 eseményhez kötött hellyel, ezért az ügynök előbb ellenőrzi a meglévő készletet.

Az élő költés kapuja nem egyetlen eszköz

A kampány szüneteltetése nem az egyetlen mód a költés elkerülésére, és ezt egyedüli módszerként kezelni valódi csapda: egy már engedélyezett szülő alatt egy engedélyezett hirdetéscsoport, hirdetés vagy kulcsszó a következő aukción már megjelenik. Ezért ugyanaz a megerősítés, amely a set_google_ads_status eszközt védi, védi a create_google_ads_ad_group, a create_google_ads_ad és az add_google_ads_keywords eszközöket is, valahányszor a szülő él, és ezt abból a sorból olvassa le, amelyet mindhárom eszköz már lekér, külön körutazás nélkül. A negatív kulcsszavak csak korlátozzák a költést, ezért soha nem kapuzottak.

GAQL-jelentések, egy ismerendő korláttal

A google_ads_report tetszőleges GAQL-t fogad, így az ügynököd bármilyen szeletet kérhet, nem kötik egy rögzített jelentési formához. Egy dolgot érdemes szem előtt tartani, ha kézzel írsz lekérdezéseket, vagy egy modell ír őket: a GAQL nem SQL. Nincsenek alkérdései, és az IN literál listát vár. Egy WHERE id IN (SELECT …) érvénytelen, és hibával elbukik, nem csendben rossz sorokat ad vissza. Az eredményt közvetlenül egy táblázatba viheted a create_sheet és az append_to_sheet segítségével, vagy egy dokumentumba a create_doc-kal.

Visszaolvasás, aztán jelentés

A módosítás után a fát a Google-től olvassa vissza a rendszer, és az összefoglaló, amit kapsz, ebből a visszaolvasásból készül, nem abból, amit kértek. Ez egy kis fegyelem, amely arra a konkrét hibára figyel, amikor egy ügynök magabiztosan olyan kampányt mesél el, amelyet a platform valójában átírt vagy elutasított.

Amit nem tesz meg kérdés nélkül

A költségkerettel rendelkező ügynök csak akkor hasznos, ha a kockázat korlátos, ezért a költési jogosultságot a szerver korlátozza, nem egy utasítás. A Meta-kampányok, hirdetéscsoportok és hirdetések mindig PAUSED állapotban jönnek létre, hívó általi felülírás nélkül. A kapcsolók, amelyek valódi hirdetési költést indíthatnak (minden hirdetési platformon van egy: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status és set_openai_ads_status többek között), mind megtagadják a futást kifejezett megerősítő jelző nélkül, és ugyanez a kapu védi egy engedélyezett Google Ads hirdetéscsoport, hirdetés vagy kulcsszó létrehozását is egy már engedélyezett szülő alatt, mert az a következő aukción azonnal megjelenik. A törlések is megerősítéshez kötöttek. A generálás oldalán a hermoso_capabilities minden modell pontos kreditköltségét közzéteszi, mielőtt bármi futna, és minden renderelés becslést foglal le, majd a valódi költséget számolja el, így egy sikertelen indítás visszatérít, nem csendben számláz.

A Google Ads-fiókod összekötése

A Google Ads-et a Hermoso-hoz a Google saját OAuth-folyamatán keresztül kötöd össze a Connectors beállításokban; jelszó nem jut át a modellen. A Google Ads-kapcsolatok márkaszinten osztottak, így egy egész csapat, amely egy márkán dolgozik, egy kapcsolatból dolgozik, és nem kell mindenkinek újra engedélyeznie.

A kreatív rész

A kampánykezelés csak akkor hasznos, ha van mit futtatni. Ugyanez a szerver kutatja, mi működik már a piacodon a Meta, a Google és a LinkedIn hirdetési könyvtáraiban, készre renderelt kép- és videókreatívot készít, amely a valódi termékedre épül, több mint 100 modellel, és feltölti az eszközöket, így a “mit futtassunk” és a “építsd meg” egy beszélgetés, nem kettő. Lásd a marketing MCP áttekintést, a teljes eszközlistát, vagy ha mindkettőt futtatod, a Meta Ads MCP-t.

Gyakori kérdések

Van MCP-szerver a Google Ads-hez?

Igen. A Hermoso MCP-szervere bármely MCP-kliensből építi és kezeli a Google Ads-et: a create_google_ads_campaign, a create_google_ads_ad_group, a create_google_ads_ad és az add_google_ads_keywords keresési vagy megjelenítési fa építésére; a create_google_ads_performance_max_campaign a Performance Maxhoz; a set_google_ads_budget, a set_google_ads_bidding és a set_google_ads_targeting a beállításhoz; a google_ads_keyword_ideas a Keyword Planner kutatáshoz; a list_google_ads_campaigns és a google_ads_report a jelentéskészítéshez; Merchant Center-olvasás a Shopping-kampány mögötti termékfeedhez; és a megerősítéshez kötött set_google_ads_status az aktiváláshoz.

Tud egy AI-ügynök Google Ads-kampányt létrehozni?

Igen, és a teljes fát egyetlen atomi műveletben, ideiglenes erőforrás-azonosítókkal hozza létre: kampány, hirdetéscsoport, reszponzív keresési vagy megjelenítési hirdetés és kulcsszavak együtt. Ha a hirdetést elutasítják, a költségkeret sem jött létre, így nem maradsz árva objektumok takarításával. Egy dry-run mód az élő API-val ellenőrzi a fát, anélkül hogy bármit létrehozna.

Létre tud hozni Performance Max kampányt?

Igen. A create_google_ads_performance_max_campaign egy atomi műveletben építi a költségkeretet, a kampányt, a célzást, a hirdetéscsoportot és minden eszközkapcsolatot, mert a Google mindet együtt követeli meg. A kampány szüneteltetve jön létre, és visszaolvassa, mielőtt az ügynök beszámolna róla. A Google eszköz-minimumait a rendszer azelőtt érvényesíti, hogy bármi elküldésre kerülne: 3–15 címsor, 1–5 hosszú címsor, 2–5 leírás, egy üzleti név, és legalább egy logó, egy marketingkép és egy négyzet alakú marketingkép. A PMax csak konverziókra licitál, ezért nem épít olyan fiókon, ahol nincs engedélyezett konverziós művelet, mert az olyan kampányt hozna létre, amely nem tud optimalizálni. A bevásárló-feedes (kiskereskedelmi) PMax ugyanígy működik: add meg a merchantCenterId értéket, és a kampány a Merchant Center katalógusodat hirdeti, a feedLabel pedig egyetlen feedre szűkíti, a visszaolvasás pedig megmondja, melyik Merchant Center-fiókot és feedcímkét tárolta el a Google.

Működik a Google Merchant Centerrel?

Igen, olvasás és írás is, ugyanazon a Google-kapcsolaton keresztül. Az ügynök listázhatja a fiókodból elérhető Merchant Center-fiókokat, olvashatja egy feed termékeit (a katalógust, amelyet egy Shopping vagy kiskereskedelmi Performance Max kampány ténylegesen kiszolgál), és olvashatja a Google által jelzett fiókszintű problémákat, ami az egyetlen hely, ahol kiderül, miért nem látszik egy termék, mert az elutasított terméknek nincsenek megjelenései, amelyeket a Google Ads-jelentés mutathatna. A Google egyszeri regisztrációt követel meg a Hermoso Cloud-projektjének a Merchant Center-fiókodhoz kötéséhez, mielőtt az API válaszol, és van egy eszköz, amely ezt elvégzi. Ír is: a create_merchant_data_source, az upsert_merchant_product, az update_merchant_product a naponta változó ár- és elérhetőségi módosításokhoz, és megerősítéshez kötött delete_merchant_product és delete_merchant_data_source. A Google csak API-adatforrásba fogad el termékíréseket, ezért a Hermoso feloldja helyetted az írható feedet, és név szerint elutasít, ha a fióknak több is van.

Tud kulcsszókutatást végezni?

Igen. A google_ads_keyword_ideas meghívja a Google Keyword Plannerét, és valódi havi keresési volumeneket, versenyhelyzetet és az oldal tetején látható ajánlattartományokat ad vissza, kiindulókulcsszavakból, céloldal-URL-ből vagy egy teljes weboldalból. Az ügynök ezeket közvetlenül átadhatja az add_google_ads_keywords eszköznek, vagy kiírhatja egy Google Táblázatba.

Elkezdheti költeni a Google Ads-költségkeretemet?

Csak kifejezett megerősítéssel. A set_google_ads_status az a kapcsoló, amely valódi pénzt old fel, és mivel egy már engedélyezett szülő alatt egy engedélyezett gyermek létrehozása a következő aukción azonnal megjelenik, ugyanez a megerősítés védi a create_google_ads_ad_group, a create_google_ads_ad és az add_google_ads_keywords eszközöket is, ha a szülő él. A negatív kulcsszavak csak korlátozzák a költést, és soha nem kapuzottak.

Tud jelentéseket futtatni?

Igen. A google_ads_report tetszőleges GAQL-t fogad, így az ügynök bármilyen szeletet kérhet. Figyelem: a GAQL nem SQL, nincsenek alkérdései, és az IN literál listát vár, így a WHERE id IN (SELECT …) érvénytelen. Az eredmények közvetlenül egy Google Táblázatba vagy Dokumentumba írhatók.

Milyen ajánlattételt és célzást tud beállítani?

Hat ajánlati stratégiát, kampányütemezést, valamint földrajzi és nyelvi célzást, a helyszíni célzások névvel való feloldásához pedig a find_google_ads_locations eszközt. A költségkereteket a set_google_ads_budget állítja be, a kulcsszavak pedig támogatják a negatív kulcsszavakat és a kulcsszónkénti CPC-t.

Megkapja az ügynök a Google-fiókom jelszavát?

Nem. A Google Ads-et a Hermoso Connectors beállításaiban, a Google saját OAuth-folyamatán keresztül kötöd össze, a keletkező tokent pedig a Hermoso tárolja. Az ügynök csak a Hermoso eszközeit hívja. A Google Ads-kapcsolatok márkaszinten vannak megosztva, így egy egész csapat egy kapcsolatból dolgozik.

A kreatívot is el tudja készíteni?

Igen. Ugyanez a szerver kutatja a versenytársak hirdetéseit, megtervezi a koncepciót, több mint 100 modellel készre renderelt kép- és videókreatívot készít a valódi termékeddel a képen, és az eszközöket az upload_google_ads_asset eszközzel feltölti, így a kutatás, a kreatív és a kampányépítés egy beszélgetésben történik.