BuyWhere MCP

Pesquisa de produtos em tempo real no Sudeste Asiático com mais de 3,8 milhões de itens — o primeiro servidor MCP de e-commerce do SEA

GitHub
14
Experimente este MCPPatrocinado

Documentação

Servidor BuyWhere MCP — 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. Construída para o 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.

Siga também o espelho do blog do 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 com entrega 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_productsEnvie URLs de produtos para ingestão no catálogo (agentes/lojistas)
search_products_v2Busca v2; requer deliver_to (país ISO)
get_product_v2Detalhes do 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 a 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 sem código 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, depois use o BuyWhere para obter preços atuais e links de compra.
  • @playwright/mcp — Teste E2E as interações do seu agente de compras. Verifique se a busca de produtos, a comparação de preços e os fluxos de 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 multiagente — Agent Card

Contribuindo

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

Do Blog

Aprenda 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 para agentes de IA

Licença

MIT