BuyWhere

Pesquisa de produtos em tempo real e comparação de preços em mais de 15 lojas de Singapura, Sudeste Asiático e EUA (mais de 161 milhões de produtos) via servidor MCP e API REST

GitHub
10
Experimente este MCPPatrocinado

Documentação

Servidor MCP BuyWhere — Busca de Produtos e Comparação de Preços para Agentes de IA

Agentes de IA usam o BuyWhere para buscar produtos, comparar preços e descobrir ofertas em lojas de Singapura e dos EUA em tempo real.

Instale em 30 Segundos

export BUYWHERE_API_KEY=bw_live_xxxx
npx -y @buywhere/mcp-server

Use com Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev e qualquer cliente compatível com MCP.

Get your free API key

Ou obtenha uma em 3 segundos, sem cadastro, sem e-mail: POST /v1/auth/register · Formulário legado: buywhere.ai/api-keys

npm version npm downloads npm weekly downloads License: MIT Node version TypeScript GitHub stars Smithery MCP Registry Hashnode Blog

Agentes de IA: Use Este Pacote Para

  • Buscar produtos nos mercados de Singapura, EUA, Malásia, Tailândia e Vietnã por palavra-chave, categoria ou faixa de preço
  • Comparar produtos entre Lazada, Shopee, Amazon e varejistas locais em uma única consulta
  • Encontrar ofertas e acompanhar preços em tempo real com suporte a múltiplas moedas
  • Criar agentes de compras que recomendam, comparam e linkam produtos programaticamente
  • Descobrir catálogos de produtos com taxonomia estruturada para os mercados suportados

API de busca de produtos para agentes de IA via Model Context Protocol. Feito para comércio com agentes de IA, não para gerenciamento de lojas.

Listagem oficial no MCP Registry: io.github.BuyWhere/buywhere-mcp

Funciona com Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev e qualquer cliente compatível com MCP. Também suporta o protocolo Agent-to-Agent (A2A).

Demonstração

BuyWhere MCP in Claude Desktop

Demonstração de 44 segundos: busca de produtos, descoberta de ofertas, comparação de preços e suporte a múltiplas regiões.

User:   "Find me wireless earbuds under $50 available in Singapore"
Agent:  [calls search_products → returns 5 matching products]

User:   "Compare the top 3"
Agent:  [calls compare_products → side-by-side with best-value pick]

Início Rápido

Obtenha uma chave em 3 segundos — sem cadastro, sem e-mail:

# 1. Register (one call, returns api_key instantly)
curl -X POST https://api.buywhere.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"your-agent"}'
# → {"api_key":"bw_...","tier":"unverified","rate_limit":{"rpm":20,"daily":1000}}

# 2. Use the key
export BUYWHERE_API_KEY=bw_...
npx -y @buywhere/mcp-server

Cadastro legado por e-mail (60s, aprovação manual) → buywhere.ai/api-keys

Tutoriais

Do Blog

Leia o Blog de Engenharia do BuyWhere para artigos aprofundados sobre arquitetura MCP, comércio com agentes e o ecossistema.

Acompanhe também o espelho do blog BuyWhere no Hashnode para o mesmo conteúdo de engenharia no Hashnode.

Ferramentas

FerramentaDescrição
search_productsBusca no catálogo por palavra-chave, categoria, preço, país
get_productDetalhes completos do produto por ID (preços, especificações, imagens)
compare_productsComparação lado a lado de 2–10 produtos
find_best_priceListagem do item mais barato disponível para um produto entre lojas
get_dealsProdutos com quedas significativas de preço
list_categoriesTaxonomia de categorias de produtos disponíveis
find_similarProdutos semelhantes por similaridade vetorial
ingest_productsEnvio de URLs de produtos para ingestão no catálogo (agentes/lojistas)
search_products_v2Busca v2; requer deliver_to (país ISO)
get_product_v2Detalhes de produto v2 por ID
compare_products_v2Comparação v2; deliver_to opcional
get_deals_v2Ofertas v2; requer deliver_to
find_best_price_v2Melhor preço v2; requer deliver_to

