Factory Insight Service
Analisa a capacidade de produção industrial, incluindo avaliações, equipamentos, processos e distribuição fabril para avaliar a solidez da empresa.
Documentação
Serviço de Insights de Fábrica
Principais Funcionalidades
- 🔍 Pesquisa difusa por palavras-chave de empresas
- 🏭 Consulta de informações gerais da fábrica
- 📊 Análise estatística de produtos da fábrica
- ⚙️ Avaliação da capacidade de produção da fábrica
- 🔧 Filtro de pesquisa de fábricas
- 📍 Análise da distribuição geográfica de fábricas
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-insight-mcp-server
cd factory-insight-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 serviço via streamable-http
python server/mcp_server.py streamable-http
O serviço será iniciado em http://localhost:8000.
Modos 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-insight-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"
}
}
}
}
Usar o Serviço Remoto Oficial
1. Configurar diretamente o MCP no Cursor / Cherry Studio
{
"mcpServers": {
"factory-insight-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/factory/factory_insight?token={token}"
}
}
}
Nota: integrator_id, secret_id, secret_key e token precisam ser obtidos registrando-se na plataforma https://www.handaas.com/
Ferramentas Disponíveis
1. factory_insight_fuzzy_search
Função: Pesquisa difusa por palavras-chave de empresas
Pesquisa difusa de lista de empresas relacionadas com base em palavras-chave como nome da empresa, nome de pessoa, marca, produto, cargo, etc.
Parâmetros:
matchKeyword(obrigatório): Palavra-chave de correspondência - consulta empresas cujas informações contenham a palavra-chavepageIndex(opcional): Posição inicial da paginaçãopageSize(opcional): Posição final da paginação - máximo de 50 registros por página
Valores de retorno:
total: TotalresultList: Lista de resultados, contendo informações básicas da empresa
2. factory_insight_factory_profile
Função: Consulta de informações gerais da fábrica
Fornece a visão geral da fábrica da empresa com base nas informações de identificação, incluindo avaliação de risco e informações detalhadas da fábrica.
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 empresakeywordType(opcional): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode
Valores de retorno:
nameId: ID da empresaname: Nome da empresafoundTime: Data de fundaçãofactoryScale: Tamanho da fábricafactoryTypeList: Tipo de fábricamonthlyProductionAmountValue: Produção mensalaccountPeriodRisk: Risco de prazo de pagamentofactoryAddress: Endereço da fábricaprovince: Provínciacity: Cidadedistrict: Regiãovalue: Endereço
regCapital: Capital registradocoinType: Moedavalue: Valor
3. factory_insight_factory_product_stats
Função: Análise estatística de produtos da fábrica
Com base no nome da entidade da fábrica, obtém informações estatísticas de produtos, incluindo número de marcas atendidas, número de produtos principais, tags de produtos, estatísticas de categorias de produtos, etc.
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 empresakeywordType(opcional): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode
Valores de retorno:
serviceBrandCount: Número de marcas atendidasmainProductCount: Número de produtos principaistagNames: Tags de produtosproductCategoriesStatInfo: Informações estatísticas de categorias de produtosname: Categoriavalue: Quantidade
4. factory_insight_factory_capabilities
Função: Avaliação da capacidade de produção da fábrica
Consulta a capacidade de produção e informações de qualificações da fábrica da empresa especificada, incluindo configuração de linha de produção, alocação de pessoal, detalhes de equipamentos, gestão de qualidade e qualificações relacionadas.
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 empresakeywordType(opcional): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode
Valores de retorno:
assemblyLine: Número de linhas de produçãomonthlyProductionAmountValue: Produção mensalboarderStaffNumber: Número de pessoas de modelageminspectionStaffNumber: Número de inspetoresinspectionGroup: Equipe de inspeçãoisSupportProofing: Suporta amostragemcompanyTechnicList: Processos da fábricamanagementSystemCertification: Certificações de sistema de gestãoenterpriseCertification: Certificações de qualidade de produçãomainDeviceList: Lista de equipamentosequipName: Nome do equipamentobrand: Marca do equipamentoequipVersion: Modelo do equipamentoequipNum: Quantidade de equipamentos
patentCertificateImageList: Lista de qualificações relacionadaspatentName: Nome da qualificaçãoimage: ImagemimageLink: Link da imagem
5. factory_insight_factory_search
Função: Filtro de pesquisa de fábricas
Pesquisa informações de fábricas que atendem aos critérios com base nas condições inseridas pelo usuário (como nome da fábrica, produtos principais, nome do produto e localização geográfica).
Parâmetros:
matchKeyword(obrigatório): Palavra-chave de correspondência - nome da fábrica/produtos principais/nome do produtokeywordType(obrigatório): Tipo de entidade - pesquisa abrangente/nome da fábrica/produtos principais/nome do produtopageIndex(opcional): Número da página - começa em 1pageSize(opcional): Tamanho da página - máximo de 10 registros por páginaaddress(obrigatório): Região - formato: [["província","cidade"],["província","cidade"]]
Valores de retorno:
total: Total - máximo exibido 100001resultList: Lista de resultadosnameId: ID da empresaname: Nome da empresafoundTime: Data de fundaçãomainProducts: Produtos principaisregCapital: Capital registrado
Cenários de Uso
- Avaliação de fornecedores: Avaliar a capacidade de produção e o nível técnico dos fabricantes, selecionando fornecedores de qualidade
- Análise de investimento: Compreender a força de produção e o potencial de desenvolvimento das empresas de manufatura, apoiando decisões de investimento
- Seleção de parceiros: Encontrar parceiros com capacidades de produção específicas, otimizando a cadeia de suprimentos
- Análise competitiva: Analisar as vantagens de fabricação e a capacidade de produção dos concorrentes, definindo estratégias competitivas
- Pesquisa industrial: Estudar a distribuição e o nível de desenvolvimento da manufatura em setores específicos, identificando tendências de mercado
- Decisões de compra: Avaliar a qualidade dos produtos e a escala de produção das fábricas, otimizando decisões de compra
- Avaliação de risco: Avaliar o risco de prazo de pagamento e a estabilidade de produção dos fornecedores
Notas de Uso
- Requisito de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se não tiver o nome completo, primeiro chame a interface factory_insight_fuzzy_search para obter o nome completo
- Dados de capacidade: Os dados de capacidade podem ser capacidade projetada ou capacidade real, é necessário distinguir e verificar
- Informações de equipamentos: A precisão das informações de equipamentos depende da fonte de dados e da frequência de atualização, recomenda-se verificação em campo
- Confidencialidade de processos: Algumas informações de processos principais podem não ser totalmente divulgadas, havendo limitações de informação
- Filtro por região: A pesquisa por região deve ser inserida no formato especificado, suportando consultas combinadas de múltiplas regiões
- Limite de paginação: A pesquisa de fábricas retorna no máximo 10 registros por página, é necessário configurar adequadamente os parâmetros de paginação
Exemplos de Perguntas
factory_insight_factory_profile (Consulta de informações gerais da fábrica)
- Qual é o tamanho da fábrica da 深圳中安讯视?
- Em quais regiões estão distribuídos os endereços das fábricas da 深圳中安讯视? Qual é o capital registrado?
- Quais são os tipos de fábricas de manufatura da 深圳中安讯视? Como está o risco de prazo de pagamento?
factory_insight_factory_product_stats (Análise estatística de produtos da fábrica)
- Quantos produtos principais a 深圳中安讯视 possui?
- Como estão as estatísticas de categorias de produtos da 深圳中安讯视?
factory_insight_factory_capabilities (Avaliação da capacidade de produção da fábrica)
- Quantas linhas de produção a 深圳中安讯视 possui? Quais são as marcas dos principais equipamentos?
- Quais são os processos de fábrica da 深圳中安讯视? Como estão as certificações de sistema de gestão?
- A 深圳中安讯视 suporta amostragem? Quais certificações de qualificação relacionadas existem?
factory_insight_factory_search (Filtro de pesquisa de fábricas)
- Quais fábricas de fabricação eletrônica existem na província de Guangdong? Quais são os capitais registrados?
- Pesquise fábricas cujo produto principal seja "acessórios para celular"?
- Quais fábricas têxteis existem na província de Zhejiang?