Produkt-Big-Data-Dienst

Dieser MCP-Dienst bietet Abfragemöglichkeiten für Unternehmensschlüsselwörter, Produktsuche, Unternehmensprodukte, Produkte ausländischer Geschäfte, Marken und E-Commerce-Kanäle und hilft Nutzern bei Produktauswahl, Wettbewerbsanalyse, Produktqualifikationsprüfung und Kanalanalyse.

Hauptfunktionen

• 🏢 Suche nach Unternehmenskurzbezeichnungen und Schlüsselwörtern

• 🔍 Suche nach Einzelhandelsprodukten und ausländischen Online-Shops

• 🧾 Abfrage von Unternehmens-Einzelhandelsprodukten und E-Commerce-Produkten

• 🌍 Abfrage des Produktkatalogs ausländischer Geschäfte

• 🏷️ Analyse von Marken und Produktwirkung von Schönheitsunternehmen

• 🛒 Analyse nationaler und globaler Online-Shop-Kanäle

Related MCP server: Enterprise Operation Insight MCP Server

Hinweise zum Servicedesign

• Der Dienst stellt 6 Tools nach tatsächlichem Verwendungszweck bereit und bildet nicht die Anzahl der Upstream-APIs ab.

• Wenn Nutzer nur eine Unternehmenskurzbezeichnung angeben, rufen Sie zuerst goods_enterprise_search auf, um den vollständigen Unternehmensnamen oder eine stabile ID zu erhalten.

• Für Unternehmensprodukte und Produkte ausländischer Geschäfte werden separate Tools bereitgestellt, um zu vermeiden, dass derselbe Parameter in verschiedenen Quellen unterschiedliche Objekte bezeichnet.

• goods_enterprise_products kann Einzelhandelsprodukte oder E-Commerce-Produkte auswählen, aber ein einzelner Aufruf greift nur auf eine Product ID zu.

• Unternehmens-Einzelhandelsprodukte: maximal 10 Einträge pro Seite; andere Seitenabfragen: maximal 50 Einträge pro Seite.

• Die äußere Geschäftsebene von Seitenergebnissen ist einheitlich total und resultList.

• Die von Drittanbieter-Produkten abhängigen Funktionen für Shop-Bestseller, Monatsumsatz und kumulierten Umsatz wurden entfernt; es werden keine Preis- oder Verkaufstrend-Tools mehr registriert.

• Bei erfolgreichem Tool-Aufruf wird das von HandaaS Integrator Gateway extrahierte Geschäftsobjekt data zurückgegeben.

Umgebungsanforderungen

• Python 3.10+

• Abhängigkeiten: python-dotenv, requests, mcp

Lokaler Schnellstart

1. In das Projektverzeichnis wechseln

cd goods-mcp-server

2. Virtuelle Umgebung erstellen und Abhängigkeiten installieren

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. Umgebungsvariablen konfigurieren

cp .env.example .env

Bearbeiten Sie .env:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT ist eine optionale Konfiguration in Sekunden; der Standardwert ist 30.

4. Dienst starten

python server/mcp_server.py streamable-http

Die Standardadresse des Dienstes ist http://localhost:8000/mcp.

Alternativ kann verwendet werden:

./start_mcp_server.sh streamable-http

Es werden die drei Startmodi stdio, sse und streamable-http unterstützt.

5. Cursor / Cherry Studio konfigurieren

