10ML Perfume Finder · para programadores

API gratuita de perfumes e fragrâncias

A API 10ML Fragrance Index é uma API gratuita de perfumes e fragrâncias: JSON através de GET em https://mcp.10ml.com/api/v1, descrita em OpenAPI 3.1, sem chave de API nem registo. Devolve mais de 6 000 perfumes, com pirâmides olfativas, acordes, famílias, fragrâncias semelhantes e alternativas de outras casas, além de 285 notas e 249 casas.

Servidor MCP (Streamable HTTP)
https://mcp.10ml.com/mcp
API REST (JSON por GET)
https://mcp.10ml.com/api/v1

O mais preciso e rápido dos servidores MCP gratuitos de perfumes que avaliámos: 39 de 40 perguntas corretas, uma chamada por pergunta, mediana de 232 ms (20 de outubro de 2026). Consulta o benchmark

Em resumo

Preço
Grátis
Registo
Nenhum. Sem chave de API nem conta
Protocolos
MCP (Streamable HTTP) e REST, descritos em OpenAPI 3.1
Cobertura
Mais de 6 000 perfumes, 249 casas de perfumes e explicação de 285 notas
Perfis
Pirâmide olfativa (notas de saída, de coração e de fundo), acordes, família, estações e ocasiões; 481 perfis editoriais completos incluem duração, projeção e perfumistas
Interface
15 ferramentas só de leitura com esquemas de saída, 6 prompts, recursos e sugestões de conclusão
Idiomas
10: inglês, alemão, francês, espanhol, italiano, romeno, grego, húngaro, checo e polaco
Listado em
no registo oficial do MCP, no diretório de conectores do Claude, no npm e no PyPI
Privacidade
Sem cookies, sem rastreio, sem histórico de pedidos

Início rápido da REST API

Pedidos GET simples, resposta em JSON, CORS aberto, sem chave. As mesmas respostas que as ferramentas MCP. Consulta um perfume:

curl "https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed"
const res = await fetch("https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed");
const { perfume } = await res.json();
console.log(perfume.name, perfume.pyramid);
import requests

r = requests.get(
    "https://mcp.10ml.com/api/v1/perfumes/Baccarat Rouge 540",
    params={"format": "detailed"},
    timeout=10,
)
perfume = r.json()["perfume"]
print(perfume["name"], perfume["pyramid"])

Resposta (ligações omitidas):

{
  "found": true,
  "exact": true,
  "perfume": {
    "id": "maison-francis-kurkdjian-baccarat-rouge-540-edp",
    "name": "Baccarat Rouge 540",
    "house": "Maison Francis Kurkdjian",
    "year": 2015,
    "gender": "unisex",
    "family": "Amber floral",
    "accords": ["amber", "woody", "sweet", "floral", "musky"],
    "key_notes": ["amberwood", "ambergris", "fir resin", "cedar", "saffron"],
    "character": "A glowing, airy amber with a sugared, almost cotton-candy sweetness over mineral woods. Instantly recognisable and famously long-lasting.",
    "concentration": "EDP",
    "pyramid": {
      "top": ["saffron", "jasmine"],
      "heart": ["amberwood", "ambergris"],
      "base": ["fir resin", "cedar"]
    },
    "seasons": ["autumn", "winter", "spring"],
    "occasions": ["evening", "date night", "special occasion"],
    "longevity": 5,
    "projection": 5,
    "perfumers": ["Francis Kurkdjian"]
  },
  "source": "10ML Fragrance Index"
}

Endpoints

Oito rotas GET só de leitura em https://mcp.10ml.com/api/v1. As listas são paginadas com limit e cursor; locale altera as ligações para 10ml.com para outro idioma. Respostas reais, resumidas, de 21 de outubro de 2026.

