BuyWhere

Búsqueda de productos en tiempo real y comparación de precios en más de 15 comerciantes de Singapur, Sudeste Asiático y EE. UU. (más de 161 millones de productos) a través del servidor MCP y la API REST.

GitHub
10
Prueba este MCPPatrocinado

Documentación

Servidor MCP BuyWhere — Búsqueda de Productos y Comparación de Precios para Agentes de IA

Los agentes de IA usan BuyWhere para buscar productos, comparar precios y descubrir ofertas en comercios de Singapur y EE. UU. en tiempo real.

Instalación en 30 Segundos

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

Úsalo con Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev y cualquier cliente compatible con MCP.

Get your free API key

O consigue una en 3 segundos, sin registro, sin correo electrónico: POST /v1/auth/register · Formulario heredado: 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: Usa Este Paquete Para

  • Buscar productos en los mercados de Singapur, EE. UU., Malasia, Tailandia y Vietnam por palabra clave, categoría o rango de precios
  • Comparar productos en Lazada, Shopee, Amazon y comercios locales en una sola consulta
  • Encontrar ofertas y rastrear precios en tiempo real con soporte multimoneda
  • Crear agentes de compra que recomienden, comparen y enlacen productos programáticamente
  • Descubrir catálogos de productos con taxonomía estructurada para los mercados compatibles

API de búsqueda de productos para agentes de IA mediante Model Context Protocol. Diseñado para el comercio de agentes de IA, no para la gestión de tiendas.

Listado oficial en el Registro MCP: io.github.BuyWhere/buywhere-mcp

Funciona con Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, OpenCode, Codex, Continue.dev y cualquier cliente compatible con MCP. También admite el protocolo Agent-to-Agent (A2A).

Demostración

BuyWhere MCP in Claude Desktop

Demostración de 44 segundos: búsqueda de productos, descubrimiento de ofertas, comparación de precios y soporte multirregión.

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]

Inicio Rápido

Consigue una clave en 3 segundos — sin registro, sin correo electrónico:

# 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

Registro heredado por correo electrónico (60 s, aprobación manual) → buywhere.ai/api-keys

Tutoriales

Del Blog

Lee el Blog de Ingeniería de BuyWhere para profundizar en la arquitectura MCP, el comercio de agentes y el ecosistema.

También puedes seguir el espejo del blog de BuyWhere en Hashnode para el mismo contenido de ingeniería en Hashnode.

Herramientas

HerramientaDescripción
search_productsBusca en el catálogo por palabra clave, categoría, precio o país
get_productDetalles completos del producto por ID (precios, especificaciones, imágenes)
compare_productsComparación lado a lado de 2 a 10 productos
find_best_priceListado del producto más barato disponible entre comercios
get_dealsProductos con caídas de precio significativas
list_categoriesTaxonomía de categorías de productos disponible
find_similarProductos similares por similitud vectorial
ingest_productsEnvía URL de productos para la ingesta en el catálogo (agentes/comercios)
search_products_v2Búsqueda v2; requiere deliver_to (país ISO)
get_product_v2Detalles de producto v2 por ID
compare_products_v2Comparación v2; deliver_to opcional
get_deals_v2Ofertas v2; requiere deliver_to
find_best_price_v2Mejor precio v2; requiere deliver_to

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

Configuración del Cliente MCP

Inicios rápidos de frameworks:

Claude Desktop

Añade a claude_desktop_config.json:

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

Cursor / VS Code / Cline

Añade a tu archivo de configuración de MCP:

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

Windsurf

Añade a ~/.windsurf/mcp.json:

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

OpenCode / Codex

Añade a opencode.json:

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

Continue.dev (VS Code / JetBrains)

Añade a ~/.continue/config.json:

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

Mastra

Mastra es un framework de agentes de IA centrado en TypeScript con soporte nativo de 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'
);

Guía completa: Integración de BuyWhere + Mastra