MCP remoto: POST https://api.buywhere.ai/mcp (JSON-RPC 2.0, protocolVersion 2024-11-05, 13 ferramentas). Listagem no Glama: https://glama.ai/mcp/servers/BuyWhere/buywhere-mcp

Configuração do Cliente MCP

Guias rápidos de frameworks:

Claude Desktop

Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Cursor / VS Code / Cline

Adicione ao seu arquivo de configurações MCP:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Windsurf

Adicione em ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

OpenCode / Codex

Adicione em opencode.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
    }
  }
}

Continue.dev (VS Code / JetBrains)

Adicione em ~/.continue/config.json:

{
  "experimental": {
    "mcpServers": {
      "buywhere": {
        "command": "npx",
        "args": ["-y", "@buywhere/mcp-server"],
        "env": { "BUYWHERE_API_KEY": "bw_live_xxxx" }
      }
    }
  }
}

Mastra

Mastra é um framework de agentes de IA focado em TypeScript com suporte nativo a MCP.

npm install @mastra/core @mastra/mcp

import { Mastra } from '@mastra/core';
import { MastraMCPClient } from '@mastra/mcp';

const buywhere = new MastraMCPClient({
  name: 'buywhere',
  server: {
    url: new URL('https://api.buywhere.ai/mcp'),
    requestInit: {
      headers: { 'Authorization': `Bearer ${process.env.BUYWHERE_API_KEY}` },
    },
  },
});

const agent = new Mastra({
  agents: {
    shoppingAgent: {
      instructions: 'You are a shopping assistant. Use BuyWhere to find and compare products.',
      tools: await buywhere.tools(),
    },
  },
});

const result = await agent.agents.shoppingAgent.generate(
  'Find me the best deal on a Sony WH-1000XM5 in Singapore'
);

Guia completo: Integração BuyWhere + Mastra

LangChain

Use as ferramentas do BuyWhere em agentes LangChain via o adaptador MCP:

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_anthropic import ChatAnthropic

async def main():
    async with MultiServerMCPClient({
        "buywhere": {
            "url": "https://api.buywhere.ai/mcp",
            "transport": "streamable_http",
            "headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
        }
    }) as client:
        tools = await client.get_tools()
        agent = create_react_agent(ChatAnthropic(model="claude-sonnet-4-5"), tools)
        result = await agent.ainvoke({"messages": [("user", "Find the cheapest Sony headphones in Singapore")]})

LlamaIndex

Conecte o BuyWhere via cliente MCP do LlamaIndex:

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.agent.openai import OpenAIAgent