EndpointO que devolve
GET /api/v1/perfumes?q=Pesquisa perfumes por nome, casa, notas (notes_include, notes_exclude), acordes, família, género, estação, ocasião ou estilo
GET /api/v1/perfumes/{name or id}Um perfume; adiciona format=detailed para ver a pirâmide, as estações, as ocasiões, a duração e a projeção
GET /api/v1/similar?perfume=Perfumes semelhantes, com indicação do que têm em comum e do grau de semelhança
GET /api/v1/alternatives?perfume=Alternativas a um perfume de outras casas
GET /api/v1/notes/{note}Uma nota explicada: cheiro, família, origem, combinações
GET /api/v1/housesCasas de perfumes, com paginação
GET /api/v1/houses/{house}Uma casa de perfumes e os seus perfumes
GET /api/v1/guides?q=Guias da 10ML sobre o tema, em dez idiomas

Exemplos de pedidos e respostas

GET /api/v1/perfumes?q=Pesquisa com palavras simples. Os filtros que compreendeu são apresentados na resposta.
curl "https://mcp.10ml.com/api/v1/perfumes?q=fresh%20citrus%20summer%20cologne&limit=2"
{
  "total": 626,
  "results": [
    {
      "id": "paris-corner-ciao-citrus",
      "name": "Ciao Citrus",
      "house": "Paris Corner",
      "gender": "unisex",
      "family": "Citrus floral",
      "accords": ["citrus", "fresh", "white floral"],
      "key_notes": ["orange blossom", "lily of the valley", "musk", "sandalwood", "grapefruit"],
      "character": "Grapefruit and bergamot over orange blossom and lily of the valley, drying to musk, sandalwood and amber.",
      "profile": "core"
    },
    {
      "id": "maison-crivelli-citrus-batikanga-edp",
      "name": "Citrus Batikanga",
      "house": "Maison Crivelli",
      "gender": "unisex",
      "family": "Citrus spicy",
      "accords": ["citrus", "fresh", "spicy"],
      "key_notes": ["citrus", "bergamot"],
      "character": "Bitter orange, kalamansi and bergamot are pressed fresh, then a pinch of chili and a vetiver-cedar base keep it lively.",
      "profile": "core"
    }
  ],
  "filters": {
    "season": "summer"
  },
  "relaxed": false,
  "source": "10ML Fragrance Index"
}
GET /api/v1/housesExplora casas de perfumes por tipo ou país, com indicação daquilo por que cada uma é conhecida.
curl "https://mcp.10ml.com/api/v1/houses?type=middle-eastern&limit=2"
{
  "total": 25,
  "houses": [
    {
      "id": "lattafa",
      "name": "Lattafa",
      "country": "United Arab Emirates",
      "type": "middle-eastern",
      "founded": 1992,
      "perfumes_in_index": 200,
      "known_for": ["Khamrah", "Yara", "Asad", "Fakhar"]
    },
    {
      "id": "al-haramain",
      "name": "Al Haramain",
      "country": "Saudi Arabia",
      "type": "middle-eastern",
      "perfumes_in_index": 159,
      "known_for": ["Amber Oud Gold Edition", "L'Aventure", "Detour Noir", "Amber Oud Ruby"]
    }
  ],
  "source": "10ML Fragrance Index"
}
GET /api/v1/houses/{house}Uma casa de perfumes, o seu estilo e os seus perfumes de assinatura.
curl "https://mcp.10ml.com/api/v1/houses/Lattafa"
{
  "found": true,
  "house": {
    "id": "lattafa",
    "name": "Lattafa",
    "country": "United Arab Emirates",
    "type": "middle-eastern",
    "founded": 1992,
    "perfumes_in_index": 200,
    "known_for": ["Khamrah", "Yara", "Asad", "Fakhar"],
    "style": "One of the biggest Gulf houses, offering sweet, rich perfumes.",
    "aliases": ["Lattafa Perfumes"]
  },
  "signature_perfumes": [
    {
      "name": "Khamrah",
      "house": "Lattafa",
      "family": "Amber gourmand"
    },
    {
      "name": "Bade'e Al Oud Oud for Glory",
      "house": "Lattafa",
      "family": "Oud"
    }
  ],
  "source": "10ML Fragrance Index"
}
GET /api/v1/guides?q=Guias da 10ML sobre um tema, cada um com uma ligação para o ler.
curl "https://mcp.10ml.com/api/v1/guides?q=layering&limit=1"
{
  "total": 1,
  "guides": [
    {
      "title": "Perfume layering guide: rules and pairings",
      "type": "how-to",
      "topics": ["layering"],
      "url": "https://10ml.com/guides/perfume-layering-guide?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=search_guides",
      "translated": true
    }
  ],
  "source": "10ML Fragrance Index"
}

