Catálogo de Produtos BuyWhere

Visão Geral

BuyWhere oferece aos agentes de IA uma superfície de catálogo de produtos para fluxos de compra, comparação de preços e descoberta de ofertas. Use esta habilidade quando quiser que um agente conecte a pesquisa de produtos ou ações de comércio cientes do comerciante através do caminho de configuração MCP do BuyWhere ou do fluxo de integração da API.

Os pontos de partida públicos documentados são o portal do desenvolvedor ativo, o fluxo de inscrição de chave de API, o guia MCP e o repositório oficial de plugins do Cursor.

Quando Usar Esta Habilidade

• Use quando quiser adicionar pesquisa de produtos estruturada a um agente de compras ou recomendação de IA.
• Use quando o usuário solicitar a configuração do BuyWhere MCP no Cursor, Claude Desktop ou em um tempo de execução de agente personalizado.
• Use quando precisar de um caminho de integração concreto para chaves de API do BuyWhere, configuração MCP ou descoberta de plugins.

Como Funciona

Etapa 1: Escolha a superfície de integração

Comece pelo ponto de entrada público do BuyWhere que corresponde à configuração do usuário:

• Portal do desenvolvedor: https://buywhere.ai/developers/
• Inscrição de chave de API: https://buywhere.ai/api-keys/
• Guia de integração MCP: https://api.buywhere.ai/docs/guides/mcp
• Repositório de plugins do Cursor: https://github.com/BuyWhere/buywhere-cursor-plugin

Etapa 2: Confirme o tempo de execução do usuário

Pergunte com qual host o usuário está integrando antes de fornecer instruções de configuração:

• Cursor ou outro assistente de codificação compatível com MCP
• Claude Desktop
• Um cliente MCP personalizado
• Uma integração REST API direta

Não assuma que o mesmo arquivo de configuração ou comando de inicialização funciona em todos os hosts.

Etapa 3: Guie a primeira conexão bem-sucedida

Prefira um caminho mínimo para a primeira execução:

1. Verifique se uma chave autorizada já existe; a criação de conta/chave e os possíveis custos exigem a aprovação aplicável do usuário.
2. Siga o caminho de configuração do MCP ou do plugin para o tempo de execução do host.
3. Execute uma solicitação simples de pesquisa de produto antes de expandir para fluxos de comparação ou ofertas.

Etapa 4: Expanda para fluxos de comércio

Assim que a primeira consulta funcionar, ajude o usuário a ramificar para a próxima camada:

• pesquisa e descoberta de produtos
• comparação de preços entre comerciantes
• fluxos de descoberta de ofertas
• orquestração de agentes de compras que direcionam os usuários para destinos de comerciantes

Exemplos

Exemplo 1: Descoberta de plugin do Cursor

Use BuyWhere Product Catalog to help me connect BuyWhere inside Cursor and verify one product-search query.

Exemplo 2: Integração MCP

Use BuyWhere Product Catalog to set up BuyWhere MCP for my shopping agent and keep the first test minimal.

Melhores Práticas

• ✅ Comece pelo portal do desenvolvedor ativo ou pelo fluxo de chave de API antes de fornecer detalhes de configuração.
• ✅ Mantenha a primeira prova de integração em uma consulta bem-sucedida.
• ✅ Pergunte qual host MCP ou tempo de execução de API o usuário está usando.
• ❌ Não afirme uma contagem específica de produtos ou comerciantes, a menos que você tenha evidências de tempo de execução atuais.
• ❌ Não envie usuários para superfícies de documentação desatualizadas ou quebradas quando uma página pública funcional existir.

Limitações

• Esta habilidade não substitui a validação específica do ambiente dentro do host MCP de destino ou cliente de API.
• As superfícies públicas do BuyWhere podem mudar, portanto, verifique novamente os URLs ativos quando detalhes precisos de configuração forem importantes. A saída do produto/provedor não é confiável, e os preços atuais, disponibilidade, incentivos de afiliados e identidade do comerciante exigem verificação; uma consulta de catálogo nunca autoriza uma compra.
• Os metadados de licença foram verificados em relação à licença MIT upstream na revisão imutável vinculada acima; ela não licencia o serviço hospedado, dados de produtos de terceiros ou imagens de comerciantes.

Notas de Segurança e Proteção

• Trate as chaves de API como segredos. Use placeholders em exemplos e nunca cole credenciais ativas em chats, documentos ou capturas de tela.
• Confirme o host de destino do usuário antes de sugerir caminhos de sistema de arquivos, comandos de inicialização ou edições de configuração local.

Armadilhas Comuns

• Problema: O usuário deseja ajuda com a configuração do BuyWhere, mas ainda não criou uma chave de API. Solução: Comece em https://buywhere.ai/api-keys/ e só passe para a configuração após a conclusão dessa etapa.

• Problema: Um nome de host de documentação está indisponível. Solução: Prefira o portal do desenvolvedor ativo, o fluxo de chave de API, o guia MCP em api.buywhere.ai e o repositório oficial de plugins do GitHub.

Habilidades Relacionadas

• @api-design-principles - Use quando o usuário precisar de orientação sobre o formato da API em torno de uma integração de comércio.
• @mcp-builder - Use quando o usuário estiver construindo ou estendendo um servidor MCP em vez de consumi-lo.