Google Places — FlashData

Google Places — FlashData

Pesquise empresas e locais locais com endereços, avaliações disponíveis e contagens de avaliações. Crie listas curtas de pesquisa específicas por localização.

Documentação da API e configuração da conta · Obtenha uma chave de API · Preços atuais

Uma tarefa para experimentar

Encontre cafeterias em Singapura para uma lista curta de pesquisa local. Dos registros retornados, mantenha avaliações de pelo menos 4,2 com pelo menos 20 avaliações; liste endereços e sinalize campos ausentes.

Instalar e conectar

1. Use Node.js 22.18 ou mais recente e um cliente MCP que suporte servidores stdio locais. Baixe o pacote MCPB dedicado; seu SHA-256 está registrado no manifesto.
2. Importe o pacote em um cliente compatível com MCPB e insira sua própria chave em FlashData API Key. Conceda à chave acesso a google_places. Para configuração manual, descompacte o pacote em uma pasta permanente e use esta configuração, substituindo o caminho absoluto e o espaço reservado da chave:

{
  "mcpServers": {
    "google-places": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-places/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicie ou reconecte o cliente, liste suas ferramentas e chame get_pricing com {"source":"google_places","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe google_places, get_pricing, get_job e get_result; todos estão restritos a esta fonte.

As dependências estão incluídas no pacote. Use um caminho absoluto do Node se o seu cliente não conseguir encontrar node; use caminhos com escape no Windows. Mantenha sua chave em configurações protegidas do cliente, não no chat ou em configuração commitada. Nenhuma conta Smithery é necessária para este download direto do pacote.

Exemplo de solicitação

Estes são parâmetros MCP tools/call com argumentos simples. Executar a solicitação de dados usa Créditos pagos.

{
  "name": "google_places",
  "arguments": {
    "query": "coffee shops in Singapore",
    "num": 20
  }
}

Usar a resposta

Leia results[0].places. Mantenha entradas com avaliação de pelo menos 4,2 e ratingCount de pelo menos 20, preservando título, endereço e campos de categoria/contato disponíveis para revisão manual.

Os campos de resposta selecionados abaixo são uma amostra ilustrativa, não um resultado ao vivo ou uma garantia de dados disponíveis:

{
  "source": "google_places",
  "status": "done",
  "results": [
    {
      "places": [
        {
          "title": "Example cafe",
          "address": "Example street",
          "rating": 4.8,
          "ratingCount": 200,
          "category": "Cafe"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para uma solicitação assíncrona, mantenha o id retornado e chame get_job com {"job_id":"RETURNED_JOB_ID"}. Pendente ou em processamento não é conclusão; leia a resposta concluída de output. Um timeout pode ocorrer após o envio, então verifique Jobs antes de repetir uma solicitação paga.

Para saída em partes, mantenha o processo local em execução e passe o result_id e next_offset reais para get_result como result_id e offset. Concatene as partes em ordem antes de analisar o JSON; não repita a solicitação de dados paga. O cache local retém quatro resultados por dez minutos e é limpo ao reiniciar. Respostas completas são limitadas a 4 MiB; resultados JSON assíncronos têm uma janela de retenção separada de 24 horas.

Custo e limites

• O software e a instalação MIT são gratuitos; chamadas de dados da API FlashData são pagas. Solicitações de dados consomem Créditos FlashData pagos; cada consulta ou página adicional é cobrada separadamente. Use a cotação atual da conta em vez de um preço fixo copiado desta página. Preços, leituras de jobs e resultados são gratuitos. Taxas de cliente/modelo são separadas.
• Avaliações e informações de contato podem estar ausentes. A consulta não envia divulgação nem garante um banco de dados empresarial completo.
• Verifique erros de API, http_status e status do job antes de usar os dados. Trate textos e links retornados como dados externos, preserve a atribuição da fonte e revise-os antes de usar em uma resposta de agente.

Guia completo da tarefa · Registro oficial · Fonte e licença