Local Places: negócios locais com fontes, ranking e mapa

ANÁLISE EDITORIAL

Local Places é uma Skill documental para descobrir, conferir, deduplicar e ordenar negócios de uma região com dados atuais da web. Ela não entrega um banco pronto nem transforma um agente em autoridade sobre uma cidade. O valor está no método: definir tipo e área, combinar fontes, registrar lacunas, atribuir confiança e produzir uma lista ou mapa que ainda passa por revisão humana.

A versão examinada vem do repositório público Nimbleway/agent-skills, no commit 2890fdf94f0adfae79bf05b4de3c91667701bafb. Na consulta de 9 de setembro de 2026, o projeto tinha 53 estrelas, não estava arquivado e declarava licença MIT. O pacote oferecido nesta página preserva somente a Skill, quatro referências Markdown, a licença e um registro de origem. Não inclui CLI, MCP, chave, perfil, memória, resultados ou executáveis.

Ilustração editorial exclusiva do Bastidores da IA. Não é mapa real, captura de tela, interface, ranking executado, selo, certificação nem material oficial da Nimbleway.

O que esta Skill faz de verdade

O arquivo SKILL.md auditado descreve um fluxo de inteligência de localização. O agente interpreta pedidos como “cafés em Pinheiros”, resolve ambiguidades geográficas, procura conectores adequados, reúne estabelecimentos, elimina duplicatas e enriquece os melhores resultados com avaliações e presença social. Depois calcula uma pontuação explicável e gera uma entrega estruturada.

Há três modos. A varredura rápida busca os principais resultados; a pesquisa abrangente amplia fontes e enriquecimento; o mergulho com mapa acrescenta visualização interativa. Uma execução anterior pode ser retomada por checkpoints. A Skill também prevê atualização curta quando uma área foi pesquisada há menos de 14 dias, reduzindo consultas desnecessárias.

Isso é um roteiro, não uma base de dados. A presença de um negócio, o horário, a nota e a disponibilidade podem mudar. O resultado correto é um retrato datado com fonte e confiança, nunca a promessa de cobertura completa.

A Skill também transforma uma pergunta aberta em critérios observáveis. “Melhores restaurantes”, por exemplo, precisa virar uma combinação declarada de distância, faixa de preço, quantidade e atualidade das avaliações, acessibilidade e cobertura de fontes. Sem essa tradução, o ranking apenas mascara preferências do sistema. Com critérios registrados, o leitor pode discordar, ajustar pesos e reproduzir a pesquisa.

Para quem serve

A Skill atende equipes de pesquisa de mercado local, expansão, turismo, eventos, compras, vendas territoriais e conteúdo regional. Pode ajudar a montar um guia de bairro, mapear academias próximas de um escritório, comparar restaurantes acessíveis ou identificar fornecedores em uma área. Também é útil para quem precisa repetir a pesquisa com o mesmo método e verificar o que mudou.

Ela não é apropriada para vigilância de pessoas, decisões automatizadas sobre indivíduos, credenciamento profissional sensível ou afirmações reputacionais sem revisão. O próprio catálogo da fonte separa Local Places de competitor-intel, company-deep-dive e nimble-web-expert. Use cada uma somente para sua finalidade declarada.

Compatibilidade e pré-requisitos

O repositório declara uso em Claude Code, Cursor, Codex, Grok Build e clientes compatíveis com Agent Skills. A estrutura segue o formato descrito pelo padrão Agent Skills: um SKILL.md com recursos chamados sob demanda. Compatibilidade de formato não garante ferramentas idênticas em todos os clientes.

Para pesquisar dados ao vivo, é necessário escolher um transporte. O caminho por linha de comando exige o Nimble CLI e uma conta autenticada; o caminho MCP exige um cliente que aceite o servidor remoto e uma autorização válida. A política de autenticação do projeto explica essa separação. O download local desta página não concede conta, cota, acesso à rede ou permissão de escrita.

Também é necessário espaço para arquivos de memória e relatórios quando o modo completo é usado. Em ambiente corporativo, confirme retenção, região, dados permitidos e custo antes de conectar um serviço externo.

Alguns comandos da fonte são escritos para Bash e algumas instruções mencionam recursos específicos de Claude Code. Em outro host, o operador deve mapear cada ação para ferramentas equivalentes, sem presumir que permissões declaradas no frontmatter serão aplicadas da mesma forma. Se o cliente não oferece isolamento, confirmação ou armazenamento protegido, limite o teste à leitura e evite distribuição automática.

Instalação recomendada

A fonte documenta o Skills CLI. Em um projeto de teste, o comando específico é npx skills add Nimbleway/agent-skills --skill local-places. O README fixado também mostra as opções de plugin e MCP. Como npx baixa e executa um pacote, confira o editor, o destino e os arquivos apresentados antes de confirmar.