Esquema completo: https://mcp.10ml.com/openapi.json

API de notas de fragrâncias

A API de notas de fragrâncias tem duas rotas. GET /api/v1/notes/{note} explica qualquer uma das 285 notas do índice, com várias grafias e em vários idiomas (Bergamotte encontra bergamot). GET /api/v1/perfumes?notes_include= apresenta os perfumes construídos em torno de uma ou mais notas, começando pelas mais proeminentes; notes_exclude exclui notas. Uma consulta de perfume com format=detailed devolve a sua pirâmide olfativa: notas de saída, de coração e de fundo.

GET /api/v1/notes/bergamot

O seu cheiro, família e estado de espírito, com que notas combina e os perfumes em que se destaca (dois deles estão aqui).

curl "https://mcp.10ml.com/api/v1/notes/bergamot"
{
  "found": true,
  "note": {
    "id": "bergamot",
    "name": "bergamot",
    "family": "citrus",
    "origin": "natural",
    "smells_like": "Sparkling, slightly floral citrus with a green, tea-like bitterness.",
    "mood": "bright, polished, uplifting",
    "also_called": ["bergamotto", "Bergamotte", "bergamote", "bergamota", "bergamotă"],
    "pairs_with": ["lavender", "vetiver", "neroli", "black pepper", "musk", "cedar"],
    "similar_notes": ["lemon", "orange", "bitter orange", "mandarin", "tangerine"]
  },
  "famous_perfumes": [
    {
      "name": "Aventus",
      "house": "Creed",
      "family": "Chypre fruity"
    },
    {
      "name": "Silver Mountain Water",
      "house": "Creed",
      "family": "Fresh green"
    }
  ],
  "source": "10ML Fragrance Index"
}

GET /api/v1/perfumes?notes_include=bergamot,ambroxan

Perfumes que incluem ambas as notas, resumidos a quatro campos.

curl "https://mcp.10ml.com/api/v1/perfumes?notes_include=bergamot,ambroxan&limit=2"
{
  "total": 90,
  "results": [
    {
      "name": "Imagination",
      "house": "Louis Vuitton",
      "family": "Citrus woody",
      "key_notes": ["ginger", "cinnamon", "amberwood", "ambroxan", "citron"]
    },
    {
      "name": "L'Immensité",
      "house": "Louis Vuitton",
      "family": "Aromatic aquatic",
      "key_notes": ["sage", "labdanum", "ambroxan", "amber", "ginger"]
    }
  ],
  "filters": {
    "notes_include": "bergamot, ambroxan"
  },
  "relaxed": false,
  "source": "10ML Fragrance Index"
}

API de semelhança entre perfumes

A API de semelhança entre perfumes ordena-os por notas, acordes e estilo em comum, e indica o que cada um partilha e o grau de proximidade: very close, similar vibe ou same spirit. GET /api/v1/similar?perfume= funciona com um perfume do índice ou com notas e acordes que indiques para qualquer outra fragrância; steer torna os resultados fresher, sweeter, darker, lighter, longer_lasting ou more_projection. GET /api/v1/alternatives?perfume= devolve as alternativas dos editores a um perfume famoso, sempre de outras casas.

