Сделал сокращатель ссылок, которым умеет пользоваться ИИ-агент. Нужен ли такой кому-то, кроме меня?
Сокращателей ссылок десятки. Писать ещё один в 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.
- Боты в статистике — см. выше. Без фильтрации половина «кликов» по свежей ссылке приходилась на превью.
Вопросы к вам
Мне правда важна обратная связь, поэтому вместо вывода — вопросы.
- Нужен ли вообще такой сервис? Если вы пользуетесь сокращателями, то каким и для чего? Чего не хватает в Bitly, TinyURL и других, к которым вы привыкли? И есть ли среди вас те, кто уже работает с ИИ-агентами и хотел бы отдать им ссылки?
- Какие функции добавить? Есть мысли про свои домены (go.вашдомен.ru), A/B-ссылки с разными адресами назначения, ссылки с паролем и сроком жизни, браузерное расширение, интеграции с Zapier, Make и Notion. В Telegram-боте — статистику и QR-коды прямо в чате. Что из этого вам реально пригодилось бы, а что лишнее?
- Что улучшить? Если зайдёте на linkbit.live, напишете боту в Telegram или подключите MCP, напишите, что было непонятно, где споткнулись, что раздражает. И отдельно про 30 дней жизни ссылок на бесплатном тарифе: это нормально или отталкивает сразу?
Если интересно, как сделана какая-то часть (MCP-сервер, проверка ссылок, деплой на маленьком VPS), напишите в комментариях. Разберу подробнее в отдельной статье.