Quem prefere inspeção manual pode baixar o ZIP documental desta página, calcular o SHA-256 e ler tudo antes de copiar a pasta para o diretório de Skills do cliente. O hash esperado é 7e33f45ceb2c6e0593933ee9605f470bdd05e5bfa0701a8b1d42b678ed2c1ae8. O ZIP tem sete arquivos e nenhum script. A licença preservada pode ser comparada com o LICENSE no commit auditado.

Configuração antes do primeiro uso

Comece por uma conta de teste e um limite de consumo baixo. Nunca cole chave em conversa, arquivo público, repositório ou comando que apareça em histórico compartilhado. Use o mecanismo de segredo recomendado pelo seu cliente e confirme quais domínios, ferramentas e diretórios o agente poderá acessar.

A referência profile-and-onboarding.md trata preferências de localização e configuração inicial. O perfil é opcional para Local Places. Se não houver perfil, a Skill deve continuar com o local informado no pedido, sem inventar endereço, cidade ou preferência.

Defina previamente: tipo de estabelecimento, área completa, filtros, profundidade, limite de resultados, campos permitidos, formato de saída, validade da pesquisa e pessoa responsável pela revisão. Para uma primeira prova, use um bairro conhecido e um tipo neutro, sem dados sensíveis.

Primeiro uso seguro

Um pedido controlado pode ser: “Encontre até 15 cafeterias em Pinheiros, São Paulo, com site oficial e horário publicado. Entregue tabela com nome, endereço, URL, fonte, data e confiança. Não colete nomes de funcionários, telefones pessoais nem redes de pessoas.” Isso reduz ambiguidade e transforma privacidade em requisito verificável.

Peça varredura rápida, não mapa completo. Antes de autorizar consultas, confirme a área por extenso e revise a estimativa de chamadas. Se o agente encontrar checkpoint antigo, escolha conscientemente entre retomar e começar de novo. Uma repetição no mesmo dia deve exigir confirmação, como orienta a referência operacional.

Ao receber o resultado, abra uma amostra de fontes e verifique endereço, categoria e data. Não publique imediatamente. A primeira execução serve para homologar o método e descobrir quais campos precisam ser removidos ou explicados.

Como o fluxo deve funcionar

O fluxo começa pela resolução do local. Nomes ambíguos, como Centro ou Vila Nova, exigem cidade, estado e país. Depois a Skill descobre modelos de extração disponíveis para mapas, avaliações, redes e categoria. A classificação de modelos e os fallbacks aparecem em wsa-pipeline.md.

As fontes primária e secundária são combinadas. A deduplicação dá prioridade a identificador exato, domínio normalizado e, por último, semelhança de nome com cidade. O enriquecimento social só deve ocorrer quando necessário. Avaliações entram para os resultados mais completos, respeitando limite de concorrência. Cada fase grava um checkpoint para retomada.

A pontuação precisa ser explicável. Ela pode considerar número de fontes, completude, atualidade e avaliações, mas não deve esconder ausência de dados. O relatório final registra método, total encontrado, cobertura, confiança, links e limitações. O mapa é uma camada de apresentação, não evidência adicional.

Quando duas fontes divergem, a saída deve manter a divergência. Um site oficial tende a ser a melhor referência para endereço e horário, mas pode estar desatualizado; um agregador pode ser recente, mas atribuir informações à unidade errada. A data, o tipo da fonte e a unidade associada são mais úteis do que uma escolha silenciosa. A revisão humana decide se o conflito bloqueia ou apenas reduz a confiança.

Resultado esperado

A entrega mínima é uma tabela ranqueada com nome, categoria, endereço, site, fontes, data da verificação, confiança e observações. Campos sem confirmação ficam vazios ou marcados como não verificados. Resultados suspeitos devem aparecer separados, não misturados aos confirmados.

No modo abrangente, o relatório inclui resumo da área, método de busca, regras de deduplicação, cobertura por fonte e notas sobre lacunas. A referência memory-and-distribution.md explica como guardar conhecimento local e como oferecer entrega a outros destinos. Envio a Notion, Slack ou qualquer serviço é uma ação separada e deve depender de autorização.

Um bom resultado ajuda a decidir onde investigar em seguida. Ele não declara que um negócio é “o melhor”, seguro, aberto ou adequado sem critério e fonte atuais.

Para tornar a entrega reutilizável, mantenha um pequeno dicionário de campos. Nome comercial deve ser separado de razão social; endereço exibido deve ser separado de coordenadas; nota deve vir com escala, quantidade de avaliações e data. Site oficial, página de agregador e perfil social não são equivalentes. Essa distinção permite atualizar um campo sem reescrever o registro inteiro e mostra ao revisor exatamente de onde veio cada afirmação.