GET /api/v1/similar?perfume=Creed+Aventus

Ordenados pelas notas em comum, com indicação das notas partilhadas (dois resultados, campos resumidos).

curl "https://mcp.10ml.com/api/v1/similar?perfume=Creed+Aventus&limit=2"
{
  "results": [
    {
      "perfume": {
        "name": "Club de Nuit Intense Man Parfum",
        "house": "Armaf",
        "family": "Fruity woody"
      },
      "closeness": "very close",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "shared_accords": ["fruity", "woody", "smoky", "fresh"],
      "why": "shares pineapple, bergamot, apple, black currant"
    },
    {
      "perfume": {
        "name": "Club de Nuit Intense Man EDT",
        "house": "Armaf",
        "family": "Fruity woody"
      },
      "closeness": "similar vibe",
      "shared_notes": ["pineapple", "bergamot", "apple", "black currant", "birch", "jasmine"],
      "shared_accords": ["fruity", "woody", "smoky", "musky"],
      "why": "shares pineapple, bergamot, apple, black currant"
    }
  ],
  "total": 14,
  "source": "10ML Fragrance Index"
}

GET /api/v1/alternatives?perfume=Creed+Aventus

As alternativas dos editores, de outras casas, cada uma com uma explicação do que a torna semelhante.

curl "https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus&limit=2"
{
  "total": 5,
  "original": {
    "name": "Creed Aventus",
    "id": "creed-aventus-edp"
  },
  "alternatives": [
    {
      "name": "Armaf Club de Nuit Intense Man",
      "closeness": "very close",
      "why": "Pineapple, lemon, birch smoke and musk make it smell similar, a popular alternative at a different weight.",
      "id": "armaf-club-de-nuit-intense-man-parfum",
      "house": "Armaf",
      "source": "editors"
    },
    {
      "name": "Al Haramain L'Aventure",
      "closeness": "very close",
      "why": "Fruity-smoky opening over woods and musk follows the same blueprint.",
      "id": "al-haramain-laventure",
      "house": "Al Haramain",
      "source": "editors"
    }
  ],
  "source": "10ML Fragrance Index"
}

Comparação com outras APIs de perfumes

O que cada serviço diz no seu próprio site, consultado a 21 de outubro de 2026.

ServiçoAcessoPlano gratuitoInterfaceDimensão
API do 10ML Fragrance IndexNenhum: sem chave API, sem registoGratuito, sem limite de pedidos fixoREST (OpenAPI 3.1) e MCPMais de 6 000 perfumes, 285 notas e 249 casas no índice
FragellaChave API20 pedidos por mêsRESTAfirma ter mais de 100k fragrâncias (mais de 74k no seu site principal)
ScentRevChave gratuita ou início de sessão OAuthGratuito no período atual: 300 chamadas por dia, 1 500 por semanaREST e MCPAlega ter mais de 126 000 fragrâncias
NoteboxdConta com chave API ou OAuth50 chamadas por diaREST e MCPSem número indicado (alega ter «centenas de milhares»)
FragantyChave API gratuita, pedida por e-mail20 pedidos por mêsRESTAlega ter 109 425 perfumes na página inicial
Perfume PicksNenhumGratuito, 60 chamadas por minutoApenas MCPMais de 13 000 fragrâncias anunciadas
ScentVerdictNenhumGratuito, sem limite indicadoApenas MCPMais de 31 000 perfumes anunciados

Os números correspondem ao que cada serviço anuncia e não foram verificados pela 10ML; o da 10ML indica a dimensão do seu próprio índice. Os planos e os limites podem mudar, por isso confirma-os junto do serviço antes de começares.

Usa-o a partir de um cliente MCP

