Skip to main content

A Model Context Protocol (MCP) server that provides product search, price history tracking, and specification search capabilities.

Project description

BigGo MCP Server

PyPI - Python Version PyPI - Version PyPI - License

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

  1. Python >= 3.10
  2. uvx package manager ( Included with uv )
  3. 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
  • Generate Certification
  • 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

biggo_mcp_server-0.2.0.tar.gz (92.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

biggo_mcp_server-0.2.0-py3-none-any.whl (24.0 kB view details)

Uploaded Python 3

File details

Details for the file biggo_mcp_server-0.2.0.tar.gz.

File metadata

  • Download URL: biggo_mcp_server-0.2.0.tar.gz
  • Upload date:
  • Size: 92.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.0

File hashes

Hashes for biggo_mcp_server-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a4b1d3b03a036896e656f56c6c86d03983c607b9b55784012a4f10c371422717
MD5 0b33a96bbde6b796ddaf08eeab6bf620
BLAKE2b-256 89168f98ad0f0f4f457a43a4dd3a589071963a0ef62ae4b4f12bd85533d24aef

See more details on using hashes here.

File details

Details for the file biggo_mcp_server-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for biggo_mcp_server-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b5a748aade05e81bdb2945865a8f19bc801821793721b0956bb1caea7676218a
MD5 a24978d3c4ff7c0a18af7132fd8b552e
BLAKE2b-256 55a1f3b9835f12b9e800c46d0557bfe93f9f7f1bac6d769deee6eeefa5abb5bf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page