Выгрузка данных Яндекс Вебмастера в Google Таблицы с использованием n8n
В этом руководстве я расскажу, как автоматизировать отчеты и настроить выгрузку популярных поисковых запросов из Яндекс Вебмастера в Google Таблицы с помощью n8n.
Читать еще:
- Что такое n8n?
- Обзор интерфейса n8n
- Автоматизация отчетов Google Analytics 4 с использованием n8n
- Остальные материалы по n8n
Введение
Буквально еще несколько лет назад интернет-маркетологи не могли самостоятельно автоматизировать рабочие процессы и выгрузку данных для последующего анализа и визуализации. Это касалось как специалистов по платному трафику (PPC), так и профессионалов в области SEO. Любая задача по переносу данных из одного сервиса в другой сопровождалась написанием ТЗ, долгим общением с разработчиками и проверкой результатов. В качестве альтернативы использовались готовые коннекторы, которые, как правило, требовали регулярных затрат на SaaS-подписку.
Сейчас же эти процессы под силу любому специалисту, обладающему даже базовыми навыками в веб-разработке. Автоматизация, или ETL (Extract, Transform, Load) - это то, что маркетолог сегодня делает самостоятельно. Именно с этих повторяющихся задач стоит начинать оптимизацию своего рабочего времени, чтобы навсегда избавиться от рутины.
В этом материале я покажу процесс, который вы сможете настроить самостоятельно буквально за несколько минут. Мы разберем мой готовый шаблон в n8n для автоматической передачи данных из Яндекс Вебмастера по популярным запросам в Google Таблицы. Это гораздо проще и увлекательнее, чем кажется на первый взгляд!
Если вы хотите автоматизировать рутину и разобраться в ИИ, добро пожаловать на мой новый онлайн-курс по n8n для маркетологов!
Вот список практических задач, которые интернет-маркетолог сможет решить сразу после настройки автоматизации:
- Создание единого дашборда. Вы сможете собирать данные о позициях, поисковом трафике (из Яндекс Метрики) и технических ошибках в одной Google Таблице, вместо того чтобы лазить по разным интерфейсам
- Автоматический аудит. Настроить еженедельный отчет, который автоматически показывает, появились ли на сайте новые фатальные ошибки или упало количество страниц в поиске;
- Кластеризация запросов. Выгружая все запросы, по которым находится сайт, вы можете анализировать семантическое ядро на уровне отдельных URL и выявлять группы запросов для оптимизации;
- Сравнение с конкурентами. Хотя данных конкурентов через API не получить, хранение собственной истории позволяет точно оценивать эффект от ваших действий, не полагаясь на ограниченные данные интерфейса.
Вам уже не терпится попробовать все это? Тогда давайте приступать!
Мы создадим простой рабочий процесс (workflows), который будет обращаться к API Яндекс Вебмастера и получать список популярных поисковых запросов, по которым мой сайт показывался в поиске Яндекса за последнюю неделю. Скачать итоговый шаблон для n8n вы сможете в конце этого руководства. Он размещен на моей образовательной платформе edu.osipenkov.ru, в разделе Материалы.
Также стоит отметить, что API Яндекс Вебмастера открывает доступ и к множеству других полезных данных. Через него можно отслеживать историю ИКС, проверять файлы Sitemap, контролировать внешние и битые внутренние ссылки, а также отправлять страницы на переобход и выполнять диагностику сайта. Однако в рамках этой статьи мы сосредоточимся на одной из самых важных категорий отчетов - работе с поисковыми запросами.
Для выполнения следующих шагов вам понадобится установленный и настроенный сервер n8n. Если у вас его еще нет, рекомендую сначала развернуть платформу, а затем вернуться к этому руководству. Так вы сможете сразу применить все действия на практике.
Материалы для справки:
Получение токена доступа
Чтобы настроить автоматическую выгрузку данных о поисковых запросах из Яндекс Вебмастера по API, нем необходимо создать приложение и получить авторизационный токен (токен доступа).
Если у вас нет логина в Яндексе - зарегистрируйте аккаунт Яндекс ID, а затем авторизуйтесь. После этого под вашей учетной записью перейдите на странице приложений и создайте приложение. В открывшемся окне выберите вариант Для доступа к API или отладки:
Для доступа к API или отладки
На первом шаге введите название приложение (например, Webmaster API). Иконку сервиса добавлять необязательно. Укажите почту компании или свою. Будем оповещать об изменениях во внешней авторизации:
Название приложения и почта для связи
В раскрывающемся списке Доступ к данным поочередно введите webmaster:hostinfo и webmaster:verify:
Доступ к данным - webmaster:hostinfo и webmaster:verify
Redirect URI для веб-сервисов оставьте без изменений (его нельзя будет редактировать). В завершение нажмите кнопку Создать приложение:
Создать приложение
После этого вас перенаправит на страницу приложения, где будет отображаться ClientID:
ClientID вашего приложения
Скопируйте его и сохраните в обычном блокноте. Он вам понадобится чуть позже в запросах для получения OAuth-токена.
Теперь авторизуйтесь под учетной записью Яндекса, на которой у вас есть доступ к Яндекс Вебмастеру, и перейдите по ссылке, добавив ее в адресную строку браузера:
|
1 |
https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор приложения> |
, где вместо <идентификатор приложения> вставьте идентификатор вашего приложения ClientID, скопированный на предыдущем шаге:
Ссылка с идентификатором приложения (ClientID)
У вас должно открыться окно авторизации. Нажмите кнопку Войти как… и тогда ваше приложение получит доступ к использованию Яндекс Вебмастера:
Разрешить приложению доступ
На следующей странице отобразится ваш OAuth-токен:
Токен доступа (авторизационный токен)
Обязательно сохраните этот токен в надежном месте и никому не передавайте. Он понадобится вам в n8n для авторизации запросов к API Вебмастера и автоматической выгрузки данных.
Срок действия токена составляет 6 месяцев. По истечении этого времени вам понадобится получить его заново. Для этого просто перейдите по той же ссылке авторизации со своим идентификатором приложения ClientID (см. выше) и скопируйте новый токен.
Примечание: для авторизации используется протокол OAuth 2.0, общая схема взаимодействия приложения с OAuth-сервером представлена в официальной документации Яндекса.
Создание рабочего процесса
Теперь перейдите в свой n8n и создайте новый рабочий процесс (workflow):
Создание workflow
Manual Trigger
После этого создайте первый узел Manual Trigger. Он нужен, чтобы вы могли запускать workflow вручную во время настройки и тестирования, не дожидаясь расписания. Нажмите на кнопку Add first step, а затем в поиске введите Manual Trigger и выберите его:
Manual Trigger
Добавьте его на холст. На этом шаге никаких дополнительных настроек не требуется.
Добавление первого узла
Получение идентификатора пользователя
Следующий узел - HTTP Request. Именно он будет обращаться к API Яндекс Вебмастера. Поскольку для n8n нет отдельного узла для Вебмастера, мы используем универсальный HTTP Request (HTTP-запрос) с вашим OAuth-токеном (авторизационным токеном).
Наведите на Manual Trigger, должен появится значок +. Нажмите его и выберите узел HTTP Request:
HTTP Request
Настройте его следующим образом, указав данные в центральной области открывшегося окна:
- Method - GET;
- URL - https://api.webmaster.yandex.net/v4/user
- Authentication - None
Настройки HTTP Request
Далее активируйте опцию Send Headers и добавь заголовок со следующими данными в полях:
- Name: Authorization
- Value: OAuth ваш_токен_доступа (слово OAuth обязательно с большой буквы, пробел, и сам токен).
Это должно выглядеть так:
Добавление заголовка вручную
Такие настройки узла нам нужны для того, чтобы получить идентификатор пользователя. Нажмите кнопку Execute step для проверки. В ответе вы должны получить JSON вида:
|
1 2 3 |
{ "user_id": 12345678 } |
Этот идентификатор необходим для вызова любых ресурсов API Яндекс Вебмастера:
Получение идентификатора пользователя
Сохраните это значение. Оно нам пригодится дальше.
Получение списка сайтов
Следующий шаг - получить список сайтов, привязанных к вашему аккаунту Вебмастера, вместе с их идентификаторами. Это нужно, чтобы в запросе указать именно тот сайт, данные по которому вас интересуют.
Для этого в настройках уздла HTTP Request просто замените URL на:
|
1 |
https://api.webmaster.yandex.net/v4/user/{user-id}/hosts |
, где вместо {user-id} укажите идентификатор пользователя, который вы получили ранее.
URL для получения списка сайтов пользователя
Все остальные настройки оставьте без изменений. Повторно нажмите на кнопку Execute step для проверки. В ответе вы должны получить JSON вида:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
{ "hosts": [ { "host_id": "http:ya.ru:80", "ascii_host_url": "http://xn--d1acpjx3f.xn--p1ai/", "unicode_host_url": "http://Яндекс рф/", "verified": true, "main_mirror": { "host_id": "http:ya.ru:80", "verified": true, "ascii_host_url": "http://xn--d1acpjx3f.xn--p1ai/", "unicode_host_url": "http://Яндекс рф/" } }, ... ] } |
Если под учетной записью у вас несколько сайтов, тогда вы получите список всех сайтов, добавленных пользователем, и сводную информацию о каждом из них:
Получение списка сайтов пользователя
Для последующих обращений к API и выгрузки данных о поисковых запросах нам нужен host_id (идентификатор сайта). Поэтому скопируйте это значение и сохраните его вместе с идентификатором пользователя. Для моего сайта osipenkov.ru - это https:osipenkov.ru:443 (строковое значение, string).
HTTP Request
Так как вы уже сохранили свои идентификаторы, можно упростить процесс создания workflow и не добавлять дополнительные запросы. Теперь мы будем использовать уже созданный узел HTTP Request для выполнения итогового запроса и получения информации о популярных поисковых фразах.
В качестве примера выгрузим список топ-500 поисковых запросов, по которым сайт показывался на поиске за последнюю неделю. Для этого нужно использовать следующий URL:
|
1 |
https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/search-queries/popular |
, где дополнительно можно передать параметры запроса:
|
1 2 3 4 5 6 7 |
? order_by=<string> & [query_indicator=<string>] & [device_type_indicator=<string>] & [date_from=<datetime>] & [date_to=<datetime>] & [offset=<int32>] & [limit=<int32>] |
Расшифровка:
- user-id - идентификатор пользователя (получили ранее);
- host-id - идентификатор сайта (получили ранее);
- order_by - показатель для сортировки запросов (обязательный параметр);
- query_indicator - индикаторы для отображения запросов (по количеству показов, кликов, средней позиции показа и средней позиции клика);
- device_type_indicator - тип устройства. Значение по умолчанию: ALL (все устройства);
- date_from - дата начала интервала. Если не указан, то данные возвращаются за последнюю неделю;
- date_to - дата конца интервала. Если не указан, то данные возвращаются за последнюю неделю.
- offset - смещение списка. Минимальное значение - 0. Значение по умолчанию: 0;
- limit - количество записей (1-500). Значение по умолчанию: 500.
Чтобы не усложнять себе запрос, первую выгрузку данных из Яндекс Вебмастера сделаем без каких-либо дополнительных параметров.
Вернитесь в n8n в настройки узла HTTP Request и в поле URL добавьте:
|
1 |
https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/search-queries/popular |
, где вместо {user-id} и {host-id} укажите данные для своего проекта - идентификатор пользователя и идентификатор сайта.
Дополнительно в качестве обязательного параметра нужно добавить order_by - показатель для сортировки запросов. В API Яндекс Вебмастера доступно два варианта:
- TOTAL_SHOWS - по количеству показов;
- TOTAL_CLICKS - по количеству кликов.
В качестве примера я буду использовать TOTAL_SHOWS.
И чтобы данные в результатах отображались с конкретным значением показов для каждой поисковой фразы, также необходимо в параметрах запросах указать индикатор для отображения запросов query_indicator:
- TOTAL_SHOWS - количество показов;
- TOTAL_CLICKS - количество кликов;
- AVG_SHOW_POSITION - средняя позиция показа;
- AVG_CLICK_POSITION - средняя позиция клика.
Таким образом, итоговый URL будет выглядеть так:
|
1 |
https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/search-queries/popular?order_by=total_shows&query_indicator=total_shows |
Вставьте этот URL в настройках узла:
Запрос для получения информации о популярных поисковых запросах
Остальные настройки оставьте без изменений. Протестируйте узел, нажав на кнопку Execute step. Если вы все сделали правильно, справа откроется панель с данными, полученными от API. В теле ответа найдите поле queries. Это массив, в котором содержатся ваши поисковые запросы с выбранными показателями (показов, кликов или позиций).
Информация о популярных поисковых запросах (API Яндекс Вебмастера)
Прокрутите список и убедитесь, что данные приходят именно по вашему сайту. Если массив не пуст, значит вы успешно подключились к API Яндекс Вебмастера и можете двигаться дальше. Если вместо данных вы видите пустой массив или сообщение об ошибке, проверьте еще раз ваш OAuth-токен и идентификаторы сайта. Скорее всего, ошибка именно там.
Лучшие специалисты уже записались на онлайн-курс «n8n для маркетологов». А вы в их числе?
Когда вы убедились, что все работает, переходите к следующему шагу - обработке полученных данных перед записью в Google Таблицы.
Преобразование данных (Code)
Данные по API Вебмастера приходят в формате JSON со сложной вложенной структурой. Google Таблицы же ожидают простой плоский список - строки и столбцы. Поэтому между HTTP-запросом и загрузкой статистики в таблицу всегда должен быть узел-обработчик.
Вернитесь на свой холст в n8n и нажмите на иконку + рядом с узлом HTTP Request (с которого вы только что получили данные). В поиске введите Code и выберите его:
Code
Далее нажмите на Code in JavaScript:
Code in JavaScript
Это универсальный узел, благодаря которому можно преобразовать полученные данные из Вебмастера в нужный формат для Google Sheets.
В открывшемся окне узла найдите поле JavaScript и вставьте следующий скрипт:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
// Получаем все элементы, которые пришли в узел const items = $input.all(); // Создаем массив для результатов const result = []; // Проходим по каждому элементу (в вашем случае он обычно один) for (const item of items) { const data = item.json; const queries = data.queries || []; // Если есть запросы, добавляем их в результат if (queries.length > 0) { for (const q of queries) { const indicators = q.indicators || {}; result.push({ 'Поисковый запрос': q.query_text || '', 'Показы': indicators.TOTAL_SHOWS || 0 }); } } } // Возвращаем все преобразованные строки return result; |
В n8n это будет выглядеть так:
Код JavaScript
Этот небольшой скрипт преобразует данные, полученные от API Яндекс Вебмастера, в плоскую структуру, готовую для записи в Google Таблицы. Он извлекает из сложного JSON-ответа только самое важное: сам поисковый запрос и количество показов (в моем примере). В результате каждый запрос превращается в отдельную строку с понятными заголовками, которые безошибочно сопоставляются со столбцами вашей таблицы.
После вставки скрипта нажмите кнопку Execute Step. В выводе справа (Output) вы должны увидеть аккуратный массив (по умолчанию - 500 записей):
Результат после преобразования данных
При желании вы можете сопоставить полученные данные с интерфейсными значениями, перейдя в Яндекс Вебмастер (отчет Эффективность - Статистика запросов):
Данные в интерфейсе Вебмастера сходятся со статистикой по API
Как видите, данные по API и в интерфейсе Вебмастера сходятся. Теперь вы можете переходить к завершающему шагу выгрузки в Google Таблицы.
Google Таблицы
Продолжаем создавать свой рабочий процесс в n8n. Вернитесь на холст и нажмите на + рядом с последним узлом Code. В поиске наберите Google Sheets и выберите его:
Google Sheets
В узле есть два режима:
- Actions (действия);
- Triggers (триггеры).
Для нашей задачи (записи данных в Google Таблицу) нужен Actions. Триггеры используются, когда нужно запустить workflow в ответ на изменения в таблице (например, кто-то добавил строку, отредактировал или удалил ее). Но нам это не нужно.
Наш сценарий сейчас (для примера) - это Append row in sheet (добавить строку на лист):
Google Sheets - Append row in sheet
Каждый запуск будет добавлять новые строки в конец таблицы, а не заменять старые.
В открывшемся окне Google Sheets в поле Credential to connect with выберите + Create new credential:
+ Create new credential
Перед вами откроется такое окно:
Google Sheets OAuth2 API
Создание проекта Google Cloud
Для того, чтобы выгружать данные Яндекс Вебмастера в Google Таблицы, вам потребуется протокол OAuth 2.0 для аутентификации и авторизации.
В n8n это называется Google OAuth2 single service - тип учетных данных (credentials) для аутентификации в конкретном сервисе Google. Он упрощает настройку по сравнению с универсальным вариантом, ограничивая доступ только нужным API. Этот подход можно использовать для следующих узлов Google: Google Calendar, Google Contacts, Google Mail, Google Sheets (наш вариант), Google Sheets Trigger, Google Tasks, Google Analytics.
В официальной справке сервиса подробно описана настройка Google OAuth2 single service, а также добавлена видеоинструкция:
Первое, что нужно сделать - это создать проект в Google Cloud. А для этого вам необходим аккаунт Google. Если у вас нет аккаунта на Gmail.com, создайте его. После создания аккаунта (или использования текущего) перейдите по адресу console.cloud.google.com и создайте свой первый проект в Google Cloud.
Регистрация в облаке Google
В связи с текущими событиями в мире Google приостановил работу для пользователей из России. На данный момент вы не сможете выбрать из списка стран Россию и привязать банковскую карту, выпущенную на территории РФ. Но вы можете указать любую другую страну из списка (например, Казахстан) и не добавлять платежные реквизиты, поскольку для выгрузки данных из Вебмастера в Google Таблицы оплата не требуется.
Если вы впервые используете облачные службы Google, тогда вас попросят добавить страну (Country) и дать согласие с условиями предоставления услуг Google Cloud Platform. Подтвердите свои действия с помощью Agree and Continue.
В левом верхнем углу нажмите на Select A project:
Выберите проект
И создайте новый проект – New Project:
Новый проект
Появится окно создания проекта. Задайте название вашему проекту в поле Project name (например n8n-webmaster, или оставьте по умолчанию) и нажмите кнопку Create:
Создание проекта
Через несколько секунд в Google Cloud будет создан ваш новый проект, а на панели управления в правом верхнем углу отобразится соответствующее уведомление:
Уведомление об успешном создании проекта
В завершение нажмите на Select Project, чтобы выбрать только что созданный проект Google Cloud.
Активация API
Выбрав созданный проект, в строке поиска сверху введите Google Sheets API:
API Google Таблиц
Включите API, нажав на кнопку Enable:
Включение Google Sheets API
Статус Enabled свидетельствует об успешной активации Google Sheets API:
Активный статус Google Sheets API
Проделайте то же самое для Google Drive API. Найдите его в поиске:
Google Drive API
А затем активируйте его:
Активный статус Google Drive API
Настройка экрана согласия OAuth
Если вы ранее не использовали OAuth в своем проекте Google Cloud, вам потребуется настроить экран согласия OAuth.
Чтобы это сделать, в Google Cloud после создания проекта перейдите в раздел APIs & Services - OAuth consent screen:
APIs & Services - OAuth consent screen
В открывшемся окне нажмите кнопку Get started:
Get started
Введите название приложения (например - n8n-webmaster-api) в поле App name и адрес электронной почты службы поддержки пользователей в поле User support email (укажите свою собственную), которые будут отображаться на экране аутентификации OAuth.
Название приложения и адрес электронной почты
Нажмите Next, чтобы продолжить. Если вы используете внутренний аккаунт Google Workspace, то на следующем экране вам будет доступен выбор внутреннего доступа (Internal), только пользователям внутри вашей организации. Нас же интересует внешний доступ (External), чтобы доступ был доступен любому пользователю, имеющему учетную запись Google. Выберите External и нажмите Next:
Audience - External
На следующем шаге укажите адрес электронной почты, который Google должен использовать для связи с вами по поводу изменений в вашем проекте:
Электронная почта для связи с вами
Нажмите Next. На заключительном шаге ознакомьтесь с политикой Google в отношении пользовательских данных и примите ее:
Согласие с политикой Google в отношении пользовательских данных
Нажмите Continue и Create.
APIs & Services - Credentials
На открывшейся странице нажмите + Create credentials и выберите OAuth client ID:
Create credentials - OAuth client ID
Из выпадающего списка Application type выберите Web application:
Application type - Web application
Google автоматически сгенерирует имя приложению. Вы можете изменить его на любое другое, какое пожелаете (например - n8n-client):
Название - n8n-client
В поле Authorized redirect URIs вам нужно вставить ссылку OAuth Redirect URL, которую вы видите в вашем окне n8n:
Скопируйте OAuth Redirect URL из интерфейса n8n
Скопируйте и добавьте ее в поле:
Authorized redirect URIs
В завершение нажмите кнопку Create. Вам откроется окно, из которого нужно будет скопировать значения Client ID и Client secret:
Скопируйте значения Client ID и Client secret
Сохраните их в блокноте и никому не показывайте! Нажмите ОК.
Добавление тестового пользователя
Чтобы в процессе авторизации Google не ругался на вашу учетную запись, добавьте себя в качестве тестового пользователя. Для этого в меню слева перейдите в раздел APIs & Services - OAuth consent screen:
APIs & Services - OAuth consent screen
Откройте вкладку Audience и внизу страницы найдите секцию Test users. Нажмите + Add users:
Audience - Test users - Add users
Введите ваш полный адрес электронной почты Gmail:
Добавление тестового пользователя
Нажмите Save.
Google Sheets OAuth2 API
Вернитесь в интерфейс n8n и добавьте в настройку Google Sheets OAuth2 API недостающие данные - Client ID и Client Secret:
Вставьте свои значения в поля Client ID и Client Secret
После этого у вас появится кнопка и возможность авторизоваться с помощью учетной записи Google:
Вход с помощью аккаунта Google
В открывшемся окне выберите свою учетную запись Gmail и нажмите Далее. Вам должно высветиться сообщение о том, что приложение пока не проверено экспертами Google. Это нормально. Нажмите на ссылку Продолжить:
Продолжить
Предоставьте приложение все нужные доступы, выбрав все:
Права доступа к вашему аккаунту Google
Нажмите Продолжить. После этого окно закроется, а в окне подключения Google Sheets OAuth2 API появится уведомление об успешном подключении аккаунта:
Успешное подключение аккаунта Google
Переименуйте учетные данные (например, на Yandex Webmaster To Google Sheets) и закройте окно, нажав на иконку крестика в правом верхнем углу.
Вернитесь к настройкам узла Google Sheets. Теперь в поле Credential to connect with вы сможете выбрать созданную учетную запись из выпадающего списка:
Credential to connect with
В поле Resource оставьте Sheet Within Document. Так как мы работаем с конкретным листом внутри Google Таблицы, этот выбор - правильный.
Resource - Sheet Within Document
Для Operation оставьте Append Row. Каждый запуск будет добавлять новые строки в конец вашей таблицы, сохраняя всю историю, как мы и хотели.
Operation - Append Row
В узле Google Sheets доступно несколько операций, и выбор зависит от того, какую задачу вы решаете:
- Append Row - добавляет новые строки в конец таблицы. Это идеальный выбор, если вы ведете историю данных: каждый запуск дописывает свежие строки, не затрагивая старые записи. Такой подход подходит для сбора ежедневной статистики, логов или событий;
- Update Row - обновляет существующие строки. Используйте, если нужно актуализировать данные, например, корректировать позиции или цены в уже имеющихся строках.
- Append or Update Row - комбинированный режим: если строка существует - обновляет ее, если нет - создает новую. Удобно, когда вы работаете с уникальными идентификаторами (например, ID запроса или дата + ключ);
- Clear Sheet / Delete Row - удаляют данные. Применяются, если нужно полностью перезаписать лист или удалить устаревшие записи перед новой загрузкой;
- Create Sheet / Delete Sheet - управляют самими листами внутри документа. Используйте, чтобы автоматически создавать новый лист под каждый отчет.
Для нашей задачи мы выбрали Append Row. Именно он позволяет накапливать данные день за днем без риска потерять предыдущие записи. Однако при работе с другими процессами (например, обновление курсов валют, синхронизация статусов заказов или перезапись отчетов) выбор операции может быть другим. Всегда исходите из того, нужно ли вам дополнить, обновить или полностью перезаписать данные.
Откройте вашу Google Таблицу в браузере (куда вы планируете выгружать данные Яндекс Вебмастера) и скопируйте ее идентификатор. Он находится в URL вашей таблицы между /d/ и /edit.
Копирование идентификатора (ID) Google Таблицы
Вернитесь к настройкам узла Google Sheets в n8n. В разделе Document выберите из выпадающего списка By ID. В поле рядом вставьте идентификатор вашей Google Таблицы, который вы скопировали на предыдущем шаге:
Идентификатор Google Таблицы (By ID)
Для Sheet выберите из списка название вашего листа (обычно это Лист1 или Sheet1). Если его нет в списке, нажмите Enter Name и напишите Лист1 (или как вы его назвали) вручную.
Название листа в Google Таблице (From list)
Чтобы все прошло гладко, заранее создайте в вашей Google Таблице заголовки (шапку) на первой строке. Они должны точно совпадать с ключами, которые вы возвращаете в узле Code:
- Поисковый запрос
- Показы
Заголовки для таблицы
Это не обязательно, но рекомендуется (сделайте это!). Тогда n8n автоматически сопоставит данные с нужными столбцами, и запись пройдет идеально.
В настройках узла Google Sheets для параметра Mapping Column Mode мы выбираем Map Automatically, при условии, что заголовки в таблице заранее созданы и точно совпадают с названиями полей в скрипте.
Mapping Column Mode - Map Automatically
Это самый простой способ, который не требует ручного сопоставления. Если же вы сомневаетесь в совпадении или хотите явно контролировать процесс, используйте Map Each Column Manually и укажите соответствие полей столбцам вручную. Оба способа рабочие, но автоматический режим экономит время и меньше подвержен ошибкам при правильной подготовке таблицы.
Запуск рабочего процесса
Осталось сделать всего одну вещь - запустить рабочий процесс и убедиться, что данные записываются корректно. Откройте свой рабочий процесс и нажмите на кнопку Execute Workflow:
Запуск итогового рабочего процесса (Execute workflow)
n8n последовательно выполнит все шаги вашего сценария. Сначала отправится запрос к API Яндекс Вебмастера, который вернет данные о поисковых запросах за последние семь дней. Затем в дело вступит узел Code. Он преобразует полученный JSON в плоскую структуру. И наконец, узел Google Sheets запишет подготовленные строки в вашу таблицу, дополнив ее новыми данными.
Успешное выполнение рабочего процесса
Откройте Google Таблицу и проверьте результат. Если все настроено верно, вы увидите новые строки с колонками Поисковый запрос и Показы.
Выгрузка данных Яндекс Вебмастера в Google Таблицы
Как вы помните, мы выполнили самый простой запрос к API без каких-либо дополнительных параметров. Поэтому в моей таблице количество выгруженных записей по умолчанию - 500.
Если ваши данные появились, значит workflow работает корректно. Если же что-то пошло не так, n8n подсветит узел, на котором произошла ошибка. Это поможет быстро найти и исправить проблему. Подробнее обо всех ошибках и статусах запуска рабочего процесса вы можете узнать на вкладке Executions. Там отображается каждый запуск: успешный он был или завершился ошибкой, а также длительность выполнения и объем переданных данных.
Вкладка "Executions"
Усовершенствование workflow
Мы с вами создали с нуля полностью рабочий процесс для выгрузки популярных поисковых запросов из Яндекс Вебмастера в Google Таблицы с помощью n8n. Однако его можно усовершенствовать различными способами. Вот некоторые идеи, которые вы можете попробовать самостоятельно:
- выгружать статистику посуточно (чтобы видеть динамику и изменение статистики каждого поискового запроса), а не за интервалы дат;
- проверять, что данные уже за выбранные даты записались в таблицу, и не удалять их (не перезаписывать), а добавлять (дозаписывать) в таблицу;
- добавить на соседние листы не только популярные запросы, но и все поисковые запросы, либо же выбрав конкретные;
- выгружать все записи, а не только первые 500 по умолчанию. Для этого можно использовать параметр offset (смещение списка);
- настроить выгрузку и обновление данных по расписанию, в определенное время.
Эти доработки превратят ваш workflow из простого инструмента выгрузки в полноценную SEO-аналитическую систему. Вы сможете не просто фиксировать текущую ситуацию, а отслеживать тренды, замечать сезонные колебания и своевременно корректировать контент-стратегию. А если вы решите пойти еще дальше, попробуйте объединить эти данные с отчетами из Яндекс Метрики или Яндекс Директа. Тогда перед вами откроется полная картина того, как поисковые запросы превращаются в реальные действия пользователей на сайте!
Хотите перестать зависеть от разработчиков, экономить на дорогих коннекторах и собирать собственные дашборды любой сложности? Начните управлять данными профессионально. На моем онлайн-курсе по n8n вы научитесь связывать в единую экосистему любые источники: Яндекс Метрику, Яндекс Директ, Яндекс Вебмастер, Google Analytics 4, Google Ads, Google Search Console, VK Рекламу, Facebook Ads* и CRM-системы. Записывайтесь уже сейчас!
* Продукт компании Meta, которая признана экстремистской организацией в РФ.
Итоговый шаблон n8n
Скачать итоговый шаблон n8n из этого руководства вы можете на моей образовательной платформе edu.osipenkov.ru, в разделе Материалы.
СКАЧАТЬ ПРОГРАММУ
Загрузите шаблон workflow и сохраните его на компьютере. Чтобы импортировать его в n8n, создайте новый рабочий процесс, затем кликните на иконку с тремя точками в правом верхнем углу и выберите пункт Import from file... Весь процесс займет буквально пару кликов.
Import from file...
