Што дае планавальнік і навошта ён у чаце
Keyword Planner — штатны інструмент Google Ads: па некалькіх словах-зацэпках ён выдае спіс звязаных запытаў, сярэднюю колькасць пошукаў на месяц за апошні год, узровень канкурэнцыі ў рэкламе і вілку стаўкі за клік, а яшчэ лічыць прагноз паказаў і клікаў пры зададзеным бюджэце. Гэта дадзеныя першакрыніцы — тыя ж, на якія абапіраецца сам Google.
Праблема не ў дадзеных, а ў руціне. Каб праверыць адну ідэю для старонкі, трэба адкрыць кабінет, выбраць рэгіён і мову, увесці зацэпкі, адфільтраваць смецце, выгрузіць табліцу — і ўсё дзеля аднаго адказу: ці варта наогул пісаць такі тэкст. Калі памочнік і так дапамагае з тэкстамі, лагічна аддаць яму і праверку попыту.
MCP (Model Context Protocol) — адкрыты пратакол, праз які памочнік выклікае знешнія інструменты. Падрабязней я разбіраў яго ў артыкуле пра падключэнне Search Console. Тут дастаткова аднаго: MCP-сервер — гэта невялікая праграма-пасярэднік на вашым камп'ютары, якая з аднаго боку адказвае памочніку, а з другога ходзіць у API Google.
Які сервер я выбраў
Варыянтаў аказалася тры тыпы. Афіцыйны MCP-сервер Google для Ads API — агульнага прызначэння: запыты да акаўнта, метаданыя, адвольныя выбаркі; інструментаў планавальніка я ў ім не знайшоў. Іншыя зборкі «усё ў адным» — трыццаць з лішнім інструментаў, уключна з кіраваннем кампаніямі, стаўкамі і бюджэтамі. І кампактныя ўтыліты на некалькі каманд.
Узяў кампактны варыянт, google-keyword-planner-mcp: роўна тры інструменты — ідэі па ключавых словах, гістарычная статыстыка, прагноз клікаў. Натыўны выканальны файл на 28 МБ, без Python і Node.js, адкрыты код пад MIT, які чытаецца за вечар.
Логіка выбару простая, і яна ж галоўная думка ўсёй маёй працы з ШІ-інструментамі: памочніку выдаецца роўна тая паверхня, якая патрэбна задачы. Сервер з кіраваннем кампаніямі ўмее траціць грошы — значыць, аднойчы патраціць іх без пытання. Сервер на тры чытанні не ўмее нічога, акрамя як адказаць лічбамі. Той жа прынцып — у паслузе па бяспечным укараненні ШІ-агентаў.
Галоўнае: з 9 верасня 2026 года developer token адменены
Тут я страціў больш за ўсё часу, таму выношу наперад. Раней схема была такая: заводзіш кіраўнічы акаўнт Google Ads (MCC), у раздзеле «Цэнтр API» атрымліваеш developer token — радок з 22 сімвалаў — і шлеш яго загалоўкам у кожным запыце. Амаль усе інструкцыі, якія выдае пошук, апісваюць менавіта гэта.
Я прайшоў па ёй цалкам: стварыў кіраўнічы акаўнт, атрымаў токен, упісаў яго ў налады сервера. І толькі потым дабраўся да дакументацыі, дзе чорным па белым: developer token адменены 9 верасня 2026 года. Токен у загалоўку цяпер ігнаруецца, а ўзровень доступу вызначаецца праектам Google Cloud, з якога выпушчаны OAuth-дадзеныя. Заяўкі праз «Цэнтр API» больш не разглядаюцца, а тыя, што віселі ў чарзе, Google закрыў і папрасіў падаць нанова — ужо ў Cloud Console.
Новая лесвіца доступу выглядае так:
- Test — выдаецца аўтаматычна, як толькі вы ўключаеце Google Ads API у сваім праекце Cloud. Працуе толькі з тэставымі акаўнтамі.
- Explorer — першы ўзровень, які бачыць жывыя акаўнты: 2 880 аперацый на суткі. Важная дэталь: інструменты планавальніка на гэтым узроўні недаступныя, Google адносіць іх да абмежаванай функцыянальнасці.
- Basic — 15 000 аперацый на суткі, і менавіта ён адкрывае Keyword Planner. Патрабуе верыфікацыі брэнда для праекта Cloud; пасля яе заяўку разглядаюць аўтаматычна, лік ідзе на хвіліны.
- Standard — без сутачнага ліміту, для вялікіх сэрвісаў; разгляд да дзесяці працоўных дзён.
Выснова, якую варта было б прачытаць у самым пачатку: калі патрэбен менавіта планавальнік, шлях адзін — праект у Google Cloud, уключаны Ads API, верыфікацыя брэнда і заяўка на Basic. Кіраўнічы акаўнт для гэтага не патрэбны ўвогуле.
Крок за крокам: што рабіў рукамі
- Праект у Google Cloud. Уключыў Google Ads API — праект адразу атрымлівае ўзровень Test.
- OAuth-кліент тыпу Desktop app. Ён дае пару «ідэнтыфікатар кліента — сакрэт». Для настольнай праграмы гэта штатны сцэнар: сакрэт такога кліента Google не лічыць канфідэнцыяльным.
- Разавая аўтарызацыя. Невялікі скрыпт паднімае на лакальным порце прыёмнік, адкрывае акно згоды Google з вобласцю доступу да Ads, ловіць код звароту і мяняе яго на токен абнаўлення. Ключавыя параметры запыту — offline-доступ і прымусовая згода, інакш токен абнаўлення проста не выдадуць.
- Ідэнтыфікатар акаўнта. Дзесяць лічбаў без дэфісаў — той рэкламны акаўнт, па якім запытваюцца дадзеныя.
- Сервер на дыск. Спампаваў зборку пад сваю сістэму, паклаў у асобную папку. Асяроддзе выканання ставіць не давялося: гэта адзін файл. У мяне ён паехаў на дыск D — на сістэмным не было месца.
- Рэгістрацыя ў памочніку. Адной камандай, з вобласцю бачнасці «карыстальнік», каб сервер быў даступны ва ўсіх праектах, а не ў адным каталогу.
claude mcp add keyword-planner \
--scope user \
-e GOOGLE_ADS_CLIENT_ID=... \
-e GOOGLE_ADS_REFRESH_TOKEN=... \
-e GOOGLE_ADS_CUSTOMER_ID=... \
-- D:\mcp\kwp-mcp.exe
Дэталь, на якой спатыкаюцца ўсе: спіс інструментаў кліент чытае пры запуску. Пасля рэгістрацыі сервера ў ужо адкрытай сесіі яго не відаць — патрэбны новы чат ці перазапуск праграмы. Гэта не памылка ўстаноўкі.
Праверка пратакола без памочніка
Перш чым шукаць праблему ў памочніку, варта пераканацца, што сервер увогуле жывы. MCP працуе па JSON-RPC праз стандартны ўвод-вывад, таму яго можна апытаць уручную: запусціць выканальны файл, адправіць яму ў паток уводу тры радкі і прачытаць адказы.
initialize — поціск рукі з версіяй пратакола;notifications/initialized — пацвярджэнне;tools/list — спіс інструментаў.
Калі ў адказ прыйшоў спіс з трох інструментаў, сервер і ўліковыя дадзеныя ў парадку — далей можна зваць tools/call са сапраўдным запытам. Такі тэст эканоміць гадзіны: ён адразу дзеліць праблему на «сервер не адказвае» і «кліент яго не бачыць».
Дзе ўсё стала: адмова 403 ад Google
Пратакол ажыў, інструменты на месцы, а першы ж рэальны запыт вярнуў адмову:
PERMISSION_DENIED
ACTION_NOT_PERMITTED
The Google Cloud project is only
approved for use with test accounts.
Паведамленне сумленнае: у праекта ўзровень Test, жывы рэкламны акаўнт яму не аддаюць. Да падбору слоў, зацэпак і рэгіёнаў гэта дачынення не мае.
І вось пастка, у якую я ўсё ж трапіў: убачыўшы адмову, першым чынам хочацца перафармуляваць запыт — змяніць мову, прыбраць частку зацэпак, паспрабаваць іншую краіну. Бескарысна. Памылка пра ўзровень доступу праекта цалкам, а не пра канкрэтны выклік. Лекі адны — верыфікацыя брэнда і заяўка на Basic.
Яшчэ дробязь для тых, хто будзе шукаць тэкст памылкі: у старых версіях API адмова прыходзіць як ACTION_NOT_PERMITTED, у свежай — з іншым кодам. Адна і тая ж прычына выглядае па-рознаму, і гэта збівае з толку.
Колькі часу гэта заняло
Тэхнічная частка — каля гадзіны: спампаваць файл, стварыць OAuth-кліента, атрымаць токен абнаўлення, зарэгістраваць сервер, праверыць пратакол. Усё астатняе з'ела адміністрацыйная старана Google: спачатку шлях па састарэлай інструкцыі з кіраўнічым акаўнтам, потым разбор новай схемы, потым верыфікацыя брэнда, якая патрабуе пацверджанага дамена і запоўненага акна згоды.
Калі плануеце такую інтэграцыю — закладвайце дзень на бюракратыю і гадзіну на ўстаноўку, а не наадварот.
Бяспека: што варта зрабіць інакш
- Сакрэты — не ў скрыптах. У мяне яны на час адладкі ляжалі проста ў тэставым файле, і гэта дрэнная звычка: месца ім у зменных асяроддзя ці ў сховішчы сакрэтаў, а сам файл — у выключэннях сістэмы кантролю версій.
- Менш інструментаў — менш паверхня. Тры функцыі чытання не могуць ні стварыць кампанію, ні змяніць стаўку. Сервер, які гэта ўмее, патрабуе зусім іншага ўзроўню даверу.
- Асобны праект Cloud пад інтэграцыю. Так прасцей адклікаць доступ цалкам і не зачапіць астатнія сэрвісы.
- Код — прачытаць да запуску. Дваццаць восем мегабайт — гэта сабраны бінарнік, але зыходнікі адкрытыя: паўгадзіны чытання танней за адзін інцыдэнт.
Што гэта дае ў працы
Калі доступ адкрыты, сцэнар выглядае так: пішаш тэкст старонкі і пытаешся, колькі людзей у Польшчы шукаюць гэтую фразу і якія фармулёўкі папулярнейшыя, — лічбы прыходзяць у тым жа акне, без выгрузак. Па той жа схеме правяраюцца ідэі новых паслуг, спіс мінус-слоў для рэкламы і сезоннасць попыту.
Сумленна пра мой статус на момант публікацыі: праект усё яшчэ на ўзроўні Test, заяўка на Basic у чарзе. Таму лічбаў па жывым акаўнце ў артыкуле няма — толькі рабочая схема і граблі. Як доступ адкрыецца, вярнуся і дапоўню артыкул рэальнымі замерамі.
Ці варта паўтараць
Калі вы рэгулярна пішаце тэксты, вядзеце рэкламу ці адказваеце за сайт, дзе рашэнні прымаюцца па попыце, — так. Інтэграцыя здымае пераключэнне кантэксту, а гэта галоўная страта часу ў такой працы. Калі планавальнік адкрываецца раз на квартал, прасцей зайсці ў кабінет рукамі.
І апошняе: верасневая рэформа доступу азначае, што большасць інструкцый па Google Ads API зараз састарэлі. Перш чым паўтараць чужы гайд, звярайцеся з афіцыйнай дакументацыяй — дата ў яе важнейшая за колькасць зорак у рэпазіторыі.
Падключым Keyword Planner да ШІ-памочніка за вас — на вашым камп'ютары ці ў вашым воблаку, разам з наладкай доступу ў Google.
