mcpField
M
mcp-ecommerce-store-discovery

mcp-ecommerce-store-discovery

Local
github.com/mambalabsdevBusiness & Marketing0Updated 1d ago

About mcp-ecommerce-store-discovery

An MCP server that discovers Shopify, WooCommerce, and BigCommerce stores based on product keywords. It confirms candidates on their homepages and returns evidence and store details through an Apify run.

Key features

  1. 01Search stores by product keywords
  2. 02Support Shopify, WooCommerce, and BigCommerce
  3. 03Confirm platform marks on homepages
  4. 04Return contact, payment, and traffic details

Use cases

  1. 01Find Shopify stores selling coffee
  2. 02Locate WooCommerce shops by product and country
  3. 03Collect store contacts and payment methods

MCP support

Exposes the `discover_ecommerce_stores` tool to MCP clients. It starts the Apify actor, waits for the run, and returns dataset rows.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"com-mambabuilt-mcp-ecommerce-store-discovery": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-ecommerce-store-discovery"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
Run commandnpx -y @mambalabsdev/mcp-ecommerce-store-discovery
Environment variables to set
APIFY_TOKENSecretApify API token from https://console.apify.com/account/integrations

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mambalabsdev/mcp-ecommerce-store-discovery1.0.0

Tools

1

Saved tool list · updated 4d ago

ParameterTypeRequiredDescription
countrystringNoTwo letter country code for the Google market searched. Default US.
keywordsarrayYesWhat the stores sell, for example coffee beans. Up to 50.
languagestringNoGoogle interface language. Default en.
platformenumNoStore platform to find. any returns stores on any platform the homepage reveals. Default shopify.shopify | woocommerce | bigcommerce | any
max_storesstringNoStop after this many confirmed stores, up to 500. Each is one store-found event. Default 25.
location_termstringNoOptional word added to every search, such as Texas or Australia.
max_charge_usdstringNoOptional. The run stops before any charge that would take it over this amount.
exclude_domainsarrayNoDomains to skip, for example stores already in your CRM.
max_search_pagesstringNoCap on Google result pages read; each is one search-page event. Empty or 0: set from max_stores.
include_unconfirmedenumNoAlso return, free, sites whose homepage did not show the platform. Default false.true | false
include_traffic_rankenumNoAdd the Tranco top sites rank (not a visit count). Default true.true | false
include_product_countenumNoRead the Shopify public products feed for a product count. Default true.true | false

Details

From the project README

Ecommerce Store Discovery MCP Server

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

An MCP server for the Mamba Labs Ecommerce Store Discovery actor on Apify. Give it product keywords and a platform. Each run finds stores through Google, confirms each one on its own homepage, and returns one row per store.

What's Inside

What it does

  • Searches Google with each keyword plus a footprint the platform prints on its stores, and drops marketplaces, social networks, and reference sites.
  • Reads each candidate's robots.txt and homepage, and returns the store only when the homepage carries the platform's marks, with the evidence and a confidence.
  • Per store: payment methods, subscription apps, currencies, Shopify product count, Tranco rank band and trend, contact emails, phone, and Instagram, Facebook, and TikTok links from the homepage.
  • Unconfirmed sites are skipped and not charged.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-ecommerce-store-discovery": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-ecommerce-store-discovery"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The discover_ecommerce_stores tool appears.

Prerequisites

Example prompts

  • "Find 30 Shopify stores that sell coffee beans and show their product counts and contact emails."
  • "Which WooCommerce stores in the UK sell dog treats?"
  • "List BigCommerce stores selling auto parts, with their payment providers."

Tool

discover_ecommerce_stores. One tool. Example arguments:

{
  "keywords": ["coffee beans"],
  "platform": "shopify",
  "max_stores": "25"
}

Inputs

Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and booleans are sent as strings.

InputTypeDescription
keywordsarrayWhat the stores sell. Required
platformstringshopify (default), woocommerce, bigcommerce, or any
max_storesstringConfirmed stores to return, up to 500. Default 25
countrystringGoogle market. Default US
location_termstringWord added to every search
languagestringGoogle interface language. Default en
include_product_countstringtrue or false. Default true
include_traffic_rankstringtrue or false. Default true
include_unconfirmedstringtrue or false. Default false
exclude_domainsarrayDomains to skip
max_search_pagesstringCap on Google pages read
max_charge_usdstringOptional cost cap for the run

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

EventFree planBronzeSilverGold
store-found, one confirmed store$0.0055$0.005225$0.00495$0.004675
search-page, one Google result page read$0.019$0.01805$0.0171$0.01615
apify-actor-start, per run start$0.002$0.002$0.002$0.002

Unconfirmed, refused, and failed sites are free.

Your keys

The actor needs no key. It reads Google result pages through the Apify Google SERP proxy and the stores' own public pages, and holds no key of any kind. Mamba Labs pays the platform and proxy costs of the run.

Full actor documentation

apify.com/mambalabs/ecommerce-store-discovery

License

MIT. See LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.