Сделал сокращатель ссылок, которым умеет пользоваться ИИ-агент. Нужен ли такой кому-то, кроме меня?

Сокращателей ссылок десятки. Писать ещё один в 2026 году — затея странная, я это понимаю. Но у меня была конкретная бытовая боль, и готовые сервисы её не закрывали. За два месяца по вечерам получился LinkBit. В статье расскажу, зачем он вообще появился, как устроен внутри и на какие грабли я наступил. А в конце задам несколько вопросов: мне правда важно понять, нужен ли он кому-то ещё.

Откуда взялась задача

Я фрилансер, пишу на PHP и Drupal с 2010 года, последние пару лет много занимаюсь автоматизацией на ИИ. Каждый день работаю с Claude Code, Cursor и n8n. И всё время повторялся один и тот же сценарий.

Агент пишет рассылку, пост или release notes, и в тексте есть ссылка. Мне нужна короткая ссылка с UTM-метками, чтобы потом понять, откуда пришли клики. Значит, я выхожу из редактора, открываю сокращатель, вставляю URL, руками собираю utm_source, utm_medium, utm_campaign, копирую результат обратно. Через неделю иду в третью вкладку смотреть статистику.

Агент при этом умеет почти всё, кроме самого простого: создать ссылку и посмотреть по ней клики. Большинство сокращателей сделаны для человека, который нажимает кнопки. У некоторых есть API, но подключить его к агенту — это отдельная мини-интеграция.

Отсюда идея: сокращатель, у которого с первого дня есть и обычный интерфейс, и REST API, и MCP-сервер. Причём всё это на бесплатном тарифе.

Что получилось

Для человека:

  • короткие ссылки со своими слагами: linkbit.live/spring вместо URL на 200 символов;
  • аналитика кликов: страны, устройства, источники, график по дням;
  • UTM-конструктор и генератор QR-кодов (PNG, SVG, версия для печати) прямо в браузере, без регистрации;
  • импорт ссылок из CSV;
  • интерфейс на 6 языках: английском, японском, корейском, турецком, польском и тайском.

Для агента и автоматизации:

  • REST API с ключом slk_…;
  • MCP-сервер linkbit-mcp на npm с 9 инструментами: создать одну или несколько ссылок, получить список, изменить, отключить, удалить ссылку, сделать QR-код, получить статистику по ссылке и по аккаунту;
  • готовые шаблоны для n8n и пример GitHub Action, который сокращает ссылки на релизы.

В Telegram:

  • бот @LinkBitShortLinkBot: присылаешь ссылку в личку, получаешь короткую. Регистрация не нужна;
  • если отправить боту свой email, все созданные им ссылки появятся в кабинете на сайте после входа или регистрации с этим адресом.

Подключение к Claude Code — одна команда:

claude mcp add linkbit -e API_KEY=slk_ваш_ключ -e APP_URL=https://linkbit.live -- npx -y linkbit-mcp

Дальше просто пишешь агенту обычным текстом:

Сократи https://example.com/campaign со слагом spring и utm_source newsletter

Покажи клики по последней ссылке с 1 января

Отключи эту ссылку и сделай QR для печати в PNG

Для Claude Desktop и Cursor то же самое прописывается в mcp.json, инструкция есть на странице /mcp.

Как устроено

Стек скучный, и это осознанный выбор:

  • Next.js 15 (App Router) и React 19: и интерфейс, и API, и редиректы живут в одном приложении;
  • PostgreSQL и Drizzle ORM;
  • next-intl для 6 языков;
  • Docker Compose на одном VPS: 2 vCPU и 3,8 ГБ памяти. Перед ним Caddy, перед Caddy Cloudflare;
  • деплой через GitHub Actions: образ собирается в CI, а на сервер приезжает уже готовым. Собирать Next.js на 2 vCPU — плохая идея: во время сборки падало соседнее.

В покое LinkBit занимает около 120 МБ памяти и почти не нагружает процессор. Для сокращателя большего и не нужно: основная нагрузка — это редирект, то есть один запрос к индексу по слагу и запись клика.

MCP-сервер

MCP-сервер — тонкая обёртка над тем же REST API, отдельной логики в нём нет. Он запускается локально через npx и общается с клиентом по stdio. Пара решений, которые оказались важными:

  • Ошибки возвращаются как результат инструмента (isError: true), а не как ошибки протокола JSON-RPC. Когда ключ неверный, лимит исчерпан или URL небезопасный, модель получает понятный текст вроде «401 Unauthorized: API_KEY is invalid. Create a key at …» и может объяснить пользователю, что делать. Если отдать то же самое ошибкой протокола, клиент часто показывает просто «tool failed».
  • Опасные инструменты помечены destructiveHint: true (delete_link, disable_link). Клиенты вроде Claude спрашивают подтверждение перед вызовом.
  • Существующие UTM-метки не перезаписываются, а #fragment сохраняется. Звучит мелочью, но модели любят переписывать URL «как им кажется правильнее». Поэтому сервер должен вести себя предсказуемо, даже когда модель передала лишнее.