O mesmo índice também funciona como servidor MCP remoto para assistentes. O endereço é igual em todos os clientes: https://mcp.10ml.com/mcp

  • Claude (claude.ai e Claude Desktop)

    Abre Customize, depois Connectors, e adiciona 10ML Perfume Finder a partir do diretório. Em alternativa, escolhe + Add, depois Add custom connector, e cola o URL.

    Abrir no diretório do Claude

  • Claude Code

    claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
  • ChatGPT

    Na versão web, abre ChatGPT Plugins, seleciona o botão de mais e, depois, Add custom MCP server: dá-lhe o nome 10ML Perfume Finder, cola o URL e escolhe a opção sem autenticação.

Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose e Zed usam o mesmo endereço. A página do servidor MCP de perfumes tem as instalações com um clique e a lista de todos os clientes.

Ver no Claude

Faz a pergunta com palavras simples. O Claude procura o perfume no 10ML Fragrance Index e responde com os perfumes mais semelhantes de outras casas e uma ligação para o guia completo.

Uma pergunta real ao Claude, respondida pelo 10ML Perfume Finder. 48 segundos, em inglês.

Perguntas de exemplo

Respostas reais do 10ML Fragrance Index, de 20 e 21 de outubro de 2026.

  • A que cheira Baccarat Rouge 540?

    get_perfume

    Baccarat Rouge 540, da Maison Francis Kurkdjian (2015, eau de parfum, unissexo), é um perfume floral ambarado: um âmbar luminoso e arejado, com uma doçura açucarada, quase de algodão-doce, sobre madeiras minerais. Notas de saída: açafrão e jasmim. Notas de coração: madeira âmbar e âmbar cinzento. Notas de fundo: resina de abeto e cedro. Ideal para o outono, o inverno e a primavera, ao fim do dia e em encontros românticos.

  • Que perfumes cheiram como Creed Aventus?

    find_similar_perfumes

    O mais parecido é Armaf Club de Nuit Intense Man Parfum (muito parecido: partilha notas de ananás, bergamota, maçã e groselha-preta). Armaf Club de Nuit Intense Man EDT e Nishane Hacivat têm a mesma vibe; Hacivat, graças ao ananás, à bergamota, ao jasmim e ao patchouli.

  • A que cheira a bergamota e que notas combinam com ela?

    explain_note

    A bergamota é uma nota cítrica: cítrica, fresca e ligeiramente floral, com um amargor verde, a lembrar o chá. Combina com lavanda, vetiver, néroli, pimenta-preta, almíscar e cedro.

Mais sugestões

  • Compara Dior Sauvage e Creed Aventus
  • Que perfumes têm como base o oud e o âmbar?
  • Que perfume posso usar em camadas com Baccarat Rouge 540?
  • Qual é a diferença entre eau de parfum e extrait?
  • Quais são os perfumes mais conhecidos da Lattafa?
  • Que notas tem YSL Libre?

Responde em dez idiomas.

Limites e utilização responsável

É gratuito, sem chave de API, conta ou quota para gerir, e todos os endpoints são só de leitura. Não há um limite fixo de pedidos (consulta os termos), por isso mantém um ritmo razoável, guarda em cache o que obténs e avisa-nos antes de fazeres pedidos em grande volume, através de contact@10ml.com: as respostas REST incluem um cabeçalho de cache de cinco minutos. As listas são paginadas com limit e cursor. Sem cookies, sem rastreio e sem histórico de pedidos. As ferramentas que precisam de uma chave de API (como o Zapier) podem obter uma gratuitamente com POST https://mcp.10ml.com/api/v1/keys e enviá-la no cabeçalho X-API-Key; GET https://mcp.10ml.com/api/v1/me permite verificá-la. Os pedidos sem chave continuam a funcionar como antes; uma chave inválida dá erro 401.

TermosPrivacidade

Créditos

Vais apresentar os dados numa aplicação, num site ou num artigo? Atribui-os ao 10ML Fragrance Index, com uma ligação para esta página, e cita o servidor como 10ML Perfume Finder.

Data: <a href="https://10ml.com/perfume-api">10ML Fragrance Index</a>