{
  "mcpServers": {
    "goods-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Installation und Bereitstellung der STDIO-Version

Ersetzen Sie {workdir} durch den absoluten Pfad des Projekts:

{
  "mcpServers": {
    "goods-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID, SECRET_ID und SECRET_KEY erhalten Sie, nachdem Sie sich bei HandaaS registriert und einen Integrator aktiviert haben. Echte Anmeldedaten sollten nur in der lokalen .env oder in Bereitstellungsschlüsseln gespeichert werden.

Verfügbare Tools und Product ID

1. goods_enterprise_search

Funktion: Sucht anhand von Unternehmenskurzbezeichnung, Marke, Produkt oder anderen Schlüsselwörtern nach Kandidatenunternehmen.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmenskurzbezeichnung oder zugehöriges Schlüsselwort.

• pageIndex (optional): Seitennummer, beginnend bei 1.

• pageSize (optional): Standard 10, maximal 50.

Rückgabe: total/resultList der Kandidatenunternehmen. Nach Bestätigung des Unternehmens übergeben Sie vorzugsweise den vollständigen Unternehmensnamen, die Unternehmens-ID oder die einheitliche Sozialkreditnummer an die Tools für Unternehmensprodukte, Marken und Kanäle.

2. goods_search

Funktion: Durchsucht Einzelhandelsprodukte oder ausländische Online-Shops für Produktauswahl, Produktentdeckung und grenzüberschreitende Kanalfilterung.

Wichtige Parameter:

• matchKeyword (optional): Produktname, Online-Shop-Name oder Produktschlüsselwort.

• source (optional): retail Einzelhandelsprodukte; overseas ausländische Online-Shops. Standard: retail.

• pageIndex (optional): Seitennummer, beginnend bei 1.

• pageSize (optional): maximal 50; Standard 10 für Einzelhandelssuche, 50 für Auslandssuche.

• eshopSource, eshopCategories, eshopSalesLevel (optional): nur für die Suche in ausländischen Online-Shops.

• operationStatus, hasAssociateEnterprise (optional): Filter für Status ausländischer Online-Shops und zugehörige Unternehmen.

Rückgabe: total und resultList.

3. goods_enterprise_products

Funktion: Fragt Einzelhandels- oder E-Commerce-Produkte nach Unternehmen ab; geeignet für Produktqualifikationsprüfung, Bestandsaufnahme von Unternehmensprodukten und Wettbewerbsanalyse.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmensname, Unternehmens-ID, Registrierungsnummer oder einheitliche Sozialkreditnummer.

• productType (optional): retail Einzelhandelsprodukte des Unternehmens; ecommerce E-Commerce-Produkte des Unternehmens. Standard: retail.

• keywordType (optional): name, nameId, regNumber oder socialCreditCode.

• pageIndex (optional): Seitennummer, beginnend bei 1.

• pageSize (optional): Einzelhandelsprodukte maximal 10, Standard 10; E-Commerce-Produkte maximal 50, Standard 50.

Rückgabefelder für Einzelhandelsprodukte:

• Produktname, Produktbarcode, Einstelldatum

• Unternehmensname, Unternehmens-ID

• Markenname, GPC-Kategorie

Rückgabefelder für E-Commerce-Produkte:

• Produktname, Bildlink, Preis, Produktquelle

4. goods_overseas_store_products

Funktion: Fragt den Produktkatalog eines Geschäfts anhand der ID des ausländischen Online-Shops ab.

Wichtige Parameter:

• storeId (erforderlich): Die _id des Online-Shops, die von goods_search(source=overseas) zurückgegeben wird.

• pageIndex, pageSize (optional): lokale MCP-Seitierung, pageSize maximal 50.

Rückgabe: Informationen wie Produktanzahl, Bewertungen, BSR, Kategorie, Produktname und Links, einheitlich als total/resultList.

5. goods_brand

Funktion: Fragt Markendetails von Schönheitsunternehmen oder eine Übersicht zur Produktwirkung von Marken ab.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmenskennung.

• view (optional): brand_detail Markendetails; product_overview Übersicht zur Produktwirkung.

• keywordType (optional): Typ der Unternehmenskennung.

6. goods_channel

Funktion: Fragt die Liste der inländischen E-Commerce-Shops eines Unternehmens oder globale Details zu in- und ausländischen Online-Shops ab.

Wichtige Parameter:

• matchKeyword (erforderlich): Unternehmenskennung.

• source (optional): domestic_store inländische E-Commerce-Shops; global_store in- und ausländische Online-Shops.

• keywordType (optional): Typ der Unternehmenskennung.

• pageIndex, pageSize (optional): nur für inländische Shops, pageSize maximal 50.

Anwendungsszenarien

1. Unternehmensidentifikation: Finden Sie Kandidatenunternehmen und stabile Kennungen anhand von Kurzbezeichnung, Marke oder Produktschlüsselwörtern.

2. Produktentdeckung: Entdecken Sie Einzelhandelsprodukte anhand von Produktschlüsselwörtern oder filtern Sie ausländische Online-Shops nach Produkt und Plattform.

3. Bestandsaufnahme von Unternehmensprodukten: Fragen Sie Barcode, Marke, GPC-Kategorie und E-Commerce-Preise der Produkte eines Unternehmens ab.

4. Produktqualifikationsprüfung: Lokalisieren Sie den Produktanbieter anhand der Unternehmenskennung und prüfen Sie Produktname, Barcode und Einstellinformationen.

5. Grenzüberschreitende Wettbewerbsanalyse: Navigieren Sie von der Suche in ausländischen Online-Shops zum Produktkatalog eines bestimmten Geschäfts und analysieren Sie Kategorien und BSR.

6. Markenanalyse: Verschaffen Sie sich einen Überblick über Marken, Hauptprodukte und Produktwirkungsstrategien von Schönheitsunternehmen.

7. Kanalanalyse: Vergleichen Sie die inländischen E-Commerce-Shops und die in- und ausländischen Online-Shop-Strukturen eines Unternehmens.

Nutzungshinweise

1. Einzelne Datenquelle pro Aufruf: Ein Aufruf greift nur auf eine Product ID zu, die über source, productType oder view ausgewählt wurde.

2. Seitierungsbeschränkungen: pageSize für Unternehmens-Einzelhandelsprodukte maximal 10; für andere Seitenwerkzeuge maximal 50.

3. Umgang mit Kurzbezeichnungen: Wenn eine Unternehmenskurzbezeichnung nicht direkt abgefragt werden kann, rufen Sie zuerst goods_enterprise_search auf.

4. Priorität der Kennungen: Verwenden Sie nach Bestätigung eines Kandidaten vorzugsweise die Unternehmens-ID oder die einheitliche Sozialkreditnummer.

5. ID ausländischer Geschäfte: storeId muss aus den Suchergebnissen ausländischer Online-Shops stammen; der Unternehmensname kann nicht als Ersatz verwendet werden.

6. Leere Ergebnisse: total=0, resultList=[] sind gültige Geschäftsergebnisse.

7. Leistungsumfang: Dieser Dienst bietet keine Abfragen zu Shop-Bestsellern, Monatsumsätzen, kumulierten Verkaufszahlen oder Verkaufstrends mehr an.

Beispielfragen zur Nutzung

goods_enterprise_search

1. Welche Unternehmen entsprechen „小米“?

2. Finden Sie mir über „格力“ den genauen Unternehmensnamen und die Unternehmens-ID.

goods_search

1. Suchen Sie für mich nach Kaffeeprodukten im Einzelhandel und zeigen Sie zuerst 10 Einträge an.

2. Suchen Sie nach ausländischen Online-Shops von 亚马逊, die coffee verkaufen.

goods_enterprise_products

1. Fragen Sie die Namen, Barcodes und Marken der Einzelhandelsprodukte von 小米科技有限责任公司 ab.

2. Zeigen Sie die Namen, Preise und Quellen der Produkte an, die ein Unternehmen auf E-Commerce-Plattformen veröffentlicht hat.

goods_overseas_store_products

1. Zeigen Sie den Produktkatalog und den BSR dieses ausländischen Online-Shops an.

2. Listen Sie die Produkte und Bewertungsanzahlen des angegebenen ausländischen Geschäfts seitenweise auf.

goods_brand

1. Fragen Sie die Markendetails von 上海家化联合股份有限公司 ab.

2. Analysieren Sie die Übersicht zur Produktwirkung der Marken von 欧莱雅（中国）有限公司.

goods_channel

1. Welche inländischen E-Commerce-Shops hat 珠海格力电器股份有限公司?

2. Welche in- und ausländischen Online-Shop-Kanäle hat 北京京东世纪贸易有限公司?

Test und Validierung

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

Die Unit-Tests verwenden Mock-HTTP-Antworten und rufen keine echten HandaaS-Produktschnittstellen auf.