LangChain

Usa las herramientas de BuyWhere en agentes de LangChain mediante el adaptador de 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

Conecta BuyWhere mediante el cliente MCP de 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

Usa BuyWhere en un agente de CrewAI con integración de herramientas 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()

Configuración

VariablePredeterminadoDescripción
BUYWHERE_API_KEY(obligatorio)Clave API (sin registro: POST /v1/auth/register {"agent_name":"<name>"}) — se obtiene al instante, sin verificación de correo electrónico
BUYWHERE_API_URLhttps://api.buywhere.ai/mcpURL base de API personalizada

Instalación

# 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 — crea agentes de IA que busquen, comparen y recomienden productos entre mercados
  • Comparación de precios — precios multimercado en una sola consulta en Lazada, Shopee, Amazon y comercios locales
  • Descubrimiento de ofertas — encuentra productos con la mejor relación calidad-precio con precios e inventario en tiempo real
  • Automatización de comercio electrónico — integra la búsqueda de productos en cualquier aplicación compatible con MCP
  • Comercio transfronterizo — compara precios entre los mercados de Singapur, EE. UU., Malasia, Tailandia y Vietnam
  • Comercio agente a agente — delega tareas de compra entre agentes mediante el protocolo A2A

Arquitectura

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

Desarrollo

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

¿Por Qué BuyWhere?

BuyWhere es una API de búsqueda de productos para agentes de IA. Agregamos datos de productos de comercios de Singapur, EE. UU., Malasia, Tailandia y Vietnam en una única interfaz amigable para agentes — sin gestión de tiendas, sin integración con Shopify. Solo busca y compara productos en tiempo real.

  • Una API — todos los mercados, todos los comercios
  • Nativo para agentes — diseñado para MCP desde el primer día
  • Tiempo real — precios y disponibilidad en vivo
  • Prioridad al desarrollador — no se necesita SDK, solo añade el servidor

Funciona Bien Con

Estos paquetes MCP complementarios amplían BuyWhere en potentes flujos de trabajo multitarea:

  • @modelcontextprotocol/server-filesystem — Guarda resultados de compras e investigación de productos en tu sistema de archivos local. Combínalo con BuyWhere para exportar listas de ofertas, comparaciones de precios y especificaciones de productos como archivos estructurados.
  • @supabase/mcp-server-supabase — Almacena productos favoritos, preferencias de usuario y alertas de precios en Supabase. Conserva el historial de compras entre sesiones de agentes.
  • n8n-mcp — Automatiza flujos de monitoreo de precios. Crea pipelines sin código que vigilen los precios de BuyWhere y activen notificaciones cuando haya caídas de precio.
  • tavily-mcp — Investiga productos antes de comprar. Usa Tavily para encontrar reseñas y comparaciones, y luego usa BuyWhere para obtener precios actuales y enlaces de compra.
  • @playwright/mcp — Prueba de extremo a extremo las interacciones de tu agente de compras. Verifica que la búsqueda de productos, la comparación de precios y los flujos de pago funcionen correctamente en la automatización del navegador.

Protocolos

ProtocoloSoporte
MCP (Model Context Protocol)Soporte completo — 10 herramientas, transporte stdio
A2A (Agente a Agente)Delegación de tareas multiagente — Agent Card

Contribuciones

Consulta CONTRIBUTING.md para saber cómo informar problemas, enviar PR y sugerir funciones.

Del Blog

Aprende más sobre los servidores MCP y el ecosistema de BuyWhere:

Soporte

Si este proyecto te resulta útil:

  • ⭐ Marca el repositorio con una estrella — ayuda a que otros descubran BuyWhere
  • 🐛 Abre un problema para errores o solicitudes de funciones
  • 💬 Inicia una discusión para preguntas o ideas
  • 📣 Compártelo con otros desarrolladores que creen herramientas de agentes de IA

Licencia

MIT