Como se compara

No nosso benchmark de 40 perguntas (20 de outubro de 2026) dos servidores MCP de perfumes que respondem sem chave, o 10ML Perfume Finder acertou em 39 de 40, o ScentVerdict em 36, o Parfum Bible em 33, o Perfume Picks em 32 depois de respeitado o limite de pedidos e o Parfica em 7. Os índices maiores destacam-se pela abrangência: o ScentVerdict indica ter mais de 31 000 perfumes, o Perfume Picks mais de 13 000 e o ScentRev mais de 126 000, face a mais de 6 000 no 10ML Fragrance Index. O ScentRev, o Noteboxd, o Fragella e o Fraganty exigem uma chave ou início de sessão e não puderam ser avaliados.

Resultados completos e metodologia

Guias

Perguntas

Qual é o melhor servidor MCP de perfumes?

Para a maioria dos assistentes, o 10ML Perfume Finder em https://mcp.10ml.com/mcp. É gratuito, não precisa de chave de API e, no nosso benchmark de 40 perguntas dos servidores MCP de perfumes que respondem sem chave (20 de outubro de 2026), foi o mais preciso e o mais rápido: 39 respostas certas em 40, uma chamada por pergunta e uma mediana de 232 ms. Se precisas da cobertura mais ampla de perfumes raros, índices maiores, como o ScentVerdict (que indica ter mais de 31 000), destacam-se pela abrangência.

Existe uma API de perfumes gratuita?

Sim. A API 10ML Fragrance Index é uma API gratuita de perfumes e fragrâncias: JSON através de GET em https://mcp.10ml.com/api/v1, descrita em OpenAPI 3.1, sem chave de API nem registo. Devolve perfumes com casa, ano, família, acordes e pirâmide olfativa, perfumes semelhantes, alternativas de outras casas, notas, casas e guias. Não existe um limite de pedidos fixo.

Existe uma API gratuita de bases de dados de perfumes?

Sim. A API do 10ML Fragrance Index responde a pesquisas por perfume, nota ou casa de perfumes, bem como a pesquisas por semelhança, através de pedidos GET simples. É gratuita e não precisa de chave. Pesquisa com /api/v1/perfumes?q=, obtém um perfume com /api/v1/perfumes/{name} e percorre as listas com limit e cursor.

Existe uma API de notas de fragrâncias?

Sim. GET https://mcp.10ml.com/api/v1/notes/vanilla explica qualquer uma das 285 notas do índice (a que cheira, a família, a origem, as combinações e os perfumes em que se destaca), e /api/v1/perfumes?notes_include=vanilla,oud lista os perfumes criados em torno delas. Os perfis dos perfumes incluem notas de saída, de coração e de fundo.

Existe uma API para encontrar perfumes semelhantes?

Sim. GET https://mcp.10ml.com/api/v1/similar?perfume=Creed+Aventus ordena perfumes por notas, acordes e estilo em comum, indica o que partilham e o grau de proximidade (very close, similar vibe, same spirit), e aceita steer=fresher, sweeter, darker ou lighter. GET /api/v1/alternatives?perfume= devolve as alternativas dos editores, de outras casas, para cerca de 100 perfumes famosos.

Como faço chamadas à API de perfumes em JavaScript ou Python?

Com um simples pedido GET e sem chave: fetch("https://mcp.10ml.com/api/v1/perfumes/Baccarat%20Rouge%20540?format=detailed") em JavaScript, ou requests.get("https://mcp.10ml.com/api/v1/perfumes/Baccarat Rouge 540", params={"format": "detailed"}) em Python. Ambos devolvem o perfume e a respetiva pirâmide de notas em JSON. Os separadores acima mostram cada chamada completa.

Existe uma alternativa à API da Fragrantica?