Telegram-бот без отдельного процесса

Бот живёт внутри того же Next.js-приложения: Telegram присылает каждое сообщение вебхуком на POST /api/telegram, отдельного процесса с long polling нет. Запросы без секрета вебхука отбрасываются с 401, а сам секрет вычисляется из токена бота, так что хранить ещё одну переменную не нужно.

Интереснее было с владельцем ссылок. Человек пишет боту, не регистрируясь, а ссылки при этом должны кому-то принадлежать: нужны лимиты, проверки, статистика. Поэтому сначала ссылки создаются на служебном аккаунте, без возможности входа. Чат запоминается, и на него действует лимит 30 ссылок в сутки. Если прислать боту email, он привязывается к чату. Когда человек входит или регистрируется на сайте с этим адресом, все его ссылки из бота переезжают в личный кабинет вместе со статистикой.

Одна деталь деплоя: setWebhook пришлось вызывать с хоста. Из сети Docker-контейнера api.telegram.org у меня резолвился через раз.

Защита от злоупотреблений

Сокращатель ссылок — любимый инструмент фишеров: короткая ссылка прячет настоящий адрес. Если ничего не делать, домен быстро окажется в чёрных списках, и все ссылки начнут показывать предупреждение браузера. Поэтому каждая ссылка при создании проверяется:

  • через Google Safe Browsing;
  • по цепочке редиректов. Адрес может вести на «чистый» домен, который потом перенаправит на фишинг, поэтому проверяется и то, куда ведёт редирект;
  • по собственному блок-листу и с учётом жалоб: на сайте есть форма «Report a link».

Плюс лимиты: на бесплатном тарифе 100 новых ссылок в день.

Честная аналитика

Первая версия аналитики показывала красивые цифры, которые ничего не значили. Ссылку вставляешь в Telegram, Slack или LinkedIn — и сразу несколько ботов приходят за превью. Их клики отфильтровываются по User-Agent: краулеры поисковиков, боты превью мессенджеров и соцсетей, сервисы мониторинга, headless-браузеры. Страну берём из заголовка CF-IPCountry от Cloudflare, без отдельной GeoIP-базы.

Модель монетизации

  • Free — 100 ссылок в день, аналитика, слаги, UTM, QR, API и MCP. Ссылки живут 30 дней.
  • Pro — $7 в месяц: ссылки бессрочные, лимиты API выше, импорт CSV до 2000 ссылок.
  • Business — $24 в месяц: максимальные лимиты API и MCP, рецепты для Slack и GitHub, приоритетная поддержка.

30 дней на бесплатном тарифе — компромисс. Бессрочные бесплатные ссылки — это обещание держать их живыми вечно за свой счёт. Так закрылось уже много бесплатных сокращателей, и вместе с ними сломались миллионы ссылок в старых постах. Мне честнее сразу сказать: хочешь навсегда — это $7.

Грабли

  • Бэкапы, которых не было. Скрипт бэкапа запускался при каждом деплое. Перед публичным запуском я решил проверить, и оказалось, что он не отработал ни разу. Деплой делает chmod 644 на все файлы, скрипт терял право на исполнение, а ошибку глушил || true. Теперь бэкап запускается по cron вне репозитория и хранит последние 7 дампов. Мораль банальная: бэкап, который ни разу не восстанавливали, бэкапом не считается.
  • Сборка на проде. Уже упоминал: docker compose up --build на маленьком VPS забирал всю память, и падали соседние сервисы. Решилось сборкой образа в CI.
  • Боты в статистике — см. выше. Без фильтрации половина «кликов» по свежей ссылке приходилась на превью.

Вопросы к вам

Мне правда важна обратная связь, поэтому вместо вывода — вопросы.

  1. Нужен ли вообще такой сервис? Если вы пользуетесь сокращателями, то каким и для чего? Чего не хватает в Bitly, TinyURL и других, к которым вы привыкли? И есть ли среди вас те, кто уже работает с ИИ-агентами и хотел бы отдать им ссылки?
  2. Какие функции добавить? Есть мысли про свои домены (go.вашдомен.ru), A/B-ссылки с разными адресами назначения, ссылки с паролем и сроком жизни, браузерное расширение, интеграции с Zapier, Make и Notion. В Telegram-боте — статистику и QR-коды прямо в чате. Что из этого вам реально пригодилось бы, а что лишнее?
  3. Что улучшить? Если зайдёте на linkbit.live, напишете боту в Telegram или подключите MCP, напишите, что было непонятно, где споткнулись, что раздражает. И отдельно про 30 дней жизни ссылок на бесплатном тарифе: это нормально или отталкивает сразу?

Если интересно, как сделана какая-то часть (MCP-сервер, проверка ссылок, деплой на маленьком VPS), напишите в комментариях. Разберу подробнее в отдельной статье.