Боты6 мин чтения·13 августа 2026 г.·обновлено 19 ноября 2026 г.

ClickUpLinkUnfurler в логах: превью для рабочих чатов

Разбираем ClickUpLinkUnfurler — бота платформы ClickUp, который подтягивает превью вашей ссылки для карточек в задачах и подключённых Slack-каналах. Показываем официально задокументированную функцию разворачивания ссылок, как найти бота в access.log и почему блокировка обычно не нужна.

TVTrafficVeil TeamКоманда сервиса · редакционная ответственность
Уникальная иллюстрация бота ClickUpLinkUnfurler: легитимный превью ссылок в соцсетях

В логах сайт может выглядеть «живым», хотя рост даёт не аудитория, а ClickUpLinkUnfurler с User-Agent clickuplinkunfurler. ClickUp — реальная и известная платформа управления проектами и задачами (clickup.com), а «разворачивание» ссылок в карточки с деталями — задокументированная функция её интеграции со Slack: на официальной странице интеграций ClickUp прямо указано «unfurl links with rich details and actions» — превращение обычной ссылки в карточку с подробностями прямо в Slack-переписке.

1. Что такое ClickUpLinkUnfurler

Когда пользователь ClickUp делится ссылкой (на задачу ClickUp или на внешнюю страницу, упомянутую в задаче или переписке) в подключённом Slack-канале, интеграция должна «развернуть» эту ссылку в карточку с заголовком, описанием и действиями — примерно так же, как соцсети формируют превью при шеринге. Именно за это, судя по всему, отвечает ClickUpLinkUnfurler. Есть и документированный исторический нюанс: в 2023 году пользователи сообщали о баге, при котором ссылки на задачи ClickUp не разворачивались в Slack при отправке через определённые настройки интеграции (поле «Send as Bot») — баг был признан и впоследствии исправлен, что подтверждает: за функцией стоит реальная, поддерживаемая инженерная команда, а не заброшенный сервис.

Название ClickUpLinkUnfurler
User-Agent / паттерн clickuplinkunfurler
Оператор ClickUp — платформа управления проектами и задачами
Роль Забирает Open Graph/метаданные для «разворачивания» ссылки в карточку с деталями — прежде всего в рамках интеграции ClickUp со Slack
Документация / ориентир clickup.com/integrations — официальная страница с описанием функции разворачивания ссылок как части интеграции со Slack; отдельной first-party страницы специально про бота для вебмастеров не найдено
Список IP ❌ Официального списка IP не найдено — проверяйте по UA и поведению
robots.txt Публичных данных о строгом соблюдении не найдено
Пометка TrafficVeil Легитимный / Превью ссылок в соцсетях

2. Зачем ClickUpLinkUnfurler приходит на сайт

Бот забирает Open Graph и meta-теги для превью ссылки — это происходит, когда конкретный пользователь ClickUp делится вашей ссылкой в контексте задачи, документа или подключённого Slack-канала, а не по фоновому расписанию произвольного обхода. Это классический точечный link preview-fetcher: запрос к конкретному переданному URL, а не индексация сайта.

  • Какие зоны чаще трогает: URL из шеринга, og:image, главные лендинги — конкретные страницы, которые кто-то упомянул в задаче ClickUp;
  • Что ищет: заголовок, описание и превью-изображение страницы для карточки с деталями;
  • Чем отличается от браузерного пользователя: нет нормальной сессии, обращение разовое и привязано к конкретному действию пользователя ClickUp, а не к произвольному расписанию.

Типичный кейс: маркетинг видит всплеск hits в Метрике/GA, но сессии пустые. Причина — ClickUpLinkUnfurler. Правильная реакция — не «выключить сайт», а точечно запретить UA, если превью в задачах и Slack-каналах пользователей ClickUp вам не нужны.

3. Нагрузка и риски именно для ClickUpLinkUnfurler