async def main():
    mcp_client = BasicMCPClient(
        command_or_url="https://api.buywhere.ai/mcp",
        headers={"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
    )
    mcp_tool_spec = McpToolSpec(client=mcp_client)
    tools = mcp_tool_spec.to_tool_list()
    agent = OpenAIAgent.from_tools(tools)
    response = await agent.achat("Compare prices for iPhone 16 Pro across Singapore and US")

CrewAI

Use o BuyWhere em um agente CrewAI com integração de ferramentas MCP:

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter

buywhere_server = MCPServerAdapter(
    server_params={
        "url": "https://api.buywhere.ai/mcp",
        "headers": {"Authorization": f"Bearer {BUYWHERE_API_KEY}"},
        "transport": "streamable-http",
    }
)

shopping_agent = Agent(
    role="Shopping Research Analyst",
    goal="Find the best deals across Singapore and US markets",
    tools=[buywhere_server],
)

task = Task(
    description="Find the best price for Sony WH-1000XM5 headphones across all available markets",
    agent=shopping_agent,
    expected_output="Product comparison with prices and merchant links",
)

crew = Crew(agents=[shopping_agent], tasks=[task])
result = crew.kickoff()

Configuração

VariávelPadrãoDescrição
BUYWHERE_API_KEY(obrigatório)Chave de API (sem cadastro: POST /v1/auth/register {"agent_name":"<name>"}) — retorna instantaneamente, sem verificação de e-mail
BUYWHERE_API_URLhttps://api.buywhere.ai/mcpURL base personalizada da API

Instalação

# Run directly (no install)
npx -y @buywhere/mcp-server

# Install globally
npm install -g @buywhere/mcp-server
buywhere-mcp

Casos de Uso

  • Agentes de compras — crie agentes de IA que buscam, comparam e recomendam produtos entre mercados
  • Comparação de preços — preços de múltiplos mercados em uma única consulta entre Lazada, Shopee, Amazon e varejistas locais
  • Descoberta de ofertas — encontre produtos com melhor custo-benefício com preços e estoque em tempo real
  • Automação de e-commerce — integre busca de produtos em qualquer aplicativo compatível com MCP
  • Comércio transfronteiriço — compare preços entre os mercados de Singapura, EUA, Malásia, Tailândia e Vietnã
  • Comércio Agente-a-Agente — delegue tarefas de compras entre agentes via protocolo A2A

Arquitetura

Developer's AI Agent (Claude, Cursor, etc.)
  │
  ├── MCP Protocol (stdio)
  │
  ├── @buywhere/mcp-server
  │     ├── search_products(q, category, min_price, max_price, country_code, deliver_to)
  │     ├── get_product(product_id)
  │     ├── compare_products(product_ids[])
  │     ├── find_best_price(product_name, country_code, deliver_to)
  │     ├── get_deals(country_code, deliver_to, category)
  │     ├── list_categories()
  │     ├── find_similar(product_id)
  │     └── ingest_products(urls[])
  │
  └── BuyWhere API (api.buywhere.ai)
        └── Product catalog across SG, US, MY, TH, and VN merchants

Desenvolvimento

git clone https://github.com/BuyWhere/buywhere-mcp.git
cd buywhere-mcp
npm install
npm run build
npm start

Por que o BuyWhere?

O BuyWhere é uma API de busca de produtos para agentes de IA. Agregamos dados de produtos de lojas de Singapura, EUA, Malásia, Tailândia e Vietnã em uma única interface amigável para agentes — sem gerenciamento de lojas, sem integração com Shopify. Apenas busque e compare produtos em tempo real.

  • Uma API — todos os mercados, todos os varejistas
  • Nativo para agentes — construído para MCP desde o primeiro dia
  • Tempo real — preços e disponibilidade ao vivo
  • Foco no desenvolvedor — sem necessidade de SDK, basta adicionar o servidor

Funciona Bem Com

Estes pacotes MCP complementares estendem o BuyWhere em fluxos de trabalho poderosos com múltiplas ferramentas:

  • @modelcontextprotocol/server-filesystem — Salve resultados de compras e pesquisas de produtos no seu sistema de arquivos local. Combine com o BuyWhere para exportar listas de ofertas, comparações de preços e especificações de produtos como arquivos estruturados.
  • @supabase/mcp-server-supabase — Armazene produtos favoritos, preferências de usuário e alertas de preço no Supabase. Persista o histórico de compras entre sessões de agentes.
  • n8n-mcp — Automatize fluxos de monitoramento de preços. Crie pipelines no-code que observam os preços do BuyWhere e disparam notificações em quedas de preço.
  • tavily-mcp — Pesquise produtos antes de comprar. Use o Tavily para encontrar avaliações e comparações e, em seguida, use o BuyWhere para obter preços atuais e links de compra.
  • @playwright/mcp — Teste E2E das interações do seu agente de compras. Verifique se os fluxos de busca de produtos, comparação de preços e checkout funcionam corretamente na automação de navegador.

Protocolos

ProtocoloSuporte
MCP (Model Context Protocol)Suporte completo — 10 ferramentas, transporte stdio
A2A (Agent-to-Agent)Delegação de tarefas multi-agente — Agent Card

Contribuindo

Veja CONTRIBUTING.md para saber como relatar problemas, enviar PRs e sugerir recursos.

Do Blog

Saiba mais sobre servidores MCP e o ecossistema BuyWhere:

Suporte

Se você achar este projeto útil:

  • ⭐ Dê uma estrela no repositório — ajuda outras pessoas a descobrirem o BuyWhere
  • 🐛 Abra uma issue para bugs ou solicitações de recursos
  • 💬 Inicie uma discussão para perguntas ou ideias
  • 📣 Compartilhe com outros desenvolvedores que criam ferramentas de agentes de IA

Licença

MIT