Как подключить egrul.org в ChatGPT, Claude, Google Таблицы и Google Docs

Три способа перестать копировать ИНН руками между сайтом и своими документами: спросить ИИ-чат напрямую, вытащить данные формулой в Google Таблицах или вставить готовую карточку организации в Google Docs одной кнопкой. Везде — тот же API и тот же токен подписки, что и для остального сайта.

Содержание

Всё ниже — для платной подписки (JSON-доступ). Без подписки те же данные доступны бесплатно в HTML на карточке организации — просто не формулой и не в чате.

Токен — тот же, что и для остального API: email + токен из личного кабинета (/subscribe/reg/), вместе они образуют Bearer-строку email:token. Она нужна во всех трёх сценариях ниже — храните её как пароль (в коде Apps Script она видна всем, у кого есть доступ на редактирование скрипта, поэтому не кладите её в общий с коллегами документ без необходимости).

Через MCP-сервер (https://egrul.org/mcp/) ИИ сам решает, когда и какой метод API вызвать — вы просто пишете вопрос обычным языком, без JSON и без копирования ссылок.

Тот же принцип — «добавить свой MCP-сервер» по URL https://egrul.org/mcp/ с OAuth. У Gemini это внутри режима Spark (пока не везде доступен), у Perplexity — в Connectors на подписке Pro/Max/Enterprise, у Grok — на grok.com/connectors → New Connector → Custom.

После подключения — просто вопросом в чате, без команд и синтаксиса:

ИИ сам вызовет нужный инструмент MCP (карточку, поиск, санкции, связи и т.д.) и перескажет ответ — какие именно инструменты есть, ИИ тоже видит сам, полный список не нужно запоминать.

Пользовательская функция на Google Apps Script — работает как обычная формула в ячейке, тянет данные напрямую с egrul.org.

/** * Данные организации по ИНН/ОГРН с egrul.org. * Использование: =EGRUL_ORG(A1; "short_name") * Доступные поля: short_name, full_name, address, reg_date, ogrn, inn, kpp. * Без второго аргумента — весь ответ одной строкой JSON. */ function EGRUL_ORG(inn, field) { var EMAIL = 'you@example.com'; var TOKEN = 'your_api_token'; if (!inn) return ''; var url = 'https://egrul.org/' + encodeURIComponent(String(inn).trim()) + '.json'; var resp = UrlFetchApp.fetch(url, { headers: { 'Authorization': 'Bearer ' + EMAIL + ':' + TOKEN }, muteHttpExceptions: true, }); if (resp.getResponseCode() !== 200) { return 'Ошибка ' + resp.getResponseCode(); } var data = JSON.parse(resp.getContentText()); return field ? (data[field] || '') : JSON.stringify(data); }

Дальше в любой ячейке: =EGRUL_ORG(A2; "short_name") — если в A2 лежит ИНН, вернёт название организации. Протяните формулу вниз по столбцу — Таблицы сами подставят ИНН из каждой строки и проверят весь список. Каждый вызов формулы — отдельный запрос и списывает 1 из дневного лимита подписки, так же как обращение к сайту напрямую.

Google Таблицы кэшируют результат пользовательских функций и не пересчитывают их на каждое открытие файла — лишних списаний от одного и того же ИНН при простом просмотре таблицы не будет.

Скрипт, привязанный к документу, добавляет пункт меню — по нажатию спрашивает ИНН и вставляет в документ отформатированную карточку организации. Удобно для приложения к отчёту должной осмотрительности или служебной записке.

function onOpen() { DocumentApp.getUi() .createMenu('egrul.org') .addItem('Вставить карточку организации', 'insertOrgCard') .addToUi(); } function insertOrgCard() { var EMAIL = 'you@example.com'; var TOKEN = 'your_api_token'; var ui = DocumentApp.getUi(); var result = ui.prompt('Проверка организации', 'ИНН или ОГРН:', ui.ButtonSet.OK_CANCEL); if (result.getSelectedButton() !== ui.Button.OK) return; var inn = result.getResponseText().trim(); if (!inn) return; var url = 'https://egrul.org/' + encodeURIComponent(inn) + '.json'; var resp = UrlFetchApp.fetch(url, { headers: { 'Authorization': 'Bearer ' + EMAIL + ':' + TOKEN }, muteHttpExceptions: true, }); if (resp.getResponseCode() !== 200) { ui.alert('Ошибка ' + resp.getResponseCode() + ': ' + resp.getContentText()); return; } var d = JSON.parse(resp.getContentText()); var body = DocumentApp.getActiveDocument().getBody(); body.appendParagraph(d.short_name || d.full_name || inn) .setHeading(DocumentApp.ParagraphHeading.HEADING2); body.appendParagraph('ИНН: ' + (d.inn || '') + ' ОГРН: ' + (d.ogrn || '') + ' КПП: ' + (d.kpp || '')); if (d.address) body.appendParagraph('Адрес: ' + d.address); if (d.reg_date) body.appendParagraph('Дата регистрации: ' + d.reg_date); if (d.attention && d.attention.length) { body.appendParagraph('Внимание:').editAsText().setBold(true); d.attention.forEach(function (a) { body.appendParagraph('• ' + a.title + (a.details ? ' — ' + a.details : '')); }); } body.appendParagraph('Источник: ' + url).editAsText().setItalic(true); }

Каждый вызов «Вставить карточку организации» — один запрос из дневного лимита подписки. Для отчёта по нескольким контрагентам сразу — просто нажимайте пункт меню по одному разу на каждый ИНН.