Отдельной строки в публичной сводке top-bot TrafficVeil у clickuplinkunfurler может не быть, но в категории «Превью ссылок в соцсетях» такие агенты дают характерный фон: при блокировке пользователи увидят «голую» ссылку без картинки и описания. Поскольку бот user-initiated, а не сканирует сайт сам, серьёзной фоновой нагрузки он обычно не создаёт — основной риск здесь репутационный/функциональный: сломанное превью в рабочих чатах пользователей ClickUp снижает узнаваемость и привлекательность ссылки при шеринге в командах.

Не уверены, кто ходит по вашему сайту?

Подключите домен и посмотрите живую ленту: кто пришёл, с какой сети, что запрашивал и по какому правилу был пропущен или заблокирован.

Посмотреть свой трафик

4. Как найти ClickUpLinkUnfurler в логах

Не ищите «просто ботов» — ищите конкретный токен clickuplinkunfurler и рядом смотрите соседей по семейству ботов предпросмотра ссылок.

# Базовый поиск
grep -i "clickuplinkunfurler" /var/log/nginx/access.log

# Топ URL, которые вычитывает бот
grep -i "clickuplinkunfurler" /var/log/nginx/access.log | awk '{print $7}' | sort | uniq -c | sort -rn | head

# Топ IP за этим UA
grep -i "clickuplinkunfurler" /var/log/nginx/access.log | awk '{print $1}' | sort | uniq -c | sort -rn | head

# Суточная активность
grep -i "clickuplinkunfurler" /var/log/nginx/access.log | awk '{print $4}' | cut -d: -f1 | sort | uniq -c

# Отделить от похожих строк семейства ботов предпросмотра
grep -iE "clickuplinkunfurler|bufferlinkpreviewbot|facebookexternalhit|arenaunfurlbot" /var/log/nginx/access.log | wc -l

Верификация. Подделать User-Agent может любой скрипт. Для решения allow/deny смотрите связку: UA + IP + частоту + набор URL. Официального списка IP ClickUp не публикует, поэтому опирайтесь на поведение — характерный признак настоящего link preview-бота этой категории: единичные точечные запросы к конкретным страницам, а не сканирование сайта.

IP="1.2.3.4"
whois -h whois.cymru.com " -v $IP"
dig +short -x "$IP"

5. robots.txt для ClickUpLinkUnfurler

# Жёсткий запрет
User-agent: clickuplinkunfurler
Disallow: /

# Разрешить всё
User-agent: clickuplinkunfurler
Allow: /

# Компромисс: закрыть деньги/кабинет, оставить публичку
User-agent: clickuplinkunfurler
Disallow: /admin/
Disallow: /cart/
Disallow: /checkout/
Disallow: /account/
Disallow: /api/
Allow: /

Важно: ставьте Disallow или 403 для clickuplinkunfurler, только если превью в задачах и Slack-каналах пользователей ClickUp вам принципиально не нужны — в большинстве случаев это не так, и блокировка скорее ухудшает восприятие ссылки в рабочих чатах, чем экономит ресурсы.

6. Блокировка вручную и через TrafficVeil

Nginx

Для одного и того же User-Agent выберите полный запрет или ограничение частоты. Вариант А сохраняет исходный шаблон User-Agent и ответ 403/410. Вариант Б применяют вместо этого запрета. Не включайте оба режима для одного совпадения: return завершит запрос до ограничения частоты. Это не запрещает сохранять независимые политики для другого трафика.

# Вариант А: исходные запреты. server {} показан как схема размещения.
server {
    # Добавьте эти if в существующий server, сохранив остальную конфигурацию.
    if ($http_user_agent ~* "clickuplinkunfurler") {
        return 403;
    }
    # Существующие listen, server_name и обработчики сайта остаются здесь.
}

Ниже показано размещение директив в существующей конфигурации. Не заменяйте рабочие http/server/location этой схемой и не создавайте дублирующий location /: перенесите директивы в нужные блоки и сохраните обработчик приложения. Порог и burst оставлены из исходного примера как иллюстрация; это не подтверждённые лимиты оператора бота. Подбирайте их по допустимой нагрузке своего сервера. Для запросов, отклонённых этим лимитом, явно задан HTTP 429 через limit_req_status.