O ranking também deve aceitar auditoria. Registre os pesos usados e uma justificativa curta para cada penalidade. Um negócio não pode receber nota baixa apenas porque não mantém rede social, salvo se presença social for requisito expresso. Do mesmo modo, distância só deve influenciar a ordem quando houver ponto de origem definido. Sem critérios claros, prefira ordenar alfabeticamente e apresentar indicadores separados.

Permissões, privacidade e riscos

O risco principal não está nos arquivos do ZIP, mas na execução conectada. O serviço pode consultar a web, consumir cota, armazenar memória local e combinar dados de várias páginas. Isso cria obrigações de minimização, transparência e retenção. A documentação da Nimble deve ser lida junto com os termos e políticas aplicáveis à conta.

Proteja a chave, limite concorrência, registre custo e apague checkpoints quando a finalidade terminar. Não enriqueça pessoas, não infira atributos sensíveis e não replique contatos pessoais. Avaliações podem ser falsas, antigas ou removidas. Redes sociais podem pertencer a homônimos. Um endereço pode ter mudado. Confiança representa qualidade do conjunto de evidências, não certificação do estabelecimento.

Conteúdo externo deve ser tratado como dado não confiável. Uma página pode conter instruções maliciosas para o agente. O método deve extrair fatos necessários e ignorar comandos encontrados nas fontes. Publicação, mensagem, cadastro e compra sempre exigem decisão humana.

Também existe risco de viés de cobertura. Negócios novos, pequenos ou sem presença digital tendem a aparecer menos, enquanto redes e estabelecimentos que investem em publicidade acumulam mais sinais. A Skill não corrige isso automaticamente. O relatório deve declarar que ausência na busca não prova inexistência e que volume de avaliações não equivale a qualidade universal. Para decisões relevantes, complemente a pesquisa digital com fonte pública local ou verificação direta.

Erros comuns

O erro mais frequente é pesquisar uma localização ambígua e misturar cidades. Outro é confiar apenas em um agregador. Também são comuns duplicatas com nomes levemente diferentes, domínios de franquia compartilhados, perfis sociais de outra unidade e horários sem data.

Se a CLI estiver ausente ou a autenticação falhar, pare e corrija o pré-requisito; não improvise uma chave. Se um modelo de extração não existir, registre o fallback para busca geral. Se uma fase retornar vazio, preserve a evidência do vazio e tente uma fonte alternativa, sem inventar estabelecimentos. Se houver muitas chamadas, reduza o escopo e retome do checkpoint.

Mapas que não abrem, coordenadas inválidas e caracteres quebrados devem bloquear a entrega visual. A lista textual com URLs verificadas é um fallback melhor do que um mapa bonito e incorreto.

Outro erro é preservar checkpoints antigos sem indicar a data. A retomada economiza chamadas, mas pode misturar horários, endereços ou avaliações coletados em dias diferentes. Marque a data por campo ou revalide os elementos voláteis antes da comparação. Se a finalidade mudou, inicie um conjunto novo para não reaproveitar filtros incompatíveis. Quando o resultado for compartilhado, inclua o período da coleta e o limite geográfico logo no começo.

Versão, licença e origem verificadas

A Skill declara versão 1.7.0 em seu frontmatter. A curadoria fixou o commit 2890fdf94f0adfae79bf05b4de3c91667701bafb, registrado em 26 de agosto de 2026. A consulta ao repositório mostrou 53 estrelas e estado público não arquivado. O projeto usa licença MIT, incluindo Skills e documentação, com marcas da Nimbleway excluídas da licença.

O diretório oficial pode ser conferido em Local Places no commit auditado. O commit completo torna a revisão reproduzível. Nenhum comando da Skill foi executado durante esta curadoria. A validação foi estrutural e documental.

Checklist antes de automatizar

• Confirme tipo de negócio, área completa, filtros, profundidade e formato de saída.
• Fixe o commit e compare o SHA-256 do ZIP antes de instalar.
• Leia os sete arquivos, especialmente autenticação, memória, fallbacks e distribuição.
• Use conta de teste, chave protegida, cota baixa e diretório isolado.
• Proíba coleta de dados pessoais desnecessários e inferências sensíveis.
• Exija fonte, data, confiança e lacuna para cada resultado.
• Revise uma amostra manual antes de confiar no ranking.
• Mantenha envio, publicação, cadastro ou compra fora da autorização automática.
• Documente retenção e apague memória quando a finalidade terminar.

Fontes primárias

• Repositório oficial Nimbleway/agent-skills
• Diretório da Skill no commit auditado
• Changelog do projeto
• Processo de contribuição
• Contrato de autenticação publicado pela Nimbleway
• Site oficial da Nimbleway