楼宇大数据服务
Fornece consultas abrangentes de informações de endereços de edifícios e escritórios, incluindo
Documentação
Serviço de Big Data de Edifícios
Principais Funcionalidades
- 🔍 Pesquisa difusa por palavras-chave de empresas
- 🏢 Consulta de endereços comerciais de empresas
- 📊 Análise estatística de endereços comerciais
- 🏗️ Consulta de informações de edifícios
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/building-mcp-server
cd building-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 do 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 via 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 do 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 o MCP no Cursor / Cherry Studio
{
"mcpServers": {
"building-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": {
"building-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/building/building_bigdata?token={token}"
}
}
}
Observação: integrator_id, secret_id, secret_key e token precisam ser obtidos fazendo login em https://www.handaas.com/ para registrar e ativar a plataforma
Ferramentas Disponíveis
1. building_bigdata_fuzzy_search
Função: Pesquisa difusa por palavras-chave de empresas
Pesquisa difusa por palavras-chave como nome da empresa, nome de pessoa, marca, produto, cargo, etc., para retornar uma lista de empresas relacionadas.
Parâmetros:
matchKeyword(obrigatório): Palavra-chave de correspondência - Consulta empresas cujas informações contenham a palavra-chave correspondentepageIndex(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: Total- Outras informações relacionadas à empresa
2. building_bigdata_office_address_details
Função: Consulta de detalhes de endereços comerciais de empresas
Com base em informações específicas de identificação da empresa, consulta e retorna dados relacionados aos endereços comerciais da empresa, incluindo o número total de endereços comerciais, informações detalhadas de endereços comerciais por cidade, 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 empresaaddress(opcional): Região - Suporta filtro por província/município, exemplo de entrada: "广东省,广州市"pageIndex(opcional): Posição inicial da paginaçãokeywordType(opcional): Tipo de entidade - name: nome da empresa, nameId: ID da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificadopageSize(opcional): Posição final da paginação - Máximo de 10 registros por página
Valores de retorno:
total: TotalresultList: Resultados da listaofficeAddress: EndereçoofficeSourceType: Fonte do endereçoofficeSettleType: Tipo de ocupação - Registro comercial, endereço comercialestateName: Edifício onde está localizadoestateId: ID do edifício
3. building_bigdata_office_address_stats
Função: Análise estatística de endereços comerciais de empresas
Com base em informações específicas de identificação da empresa, consulta e retorna dados relacionados aos endereços comerciais da empresa, incluindo cidades dos endereços comerciais, quantidade de endereços comerciais por cidade, 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): Tipo de entidade - name: nome da empresa, nameId: ID da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
Valores de retorno:
officeCityStats: Estatísticas de distribuição de endereços comerciaiscity: Cidade do endereço comercialcount: Quantidade de endereços comerciais
4. building_bigdata_building_query
Função: Consulta de informações de edifícios
Suporta consulta de todas as informações de edifícios em uma região específica por nome do edifício, tipo de edifício, etc., incluindo nome do edifício, alias do edifício, endereço do edifício, tipo de edifício, número de empresas instaladas no edifício, etc.
Parâmetros:
matchKeyword(opcional): Palavra-chave de consulta - Consulta edifícios cujo nome/alias contenha a palavra-chavepageIndex(opcional): Posição inicial da paginaçãoaddress(opcional): Região - Suporta filtro por província/município, exemplo de entrada: "广东省,广州市"pageSize(opcional): Posição final da paginação - Máximo de 10 registros por páginaestatePropertyType(opcional): Tipo de edifício - Escritório, parque industrial, complexo, apartamento/hotel, centro de exposições
Valores de retorno:
total: TotalestateName: Nome do edifícioestateId: ID do edifícioestateAliasName: Alias do edifícioestateAddress: Endereço do edifícioestatePropertyType: Tipo de edifícioestateEnterpriseCount: Número de empresas instaladas no edifício
Cenários de Uso
- Gestão interna de empresas: Compreender a distribuição de endereços comerciais e a localização de edifícios
- Análise comercial: Realizar análise de distribuição geográfica de mercado
- Órgãos governamentais: Verificação de informações de empresas ou apoio à tomada de decisão
- Setor imobiliário: Análise da ocupação de edifícios
- Parcerias comerciais: Localizar a distribuição de empresas em regiões específicas
- Pesquisa de mercado: Análise da atividade comercial regional
Observações de Uso
- Exigência de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se não houver o nome completo, primeiro chame a interface building_bigdata_fuzzy_search para obter o nome completo
- Limite de paginação: A consulta de endereços comerciais retorna no máximo 10 registros por página; a pesquisa de empresas retorna no máximo 50 registros por página
- Filtro por região: Suporta filtro por província e município, no formato "província,município"
- Tipo de edifício: Suporta filtro por tipos como escritório, parque industrial, complexo, etc.
Exemplos de Perguntas
building_bigdata_fuzzy_search (Pesquisa difusa por palavras-chave de empresas)
- Ajude-me a encontrar informações de empresas que contenham a palavra-chave "腾讯"
- Pesquise a lista de empresas relacionadas a "阿里"
- Consulte empresas cujo nome contenha "抖音"
building_bigdata_office_address_details (Consulta de detalhes de endereços comerciais de empresas)
- Consulte os detalhes dos endereços comerciais da Tencent Technology Co., Ltd.
- Quais endereços comerciais o Alibaba Group possui em Pequim?
- Informações de endereços comerciais da ByteDance em Xangai
building_bigdata_office_address_stats (Análise estatística de endereços comerciais de empresas)
- Estatísticas da distribuição de endereços comerciais da Tencent em várias cidades do país
- Distribuição por cidade dos endereços comerciais do Alibaba
- Estatísticas da quantidade de endereços comerciais da Huawei em várias cidades
building_bigdata_building_query (Consulta de informações de edifícios)
- Consulte informações de escritórios no distrito de Nanshan, Shenzhen
- Pesquise edifícios de parques industriais em Zhongguancun, Pequim
- Encontre informações de edifícios de complexos no distrito de Pudong, Xangai