Scento Perfume API (MCP-сервер): API парфюмерии, API ароматов и MCP-сервер для парфюмерии

Scento Perfume API — бесплатный API для работы с парфюмерией и MCP-сервер для разработчиков, AI-агентов и приложений об ароматах. Через одну точку доступа можно получить проверенную базу парфюмерии Scento: более 1 500 ароматов от более чем 160 парфюмерных домов и сведения о более чем 400 сырьевых материалах. Для каждого аромата доступны полная пирамида нот (верхние, сердечные и базовые ноты), семейство, повод и ссылки на похожие ароматы. Источником каждой пирамиды служит информация от парфюмерного дома или авторизованного продавца: вы получаете ноты, указанные на флаконе, а не предположения, собранные веб-скрейпингом.

Подключите удалённый MCP-сервер по адресу https://www.scento.com/mcp — он работает с Claude, ChatGPT, Cursor, VS Code и любым MCP-клиентом. Также можно обращаться к REST API ароматов по адресу https://www.scento.com/api/perfume/v1, используя спецификацию OpenAPI: https://www.scento.com/api/perfume/v1/openapi.json. API бесплатный: ключ и регистрация не нужны, а тарифов с разными ограничениями запросов нет.

В распоряжении пользователей 12 инструментов для решения практических задач: perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon и journal-search. Можно искать аромат по названию или нотам, получать данные о нём через perfume notes API — с пирамидой и семейством, находить похожие ароматы, сравнивать два парфюма, узнавать о парфюмерном ингредиенте (сырьевом материале) и находить ароматы, в которых он используется, изучать семейства ароматов, подбирать парфюмы для конкретного повода или составлять парфюмерный гардероб, а также читать словарь парфюмерных терминов.

Чем этот сервис выгодно отличается от других API для парфюмерии: он бесплатный и не требует ключа; MCP, REST и OpenAPI объединены в одном сервисе; база нот и база парфюмерных ингредиентов находятся в одном месте; ответы доступны на 10 языках (английском, немецком, французском, испанском, итальянском, румынском, польском, чешском, венгерском и греческом); источники информации проверены. Сервис создан и поддерживается парфюмерным ателье Scento. Документация: https://www.scento.com/developers

Бесплатный API для работы с парфюмерией и ароматами, а также MCP-сервер для AI-ассистентов, созданный на основе проверенной базы парфюмерии Scento. Проект создан компанией Scento — парфюмерным домом, основанным в Париже в 2024 году и специализирующимся на отливантах.

Попросите Claude, ChatGPT, Cursor или любой MCP-клиент рассказать о нотах и семействе аромата, сравнить два парфюма, между которыми вы выбираете, найти похожие ароматы с аналогичной структурой или описать запах сырьевого материала, например амброксана. База охватывает более 1 500 дизайнерских и нишевых ароматов, более 400 сырьевых материалов, более 160 парфюмерных домов, а также собственную систему парфюмерных семейств Scento. Каждый ответ связан со страницей на scento.com. Ключ и учётная запись не нужны; доступ предоставляется только для чтения.

Удалённый сервер: https://www.scento.com/mcp (потоковый HTTP, без аутентификации)

Документация: https://www.scento.com/developers

Claude: доступен в каталоге коннекторов Claude.

Claude Code: /plugin marketplace add Scento-com/perfume-mcp-server, затем /plugin install scento-perfume-api@scento.

Gemini CLI: gemini extensions install https://github.com/Scento-com/perfume-mcp-server

Подключение MCP-сервера для парфюмерии

Клиент	Как подключить
Claude (веб-версия, компьютер, мобильное устройство)	Откройте Settings, затем Connectors и выберите Add custom connector. Вставьте `https://www.scento.com/mcp`.
ChatGPT	Откройте Settings, затем Connectors и создайте коннектор в режиме разработчика. URL сервера — `https://www.scento.com/mcp`, аутентификация не требуется.
Cursor	Добавьте в `~/.cursor/mcp.json`: `{"mcpServers":{"scento-perfume-api":{"url":"https://www.scento.com/mcp"}}}`
VS Code	Добавьте в `.vscode/mcp.json`: `{"servers":{"scento-perfume-api":{"type":"http","url":"https://www.scento.com/mcp"}}}`
Claude Code	`claude mcp add --transport http scento-perfume-api https://www.scento.com/mcp`

В клиентах, которые поддерживают только локальные серверы, можно использовать stdio-мост из этого репозитория:

npx -y scento-perfume-api     # Node 18+
uvx scento-perfume-api        # Python 3.9+

Обе команды принимают --endpoint (или SCENTO_PERFUME_API_ENDPOINT). Тот же мост также опубликован под названиями perfume-mcp-server и perfume-database в npm и PyPI.

Двенадцать инструментов для работы с парфюмерией и ароматами

Инструмент	Назначение
`perfume-search`	Поиск ароматов, парфюмерных домов и сырьевых материалов по названию, дому, ноте или описанию настроения.
`perfume-portrait`	Полное описание одного аромата: пирамида, семейство Scento, характер и подходящие для него случаи.
`scent-neighbours`	Ароматы, наиболее близкие по структуре к выбранному, с указанием общих материалов.
`perfume-contrast`	Сравнение двух-четырёх ароматов по семейству, пирамиде, характеру и сезону.
`note-portrait`	Описание ноты или сырьевого материала, его происхождения и того, как он раскрывается на коже.
`material-match`	Ароматы, содержащие все заданные материалы; при необходимости можно ограничить поиск одним уровнем пирамиды.
`house-portrait`	Информация о парфюмерном доме: происхождение, год основания, стиль и знаковые ароматы.
`family-map`	Собственная система парфюмерных семейств Scento или отдельное семейство с его подсемействами и примерами.
`occasion-edit`	Краткая подборка ароматов для конкретного повода, сезона или климата с описанием каждого.
`wardrobe-composer`	Подборка из трёх-пяти ароматов для разных ситуаций, составленная с учётом того, что уже нравится человеку.
`perfumery-lexicon`	Объяснение парфюмерных терминов простым языком: например, шлейф, шипр, фужер или различия между EDP и EDT.
`journal-search`	Поиск статей из журнала Scento об аромате, парфюмерном доме, материале или теме.

Передайте параметр lang (de, fr, es, it, ro, el, hu, cs, pl), чтобы получать ссылки на scento.com на соответствующем языке.

Fragrance API (REST)

Те же данные доступны через perfume API по обычному HTTP.

Базовый URL API: https://www.scento.com/api/perfume/v1
OpenAPI: https://www.scento.com/api/perfume/v1/openapi.json

Примеры

В каталоге examples/ приведены три примера вызовов JSON-RPC.

Структура репозитория

npm/: stdio-мост для Node, опубликованный в npm под названием scento-perfume-api
pypi/: stdio-мост для Python, опубликованный в PyPI под названием scento-perfume-api
server.json: метаданные для Official MCP Registry (com.scento/perfume-api)

Лицензия

Код моста в этом репозитории распространяется по лицензии MIT. Содержимое базы парфюмерии предоставляется с сайта scento.com в соответствии с условиями использования.

Scento