123Ergo/unphurl-mcp

Добавляет один или несколько доменов в доверенный список этого аккаунта. Домены из доверенного списка подавляют составной сигнал и порог имитации бренда при оценке. Полный конвейер всё ещё выполняется — все сигналы остаются видимыми, чтобы вы могли отслеживать доверенные домены на предмет истечения SSL, парковки или других изменений. Указывайте только регистрируемый домен (например, partnerco.com). Поддомены и полные URL отклоняются. Добавление partnerco.com автоматически покрывает sub.partnerco.com и все остальные поддомены. Максимум 1 000 доменов на аккаунт. Максимум 100 доменов на запрос. Дубликаты молча пропускаются.

Просматривает историю недавних проверок URL. Показывает, какие URL проверялись, их оценки, статус фишинга, а также была ли каждая проверка бесплатной или использовала кредит пайплайна. Результаты разбиты на страницы. Используйте параметры page и limit для навигации. По умолчанию 20 результатов на страницу, максимум 100. История хранится 90 дней. Статистика на уровне аккаунта (общее количество кредитов, баланс) никогда не истекает.

Проверяет один URL на наличие сигналов безопасности и качества данных. Возвращает оценку риска (0-100), детальную разбивку сигналов и метаданные. Unphurl анализирует URL по семи измерениям: поведение редиректов, подмена бренда, информация о домене (возраст, регистратор, срок действия, коды статуса, NS-серверы через RDAP), валидность SSL/TLS, обнаружение припаркованных доменов, структурный анализ URL (длина, глубина пути, количество поддоменов, энтропия) и обогащение DNS (MX-записи). Оценка вычисляется на основе этих сигналов — либо с весами по умолчанию, либо с пользовательским профилем оценки. Чем выше балл, тем подозрительнее URL. Оценка — это сигнал, а не вердикт. Пороговое значение выбираете вы, исходя из сценария использования. Оплата: большинство проверок бесплатны. Известные домены (Tranco Top 100K, такие как google.com, github.com) возвращают результат мгновенно с оценкой 0 без затрат. Ранее проанализированные домены возвращают кэшированные сигналы без затрат. Только неизвестные домены, проходящие полный конвейер анализа, расходуют 1 кредит конвейерной проверки. Поле meta.pipeline_check_charged в ответе показывает, был ли израсходован кредит при этой проверке. Используйте параметр "profile", чтобы оценивать результаты с пользовательскими весами. Например, профиль "cold-email" может давать высокий вес припаркованным доменам, игнорируя подмену бренда. Вызовите list_profiles, чтобы увидеть доступные профили, или show_defaults, чтобы посмотреть все веса сигналов. Если на счету ноль кредитов и URL требует полной конвейерной проверки, возвращается ошибка 402 со ссылкой на покупку дополнительных кредитов.

Проверяет несколько URL в одном пакетном запросе. Возвращает результаты для всех URL, автоматически обрабатывая асинхронную обработку. Каждый URL анализируется по семи измерениям: поведение редиректов, подмена бренда, сведения о домене (возраст, регистратор, срок действия, коды состояния, серверы имён через RDAP), валидность SSL/TLS, определение запаркованного домена, структурный анализ URL и обогащение DNS. Известные и кэшированные URL возвращают результаты сразу. Неизвестные URL ставятся в очередь на обработку в конвейере. Этот инструмент автоматически опрашивает статус, пока не будут готовы все URL или не истечёт 5-минутный таймаут. Вам не нужно управлять опросом или отслеживать задания. Если таймаут истекает до завершения всех результатов, возвращается то, что уже доступно, с чётким сообщением о том, какие URL ещё обрабатываются. Пользователь может позже проверить результаты через check_history. Максимум 500 URL за один вызов. Для более крупных наборов данных вызывайте этот инструмент несколько раз частями до 500 URL. Тарификация: как у check_url. Известные и кэшированные домены бесплатны. Только неизвестные домены, проходящие полный конвейер, стоят 1 кредит каждый. В сводке отображается pipeline_checks_charged (фактическое количество израсходованных кредитов). Если на неизвестные домены в пакете не хватает кредитов, весь пакет отклоняется с ошибкой 402, в которой указано, сколько кредитов требуется. Дублирующиеся URL в списке автоматически дедуплицируются (обрабатываются один раз, тарифицируются один раз). Некорректные URL получают индивидуальный статус ошибки без отклонения всего пакета. Используйте параметр "profile", чтобы оценить все результаты с собственными весами.

