Обучайте кодирующих агентов, когда использовать Decodo с навыками агента.

Последнее тестирование и обновление: 25 августа 2026 года

MCP сервер предоставляет агенту вызываемые инструменты. Навык агента даёт ему повторно используемые инструкции для решения, когда и как использовать эти инструменты. Вы можете использовать любой из них по отдельности, но они решают разные задачи.

Слой	Что оно предоставляет	Где находится секрет
сервер Decodo MCP	Именованные инструменты скрапинга и поиска внутри клиента MCP	Окружение MCP или хранилище секретов клиента
CLI Decodo или прямой API	Команды или HTTP-запросы для кода и автоматизации	Переменная окружения или внешний менеджер секретов
Навык агента Decodo	Правила маршрутизации, руководство по настройке, проверки и процедура рабочего процесса	Ни в каком месте в Skill

Завершено урок подключения MCP сначала, если вы хотите, чтобы Skill маршрутизировался через MCP. Skill не может самостоятельно создать рабочую учетную запись или транспорт.

Шаг 1: выберите Skill, который соответствует задаче

В официальном репозитории Decodo в настоящее время содержатся два Skill:

decodo-web-scraping — основной слой маршрутизации для общих страниц, Google и Bing, целей электронной коммерции, Reddit, TikTok и YouTube. Он может маршрутизироваться между Decodo CLI, размещенным сервером MCP и обычным HTTP API в зависимости от среды агента.
decodo-price-monitoring — рабочий процесс ценообразования для текущих цен, сравнения продавцов и регулярных проверок цен. Он строится на decodo-web-scraping.

Сначала установите основное Skill. Добавляйте мониторинг цен только тогда, когда у вас есть определённое правило сопоставления продуктов, расписание, место хранения и порог оповещения.

Шаг 2А: установите плагин в Claude Code

Decodo рекомендует свой путь плагина для Claude Code. Выполните эти команды со слешем внутри Claude Code:

/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills

Первая команда добавляет репозиторий Decodo как маркетплейс плагинов. Вторая устанавливает decodo плагин из decodo-skills маркетплейса. Перезапустите или перезагрузите плагины, если Claude Code попросит.

Шаг 2B: установите вручную в другом поддерживаемом агенте

Decodo описывает навыки как совместимые с Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Claude Desktop и claude.ai. Поддержка не означает, что эти продукты используют одну папку или команду установки.

Используйте этот портативный процесс:

Откройте или клонируйте официальный Decodo/agent-skills репозиторий.
Просмотрите выбранный SKILL.md и его ссылки на файлы перед установкой. Навык — это исполняемое руководство для вашего агента, поэтому обращайтесь с ним как с кодом.
Скопируйте полный skills/decodo-web-scraping каталог в каталог пользовательских или проектных навыков, распознаваемый вашим клиентом.
Установить decodo-price-monitoring рядом с ним только если вам нужен этот рабочий процесс.
Перезапустите агента или перезагрузите навыки, затем попросите его перечислить или объяснить установленный навык Decodo.

Например, Codex использует $HOME/.agents/skills/ для пользовательских навыков и .agents/skills/ для репозитория навыков, в то время как Claude Code использует ~/.claude/skills/. Клиенты Cursor, Windsurf и другие могут менять свои места обнаружения и интерфейсы, поэтому проверяйте их текущую документацию по навыкам вместо того, чтобы угадывать путь.

Выбирайте область применения сознательно:

Уровень пользователя: доступно во всех ваших проектах; полезно на одном доверенном личном устройстве.
Уровень проекта: путешествует вместе с одним рабочим процессом и может быть просмотрен коллегами; никогда не включайте токен.

Шаг 3: храните учетные данные вне навыка

Установка навыка не аутентифицирует Decodo. Держите токен Web Scraping API Basic в окружении, в хранилище секретов клиента MCP или в специализированном менеджере секретов.

То же различие в аутентификации по-прежнему применяется:

Локальный MCP использует необработанный токен как SCRAPER_API_TOKEN.
Размещенный MCP отправляет Authorization: Basic <token>.
Сырые маршруты API и CLI следуют своему собственному документированному формату окружения или запроса.

Никогда не вставляйте настоящий токен в SKILL.md, файл с инструкциями проекта, чат-промпт, снимок экрана или команду, которая останется в истории оболочки. Поменяйте токен, если он был раскрыт.

Шаг 4: протестируйте решение маршрутизации

Начните с одной небольшой, публичной цели:

Используйте установленное умение Decodo для веб-скрейпинга, чтобы собрать первые пять видимых
заголовков историй и ссылок на них с https://news.ycombinator.com/.
Прежде чем что-либо вызывать, укажите, какую поверхность Decodo вы выбрали и почему.
Используйте не более одного запроса Decodo. Не используйте другое веб-средство.
Верните использованный инструмент или команду, исходный URL, зафиксированное время и пять результатов.

Принимайте тест только тогда, когда:

Агент идентифицирует доступный маршрут Decodo в своей текущей среде.
В журнале исполнения отображается ожидаемый инструмент Decodo, команда CLI или запрос API.
Он возвращает пять связанных результатов без тихого перехода к резервному варианту.
Количество запросов остаётся в пределах указанного бюджета.
В выводе или журналах не появляется ни одной учетной записи.

Инструкции «использовать Decodo» не являются доказательством того, что Decodo был запущен. Проверьте инструмент или запись команды.

Шаг 5: протестируйте специализированный рабочий процесс отдельно

Для decodo-price-monitoring, начните с одного наблюдения, а не с расписания:

Используйте навык Decodo для мониторинга цен, чтобы проверить продукт Amazon B09H74FXNW один раз.
Верните точную идентичность продукта, локальную цену и валюту, продавца, состояние запасов,
URL продукта, время наблюдения и выбранный маршрут Decodo. Используйте не более двух запросов Decodo.
Не создавайте расписание или уведомление пока.

Проверьте идентичность продукта и исходные данные перед добавлением повторяющегося выполнения. Планирование непроверенного совпадения только автоматически повторяет ошибку.

Шаг 6: обновите навыки, такие как код

Установленный навык является снимком. Когда Decodo изменяет исходный репозиторий:

Прочитайте релиз или различия коммита.
Проверьте, изменились ли маршрутизация, команды, имена учетных данных или поддерживаемые цели.
Обновите установленный каталог.
Повторите тест с одним запросом.

Не обновляйте инструкции сторонних разработчиков напрямую в рабочем процессе без проверки. Новое правило маршрутизации может изменить стоимость, обработку данных или внешний сервис, к которому обращается агент.

Когда не нужно добавлять Навык

Пропустите Навык Агента, если:

вам нужен только один явный вызов инструмента MCP;
ваше приложение уже реализует детерминированную маршрутизацию API;
клиент не может надежно обнаруживать Навыки;
вы не можете проверить, какой маршрут или запрос использовал агент.

В таких случаях точная подсказка или прямой вызов API проще для аудита. Добавляйте Навык, когда повторяемая логика маршрутизации — это то, что вы хотите, чтобы агент запоминал.