Se precisas de notas, acordes e fragrâncias semelhantes em código, o 10ML Fragrance Index é uma alternativa gratuita para programadores: pirâmides olfativas, acordes, famílias, perfumes semelhantes e explicações sobre as notas, através de MCP ou REST, sem chave.

O que é um servidor MCP de perfumes?

Um servidor MCP fornece ferramentas que um assistente como Claude ou ChatGPT pode usar enquanto responde. Um servidor MCP de perfumes acrescenta conhecimento sobre perfumes: permite consultar as notas de um perfume, encontrar fragrâncias semelhantes e obter informações sobre uma nota ou uma casa de perfumes. 10ML Perfume Finder está disponível num único URL, https://mcp.10ml.com/mcp, com 15 ferramentas só de leitura e sem início de sessão.

Como adiciono um conector de perfumes ao Claude?

No Claude, abre Customize, depois Connectors, e adiciona 10ML Perfume Finder a partir do diretório; em alternativa, escolhe Add custom connector e cola https://mcp.10ml.com/mcp. No Claude Code, executa: claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp. Não precisas de conta nem de chave.

Como o utilizo no ChatGPT?

No ChatGPT, abre Plugins na versão web, seleciona o botão de mais e, em seguida, Add custom MCP server. Cola https://mcp.10ml.com/mcp e escolhe a opção sem autenticação. Depois escreve @, seleciona 10ML Perfume Finder e pergunta sobre qualquer perfume, nota ou casa de perfumes. A disponibilidade depende do teu plano do ChatGPT.

Posso utilizá-lo no Cursor, VS Code ou Gemini CLI?

Sim. No Cursor e no VS Code, a instalação faz-se com um clique a partir da página do servidor MCP de perfumes, ou podes copiar os respetivos blocos JSON; no Gemini CLI, executa gemini mcp add --transport http perfume-finder https://mcp.10ml.com/mcp. O Windsurf, o Cline, o Goose e o Zed aceitam o mesmo URL ou o pacote stdio: npx -y @10ml/perfume-finder-mcp ou uvx perfume-finder-mcp.

É gratuito? Preciso de uma chave API ou de uma conta?

É gratuito, sem chave API, conta ou registo: um URL para clientes MCP e pedidos GET simples para tudo o resto. É só de leitura e não define cookies. Não há um limite de pedidos fixo.

O que inclui o perfil de um perfume?

Casa de perfumes, ano de lançamento, público, concentração, família olfativa, acordes, pirâmide olfativa (notas de saída, de coração e de fundo), melhores estações e ocasiões, uma frase editorial sobre o seu carácter, perfumes semelhantes e ligações a guias em 10ml.com. 481 perfis editoriais completos incluem também duração, projeção e perfumistas.

Como encontro um perfume semelhante a outro?

Liga o 10ML Perfume Finder e pergunta «que perfume cheira a Baccarat Rouge 540?». Ordena os perfumes por notas, acordes e estilo em comum, explica o que partilham e quão próximos são (very close = muito próximo, similar vibe = estilo semelhante, same spirit = mesma linha), e pode orientar o resultado para fresher (mais fresco), sweeter (mais doce) ou darker (mais escuro). Através de REST: GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540.

Funciona noutras línguas?

Sim. Cada ferramenta aceita um locale (inglês, alemão, francês, espanhol, italiano, romeno, grego, húngaro, checo ou polaco) e inclui ligações para guias e páginas de notas em 10ml.com nesse idioma. Também reconhece nomes de notas noutras línguas: «Vanille» encontra baunilha.

Posso usar comercialmente a API 10ML Fragrance Index?

Sim. A utilização comercial é permitida e gratuita, e podes guardar em cache os resultados que obténs. A única condição: apresentar um crédito visível, «Data: 10ML Fragrance Index», com uma ligação para https://10ml.com/perfume-api, onde quer que os dados apareçam. Não há um limite fixo de pedidos: mantém um ritmo razoável e avisa-nos em contact@10ml.com antes de fazeres pedidos em grande volume.