Создаёт или обновляет пользовательский профиль скоринга. Профили — это разрежённые переопределения: указывайте только те веса, которые хотите изменить. Всё остальное сохраняет значение по умолчанию. Если профиль с таким именем уже существует, он обновляется с новыми весами (полная замена, а не слияние). Веса — это баллы, а не проценты. Каждый вес — это количество баллов, которое сигнал добавляет к оценке при срабатывании. Они не обязаны в сумме давать 100. Профиль с суммой весов 90 — консервативный (максимально возможная оценка — 90). Профиль с суммой весов 130 — агрессивный (несколько сигналов быстро доводят до предела в 100). Порог, который агент устанавливает для действия, важнее, чем суммы весов. Используйте show_defaults, чтобы увидеть все 25 сигналов с их весами по умолчанию и описаниями перед созданием профиля. Используйте check_url или check_urls с параметром "profile", чтобы оценить результаты с этим профилем. Максимум 20 профилей на аккаунт. Имя профиля "default" зарезервировано. Типовые профили: - Cold email: повысьте вес parked (30), chain_incomplete (25), ssl_invalid (15). Понизьте вес brand_impersonation (10). - Security bot: оставьте brand_impersonation высоким (40), увеличьте domain_age_7 (30), redirects_5 (25). - Lead gen: установите вес parked (35), http_only (20), chain_incomplete (20) для обнаружения неактивных бизнесов. - SEO audit: установите вес redirects_5 (30), chain_incomplete (30), parked (25) для оценки качества ссылок. Смотрите документацию Unphurl API для всех 19 примеров весов по сценариям использования.

Удаляет пользовательский профиль оценки. Это действие необратимо. Любые будущие запросы проверки, использующие это имя профиля, будут возвращаться к весам по умолчанию. Используйте list_profiles для просмотра текущих профилей перед удалением.

Проверяет баланс кредитов вашего пайплайна. Показывает оставшиеся кредиты, всего куплено, всего использовано и количество бесплатных проверок за всё время. Кредиты расходуются только тогда, когда неизвестные домены проходят полный конвейер анализа. Известные домены (Tranco Top 100K) и кешированные домены (ранее проанализированные любым клиентом Unphurl) всегда бесплатны. Если credits_remaining равен 0, вы всё ещё можете бесплатно проверять известные и кешированные домены. Чтобы проверить неизвестные домены, купите больше кредитов с помощью инструмента «purchase».

Показывает доступные пакеты кредитов для проверки pipeline и цены. Возвращает все пакеты с количеством кредитов и ценами. Пакеты (одноразовая покупка, без подписки): - Starter: 100 кредитов за $9 (по $0.09 каждый) - Standard: 500 кредитов за $39 (по $0.078 каждый) - Pro: 2 000 кредитов за $99 (по $0.0495 каждый) - Scale: 10 000 кредитов за $399 (по $0.0399 каждый) Большинство URL-запросов бесплатны (известные и кешированные домены). Кредиты расходуются только когда неизвестный домен проходит полный конвейер анализа. При типичном использовании 95–99% URL-адресов разрешаются бесплатно. Этот инструмент не требует API-ключа.

Показывает статистику использования вашей учётной записи. Отображает общее количество отправленных URL, разбивку по шлюзам (Tranco lookups, cache lookups, pipeline checks), процент бесплатных запросов, количество пороговых значений оценки и баланс кредитов. Используйте это, чтобы понять свои шаблоны использования: сколько проверок разрешилось бесплатно (известные или кэшированные домены) по сравнению с платными pipeline checks, и сколько URL-адресов набрали выше ключевых порогов. Это полезно для: - Проверки того, правильно ли ваш профиль оценки отмечает нужную долю URL - Понимания эффективности затрат (более высокий процент бесплатных запросов = большая ценность за кредит) - Отчёта о метриках использования

