渠道洞察服务

Fornece análise de canais de vendas, incluindo distribuição, redes de revendedores e cobertura, para ajudar a entender os layouts de canais empresariais.

GitHub
2
Experimente este MCPPatrocinado

Documentação

渠道洞察服务

Este serviço MCP fornece análise de distribuição de canais e canais de vendas, incluindo rede de distribuidores, canais de vendas, cobertura de canais e outras informações, ajudando os usuários a entender o layout de canais da empresa.

Principais Funcionalidades

  • 🔍 Busca difusa por palavra-chave de empresa
  • 🏪 Análise estatística de canais
  • 📊 Busca de empresas por canal
  • 🌍 Análise comparativa do mesmo setor
  • 📈 Análise de eficiência de canais

Requisitos de Ambiente

  • Python 3.10+
  • Pacotes de dependência: python-dotenv, requests, mcp

Início Rápido Local

1. Clonar o projeto

git clone https://github.com/handaas/factory-channel-mcp-server
cd factory-channel-mcp-server

2. Criar ambiente virtual e instalar dependências

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

3. Configuração de ambiente

Copie o modelo de variáveis de ambiente e configure:

cp .env.example .env

Edite o arquivo .env e configure as seguintes variáveis de ambiente:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar o serviço com streamable-http

python server/mcp_server.py streamable-http

O serviço será iniciado em http://localhost:8000.

Métodos de inicialização suportados: stdio, sse ou streamable-http

5. Configuração MCP no Cursor / Cherry Studio

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

Instalação e Implantação da Versão STDIO

Configurar MCP no Cursor / Cherry Studio

{
  "mcpServers": {
    "factory-channel-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Usando o Serviço Remoto Oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

{
  "mcpServers": {
    "factory-channel-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/factory/channel_insight?token={token}"  
      }
  }
}

Observação: integrator_id, secret_id, secret_key e token exigem login em https://www.handaas.com/ para registrar e obter acesso à plataforma

Ferramentas Disponíveis

1. channel_insight_fuzzy_search

Função: Busca difusa por palavra-chave de empresa

Busca difusa da lista de empresas relacionadas com base em palavras-chave fornecidas, como nome da empresa, nome de pessoa, marca, produto, cargo, etc.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - consulta empresas cujas diversas informações contenham a palavra-chave correspondente
  • pageIndex (opcional): Posição inicial da paginação
  • pageSize (opcional): Posição final da paginação - máximo de 50 registros por página

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados, contendo informações básicas da empresa

2. channel_insight_channel_analysis

Função: Análise estatística de canais

Realiza análise estatística de canais para uma empresa especificada, gerando dados sobre força financeira, influência da marca, capital registrado e força de vendas da empresa em relação ao mesmo setor.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - nome da empresa/número de registro/código de crédito social unificado/id da empresa
  • keywordType (opcional): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode

Valores de retorno:

  • categoryCount: Total de empresas do mesmo setor
  • financialStat: Análise de força financeira
    • regCapitalRank: Classificação do capital registrado - mostra o número de empresas do mesmo setor cujo capital registrado é superado
    • regCapitalScope: Faixa de capital registrado
    • data: Dados de faturamento anual das empresas do mesmo setor
      • name: Faixa de dados
      • ratio: Proporção do mesmo setor
      • power: Número de empresas do mesmo setor
  • salesStat: Análise de força de vendas
    • annualTurnoverRank: Classificação do faturamento anual - mostra o número de empresas do mesmo setor cujo faturamento é superado
    • annualTurnoverScope: Faixa de faturamento anual
    • data: Dados de faturamento anual das empresas do mesmo setor
    • categoryCount: Total de empresas do mesmo setor
  • productBrandList: Participação de marcas
    • name: Faixa de dados
    • number: Quantidade
    • ratio: Proporção do mesmo setor
  • productCategoryList: Participação por categoria
    • name: Faixa de dados
    • number: Quantidade
    • ratio: Proporção do mesmo setor

3. channel_insight_channel_search

Função: Busca de empresas por canal

Com base no nome da fábrica ou nome do produto e nas condições de busca especificadas, fornece uma lista de informações de empresas correspondentes, incluindo informações básicas da empresa e produtos principais.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - nome da fábrica ou nome do produto (várias palavras separadas por 、)
  • keywordType (opcional): Tipo de busca - busca abrangente/produtos principais
  • address (opcional): Região - formato: [["província","cidade"],["província","cidade"]]
  • channelTradeType (opcional): Modo de vendas - todos/comércio exterior/comércio interno
  • pageIndex (opcional): Número da página - começa em 1
  • pageSize (opcional): Tamanho da página - máximo de 50 registros por página

Valores de retorno:

  • total: Total - retorna no máximo 100.000 empresas
    • nameId: Id da empresa
    • name: Nome da empresa
    • foundTime: Data de fundação
    • mainProducts: Produtos principais
    • tagNames: Categoria de produtos
    • regCapital: Capital registrado

Cenários de Uso

  1. Otimização de canais: As empresas otimizam o layout e a gestão dos canais de vendas e definem estratégias de desenvolvimento de canais
  2. Expansão de mercado: Analisar áreas de lacuna no mercado e definir estratégias de expansão de mercado e de canais
  3. Análise competitiva: Entender as vantagens de canal e o posicionamento de mercado dos concorrentes e definir estratégias competitivas
  4. Seleção de parceiros: Encontrar distribuidores e parceiros de canal de qualidade e estabelecer relações de cooperação
  5. Decisões de investimento: Avaliar a força de canal e a capacidade de cobertura de mercado da empresa para apoiar decisões de investimento
  6. Pesquisa de setor: Estudar as características de distribuição de canais e modelos de vendas de setores específicos
  7. Otimização da cadeia de suprimentos: Otimizar o layout da cadeia de suprimentos e melhorar a eficiência e a cobertura dos canais

Observações de Uso

  1. Requisito de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se o nome completo não estiver disponível, primeiro chame a interface channel_insight_fuzzy_search para obter o nome completo da empresa
  2. Dados de canal: Os dados de canal podem estar desatualizados; recomenda-se combinar com pesquisa de campo e validação de mercado
  3. Mudanças de mercado: O layout de canais se ajusta conforme as mudanças do mercado; é necessário observar a atualidade dos dados
  4. Fontes de dados: Dados de canal de fontes diferentes podem apresentar divergências; recomenda-se validação cruzada
  5. Formato de região: A busca por região deve seguir o formato especificado, com suporte a consultas combinadas de múltiplas regiões
  6. Modo de vendas: Observar as diferentes características de vendas e modelos de canal entre comércio exterior e comércio interno

Exemplos de Perguntas de Uso

channel_insight_channel_analysis (Análise estatística de canais)

  1. Qual é a força de canal da Huawei no setor de telefonia móvel? Em que posição está seu capital registrado entre as empresas do mesmo setor?
  2. Como é a análise de força de vendas da Xiaomi? Qual é a posição do faturamento anual entre as empresas do mesmo setor?
  3. Qual é a influência da marca BYD no setor de veículos de nova energia? Como está a participação por categoria?

channel_insight_channel_search (Busca de empresas por canal)

  1. Busque empresas de canal cujo produto principal seja "acessórios para celular"; em quais regiões elas estão distribuídas principalmente?
  2. Encontre empresas que atuam com vendas de comércio exterior; qual é o capital registrado de cada uma?
  3. Quais são os distribuidores de comércio interno na província de Guangdong? Quais são as categorias de produtos?