article

README

BigGo MCP Server

Introduction

BigGo MCP Server utilizes APIs from BigGo, a professional price comparison website.

Features

Supports stdio and SSE transports

Product Discovery: Search for products across multiple e-commerce platforms (Amazon, Aliexpress, Ebay, Taobao, Shopee ... etc.)
Price History Tracking: Track product price history by supplying product url or related terms.
Spec Comparison [Disabled on versions >= v0.1.28]: Compare and find products based on their specifications, from basic infos to more complex technical specs.

Installation

Prerequisites

Python >= 3.10
uvx package manager ( Included with uv )
BigGo Certification (client_id and client_secret) for specification search.

How to obtain BigGo certification?

Register a BigGo account if you don't have one.
Go to BigGo Certification Page
Click "Generate certification" button
Copy the client_id and client_secret
Use them in the MCP Server configuration (BIGGO_MCP_SERVER_CLIENT_ID and BIGGO_MCP_SERVER_CLIENT_SECRET)

Installation Config

{
  "mcpServers": {
    "biggo-mcp-server": {
      "command": "uvx",
      "args": [ "BigGo-MCP-Server@latest"],
      "env": {
        "BIGGO_MCP_SERVER_CLIENT_ID": "CLIENT_ID",
        "BIGGO_MCP_SERVER_CLIENT_SECRET": "CLIENT_SECRET",
        "BIGGO_MCP_SERVER_REGION": "REGION"
      }
    }
  }
}

For specific version use BigGo-MCP-Server@VERSION, ex: BigGo-MCP-Server@0.1.1

Environment Variables

| Variable | Description | Default | Choices | | -------------------------------- | ------------------------- | ------- | ------------------------------------------ | | BIGGO_MCP_SERVER_CLIENT_ID | Client ID | None | Required for specification search | | BIGGO_MCP_SERVER_CLIENT_SECRET | Client Secret | None | Required for specification search | | BIGGO_MCP_SERVER_REGION | Region for product search | TW | US, TW, JP, HK, SG, MY, IN, PH, TH, VN, ID | | BIGGO_MCP_SERVER_SSE_PORT | Port for SSE server | 9876 | Any available port number | | BIGGO_MCP_SERVER_SERVER_TYPE | Server transport type | stdio | stdio, sse |

Default SSE URL: http://localhost:9876/sse

Available Tools

product_search: Product search with BigGo search api
price_history_graph: Link that visualizes product price history
price_history_with_history_id: Uses history IDs from product search results
price_history_with_url: Tracks price history using product URLs
spec_indexes: Lists available Elasticsearch indexes for product specifications
spec_mapping: Shows Elasticsearch index mapping with example documents
spec_search: Query product specifications from Elasticsearch
get_current_region: Get the current region

FAQ

How to trigger tool usage?

For Product Discovery related:

Look for Nike running shoes

For Price History Tracking related:

Show me the price history of this product: https://some-product-url

For Spec Comparison related:

Find me phones with 16GB RAM and 1TB storage

Please show me diving watches that can withstand the most water pressure

Build

See build.md for more details.

License

This project is licensed under the MIT License. See the LICENSE file for details.

BigGo-MCP-Server