# Вариант Б: ограничение частоты вместо полного запрета.
# map и limit_req_zone — внутри существующего http {}, вне server/location.
map $http_user_agent $tv_ng_6ac7f0f5ed1f_key {
    default "";
    "~*clickuplinkunfurler" $binary_remote_addr;
}
limit_req_zone $tv_ng_6ac7f0f5ed1f_key zone=tv_ng_6ac7f0f5ed1f:10m rate=10r/m;

# server/location ниже — схема размещения, не новый виртуальный хост.
server {
    # Используйте нужные существующие listen и server_name.
    location / {
        limit_req zone=tv_ng_6ac7f0f5ed1f burst=20 nodelay;
        limit_req_status 429;
        # Сохраните здесь существующий proxy_pass/fastcgi_pass/root и другие директивы.
    }
}

Проверка синтаксиса примера — 19.11.2026. По документации NGINX, map и limit_req_zone размещаются в http; limit_req допускается в http/server/location, но не внутри if. Запросы с пустым ключом default "" этим лимитом не учитываются. Значение $binary_remote_addr ограничивает совпавшие запросы по IP. За CDN или обратным прокси отдельно настройте восстановление исходного IP только от доверенных прокси; не используйте непроверенный X-Forwarded-For как ключ. Совпадение User-Agent не подтверждает оператора бота; строки и регулярные выражения исходного примера сохранены без такой проверки. Сначала выполните nginx -t и проверьте поведение на тестовой площадке. Проверка касается размещения этих директив, а не всех утверждений статьи.

Apache (.htaccess)

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} clickuplinkunfurler [NC]
RewriteRule ^ - [F,L]

TrafficVeil

  • Найдите clickuplinkunfurler в ботах домена или в /system/bots;
  • Для этой категории по умолчанию рекомендуется Allow — блокировка «на всякий случай» портит карточки в рабочих чатах без реальной экономии ресурсов;
  • Для нежелательного сценария — категорию «запретить»; для мягкого — rate-limit;
  • После изменения сверьте логи: хиты ClickUpLinkUnfurler должны уйти в блок или лимит, а нужные поисковики остаться.

7. Рекомендации: что делать с ClickUpLinkUnfurler

  • Ломаются карточки ссылок в задачах и Slack-каналах ClickUp — блокируйте только если превью принципиально не нужны;
  • Если сайт активно упоминается в рабочих процессах команд, использующих ClickUp — держите бота разрешённым по умолчанию;
  • Если нагрузка мешает — сначала rate-limit, затем полный запрет;
  • Не режьте слишком широко User-agent: *, чтобы случайно не закрыть Googlebot/YandexBot;
  • Что будет при блокировке: пользователи ClickUp увидят голую ссылку без картинки и описания в задачах и Slack-каналах.

8. С кем не путать ClickUpLinkUnfurler

Бот / сосед Кластер UA Комментарий
ArenaUnfurlBot Превью ссылок в соцсетях arenaunfurlbot легитимный, другой оператор
BufferLinkPreviewBot Превью ссылок в соцсетях bufferlinkpreviewbot легитимный, другой оператор (Buffer)
Facebook External Hit Превью ссылок в соцсетях facebookexternalhit легитимный
LMArenaUnfurlBot Превью ссылок в соцсетях lmarenaunfurlbot легитимный
LinkTiger Превью ссылок в соцсетях linktiger легитимный

9. Стратегия allow/deny для ClickUpLinkUnfurler

Ситуация Действие
Стандартная ситуация — превью нужны для рабочих чатов Allow по умолчанию
Превью в ClickUp/Slack принципиально не нужны Disallow + запрет в TrafficVeil
Подозрение на аномально высокую частоту не по одному URL Rate-limit, прежде чем блокировать полностью
Нежелательный по базе TrafficVeil Deny по умолчанию, исключения — точечно
Подозрение на spoofing UA Смотреть паттерн запроса — точечный к одному URL, не сканирование; не доверять только строке UA
Следующий шагПрименение и проверка настроек