Перечисляет все домены из доверенного списка разрешённых для этой учётной записи. Разрешённые домены подавляют составной сигнал и нижний порог имитации бренда при скоринге. Весь конвейер по-прежнему работает - все сигналы остаются видимыми для мониторинга. Используйте это, чтобы увидеть, какие домены сейчас считаются доверенными. Возвращает список доменов, текущее количество и лимит в 1 000 доменов.

Перечисляет все пользовательские профили оценки на этом аккаунте. Возвращает имена профилей и их переопределения пользовательских весов. Профили - это именованные наборы весов, которые изменяют то, как Unphurl оценивает URL-адреса. Разные сценарии использования требуют разной оценки. Агент холодных писем учитывает мёртвые домены. Бот безопасности учитывает фишинг. Профили позволяют одному аккаунту обслуживать несколько сценариев использования. Профили переопределяют только определённые веса. Любой сигнал, не указанный в профиле, использует вес по умолчанию. Используйте show_defaults, чтобы увидеть все 25 сигналов и их веса по умолчанию.

Покупает кредиты для конвейера проверок. Возвращает URL Stripe Checkout, который пользователь должен открыть в браузере для завершения оплаты. ИИ не может завершить оплату. Сообщите пользователю, что он должен открыть URL в своём браузере, завершить оформление заказа в Stripe и затем подтвердить, что оплатил. Кредиты добавляются на счёт автоматически после подтверждения оплаты Stripe. После покупки используйте get_balance, чтобы убедиться, что кредиты добавлены.

Удаляет один или несколько доменов из доверенного списка разрешений этой учётной записи. После удаления эти домены возвращаются к обычной оценке при следующей проверке. Используйте list_allowlist, чтобы просмотреть, что сейчас находится в списке, перед удалением.

Повторно отправляет ссылку для подтверждения email для существующего аккаунта Unphurl. Используется, когда пользователь зарегистрировался, но срок действия его ссылки для подтверждения истек (ссылки действительны в течение 24 часов), и ему нужна новая. Ключ API пользователя не будет работать, пока его email не подтверждён. В целях безопасности ответ всегда одинаковый независимо от того, существует ли email, уже подтверждён ли он, или был превышен лимит запросов. Это предотвращает перебор учётных записей. Лимит: 3 запроса на один email в час. Этот инструмент не требует ключа API.

Показывает все 25 сигналов оценки с их весами по умолчанию и описаниями. Это базовая оценка, которая применяется, когда не указан пользовательский профиль. Используйте это, чтобы понять, что означает каждый сигнал и какой вклад он вносит в оценку, перед созданием пользовательских профилей. Профили — это точечные переопределения поверх этих значений по умолчанию. Этот инструмент не требует API-ключа. Значения по умолчанию жёстко заданы и всегда доступны.

Создаёт новый аккаунт Unphurl. Возвращает API-ключ (показывается один раз, сохраните его надёжно). После регистрации пользователь должен проверить свою электронную почту и перейти по ссылке для подтверждения. API-ключ не будет работать для проверки URL, пока email не подтверждён. Ссылка для подтверждения истекает через 24 часа. Если срок действия ссылки истёк, используйте инструмент "resend_verification", чтобы запросить новую. Аккаунт начинает с 20 бесплатными кредитами на проверку в пайплайне, чтобы пользователь мог протестировать с реальными URL. Поиск по известным доменам (google.com, github.com и т.д.) и кэшированным доменам всегда бесплатный. Чтобы проверить больше неизвестных доменов через полный аналитический пайплайн, пользователь может приобрести кредиты через инструмент "purchase". Когда у пользователя есть API-ключ, ему нужно добавить его в конфигурацию MCP-сервера как UNPHURL_API_KEY. Этот инструмент не требует API-ключа.