Проверяйте User-Agent вместе с другими признаками. Перед блокировкой изучите логи и убедитесь, что полезные запросы проходят.

Частые вопросы

ClickUpLinkUnfurler сканирует сайт целиком?
Нет, это не фоновый краулер, а точечный fetcher — запрос происходит, когда конкретный пользователь ClickUp упоминает вашу ссылку в задаче или подключённом Slack-канале.
Есть ли у ClickUp официально задокументированная функция разворачивания ссылок?
Да, на официальной странице интеграций ClickUp прямо указано «unfurl links with rich details and actions» как часть интеграции со Slack.
Были ли реальные проблемы с этой функцией у ClickUp?
Да, в 2023 году был признанный компанией баг с неразворачиванием ссылок на задачи в Slack при определённых настройках — впоследствии исправлен, что подтверждает активную поддержку функции.
Что будет, если заблокировать этого бота?
Пользователи ClickUp увидят голую ссылку без картинки и описания в задачах и подключённых Slack-каналах при упоминании вашей страницы.
Нужно ли вообще думать о блокировке этого бота?
Как правило нет — серьёзной фоновой нагрузки он не создаёт, а блокировка скорее портит восприятие ссылки в рабочих чатах команд, чем экономит ресурсы.
Публикует ли ClickUp список IP-адресов бота?
Отдельного публичного списка не найдено, поэтому для верификации стоит ориентироваться на паттерн запроса — точечный к одному URL, а не на сканирование сайта.
#ClickUpLinkUnfurler#ClickUp#превью ссылок#Slack-интеграция#анализ логов#robots.txt#TrafficVeil
TV
TrafficVeil Team

Команда TrafficVeil разрабатывает инструменты защиты сайтов от ботов, DDoS и веб-атак. Разборы ботов пишем по логам подключённых доменов и открытым данным операторов. Дата обновления показывает редакционное изменение, а не полную повторную проверку всех источников. Как мы работаем с источниками и исправлениями.

Похожие статьи

Материалы по связанному оператору, задаче или технической теме.

Уникальная иллюстрация бота ArenaUnfurlBot: легитимный превью ссылок в соцсетях
Боты·6 мин

ArenaUnfurlBot в логах: превью для крупнейшей AI-арены

Разбираем ArenaUnfurlBot — link preview-бота платформы Arena (бывшая LMArena) с многомиллионной аудиторией. Показываем, почему при вирусном шеринге объём запросов может резко вырасти, как найти бота в access.log и почему rate-limit лучше полной блокировки.

Читать
Уникальная иллюстрация бота BufferLinkPreviewBot: легитимный превью ссылок в соцсетях
Боты·5 мин

BufferLinkPreviewBot в логах: превью для соцсетей, не угроза

Разбираем BufferLinkPreviewBot — фетчер платформы Buffer, который подтягивает превью вашей ссылки, когда кто-то делится ею через сервис. Показываем официальную документацию бота, как найти его в access.log и почему блокировка обычно вредит больше, чем помогает.

Читать
Уникальная иллюстрация бота EvernoteRichLinkBot: нежелательный превью ссылок в соцсетях
Боты·6 мин

EvernoteRichLinkBot в логах: превью для чужих заметок

Разбираем EvernoteRichLinkBot — бота компании Evernote, который подтягивает превью ссылки, когда пользователь сохраняет её в заметке. Показываем связь со старым токеном Evernote Clip Resolver, реальный репутационный спор вокруг таких ботов, и как настроить allow/deny.

Читать

Проверьте защиту своего сайта

Подключение занимает несколько минут. Начните с анализа трафика и включайте блокировки после проверки логов.

Фиксированная подписка по числу доменов и набору функций. Боты, атаки и заблокированные запросы не увеличивают счёт.

TrafficVeil