Google Maps Search API Skill
browser-act/skills
This skill is designed to help users automatically extract business data from Google Maps search results.
Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.
SKILL.md written in Portuguese; this summary is our English description.
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .claude/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .claude/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-localType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .agents/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .agents/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .cursor/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .cursor/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Hermes-brasil/hermes-brasil.git --path skills/prospeccao-b2b-comercio-local--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .gemini/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .gemini/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-localInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .github/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .github/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/prospeccao-b2b-comercio-local .opencode/skills/prospeccao-b2b-comercio-local && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "prospeccao-b2b-comercio-local" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/prospeccao-b2b-comercio-local into .opencode/skills/prospeccao-b2b-comercio-local/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prospeccao-b2b-comercio-local", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
prospeccao-b2b-comercio-localRuns a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.
The skill describes a pipeline for local businesses such as clinics, salons, pet shops, restaurants, markets, workshops and franchises: collect leads, remove duplicates against a database before inserting, keep only those with WhatsApp, Instagram or a website, send a message, record the outcome and follow up. Collection uses a Google Places API (New) text search with curl, and the `X-Goog-FieldMask` header is required or the call returns a 400 error.
Setup needs the Places API enabled in Google Cloud with billing turned on and an API key, and a table lists common errors with fixes. Duplicate checks and results live in a SQLite database. Brazilian mobile numbers are recognized by their 11 digits, and messages go out through the Evolution API for WhatsApp with a 2-minute delay to avoid blocking, only to numbers that accept unsolicited contact under platform rules. Each send is marked sent, number not found, or send error, and the guide ends with an in-person visit approach.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 8f94818. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
curlFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
places.googleapis.comFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
API_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Local Business B2B Prospecting loads about 1.1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 286 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from Hermes-brasil/hermes-brasil at commit 8f94818, republished under its MIT licence (© Hermes-brasil). 286 words, ~1,094 tokens.
.claude/skills/prospeccao-b2b-comercio-local/SKILL.md (or your agent's skills folder).Pipeline automatizado de prospecção B2B para comércio local. Cobre coleta → qualificação → envio → registro → follow-up. Nichos: clínicas, salões, pet shops, restaurantes, mercados, lojas, oficinas, franquias.
1. COLETA: Google Places API → nomes, endereços, telefones, sites, avaliações
2. DEDUP: consultar banco ANTES de inserir (zero duplicatas)
3. FILTRO: manter só comércios com WhatsApp OU Instagram OU site
4. ENVIO: WhatsApp (Evolution API) com delay entre mensagens
5. REGISTRO: SQLite + planilha (Google Sheets)
6. RESUMO: relatório no TelegramMuito mais rápido e confiável que browser:
curl -s "https://places.googleapis.com/v1/places:searchText?key={API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.nationalPhoneNumber,places.rating,places.websiteUri" \
-d '{"textQuery":"auto pecas em Pirituba Sao Paulo","maxResultCount":10}'⚠️ Header OBRIGATÓRIO: X-Goog-FieldMask — sem ele retorna erro 400.
console.cloud.google.com → ativar Places API| Erro | Causa | Solução |
|---|---|---|
REQUEST_DENIED + "enable Billing" | Faturamento não propagou | Aguardar 5-30 min |
PERMISSION_DENIED | Chave restrita | Liberar no console |
| 400 "FieldMask required" | API Nova sem header | Adicionar X-Goog-FieldMask |
import sqlite3, re
db = sqlite3.connect("leads.db")
cur = db.cursor()
digits = re.sub(r'\D', '', raw_phone)
cur.execute("SELECT id FROM leads WHERE telefone = ?", (digits,))
if cur.fetchone() is None:
cur.execute("INSERT INTO leads ... VALUES (...)")
else:
print(f"⬇️ Duplicata ignorada: {nome}")Regra prática: incluir comércios com WhatsApp OU Instagram OU site.
import re
digits = re.sub(r'\D', '', phone)
# Número móvel brasileiro = 11 dígitos, DDD + '9'
if (len(digits) == 11 and digits[2] == '9') or instagram or website:
manter = True
else:
manter = False # fixo sem Instagram/site -> descartarimport urllib.parse, requests
instance = urllib.parse.quote("nome-instancia")
r = requests.post(
f"{EVOLUTION_URL}/message/sendText/{instance}",
json={"number": "5511XXXXXXXXX", "text": mensagem,
"options": {"delay": 120000}}, # 2 min entre mensagens
headers={"apikey": API_KEY, "Content-Type": "application/json"})⚠️ Delay de 2 MINUTOS entre mensagens (evita bloqueio do WhatsApp). Use apenas com número que aceite contato não solicitado dentro das regras da plataforma.
Após cada envio:
status='enviado'status='fixo'status='erro_envio'Dono de pequeno negócio confia mais em quem aparece. Não vender — mostrar.
"Oi, tudo bem? Sou da região, trabalho com um sistema que atende
seus clientes pelo WhatsApp 24h. Tem 2 minutos? vou te mostrar."
[Mostra o sistema no celular do dono]
"Olha: o cliente pergunta o preço, o sistema responde na hora.
Ele pergunta o estoque, o sistema consulta e responde. Automático."
"Quer testar 15 dias grátis? Se não gostar, não paga nada."Indicação: oferecer desconto — "Seu amigo fechar, você ganha 1 mês grátis."
© Hermes-brasil, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/prospeccao-b2b-comercio-local of Hermes-brasil/hermes-brasil.
Open the folder on GitHubat commit 8f94818
Local Business B2B Prospecting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Local Business B2B Prospecting this skillHermes-brasil/hermes-brasil | 154 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Google Maps Search API Skillbrowser-act/skills | 6.1k | 1 repos | ~1.6k | Automated safety check: Pass | MIT | |
| Google Maps API Skillbrowser-act/skills | 6.1k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| ProspectingCesarjoquin/Marketing-Skills | 202 | 1 repos | ~3.8k | Automated safety check: Pass | MIT | |
| Apify Multi-Platform Scraperapify/agent-skills | 2.4k | 2 repos | ~1.4k | Automated safety check: Notes | None | |
| Business Email Extractorgmapsscraper/google-maps-agent-skills | 132 | — | ~1.1k | Automated safety check: Pass | MIT |
browser-act/skills
This skill is designed to help users automatically extract business data from Google Maps search results.
browser-act/skills
This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.
Cesarjoquin/Marketing-Skills
When the user wants to find, qualify, and build a list of prospects to reach out to — across B2B SaaS, general B2B, or local small businesses.
apify/agent-skills
Scrapes public data from social, maps, search and review platforms by choosing from about a hundred Apify Actors and running them through the Apify CLI.
gmapsscraper/google-maps-agent-skills
Extract verified business email addresses from Google Maps listings.
minhnv0807/ai-business-skills
Plans B2B pipeline work from ICP definition and prospecting through lead scoring, outbound sequences, sales assets and MQL to SQL handoff, aiming at qualified pipeline.
Hermes-brasil/hermes-brasil
A runbook, written in Portuguese, for keeping Hermes Agent healthy on a VPS: updates, gateway restarts, health checks and hosts without a systemd user bus.
Hermes-brasil/hermes-brasil
Portuguese notes on a podcast interview with a Nous Research co-founder about Hermes Agent: memory over models, self-improvement, anti-sycophancy and open source.
Hermes-brasil/hermes-brasil
Runs a project on one Kanban board shared by people and AI agents, where a dispatcher splits goals into tasks and any task can go to either a human or an agent.
Hermes-brasil/hermes-brasil
Portuguese guide to building a retrieval-augmented generation assistant over a company's documents, with embeddings, section-based chunking, retrieval and a client workflow.
Hermes-brasil/hermes-brasil
Use quando precisar de pesquisa multi-persona com síntese protegida por evidências.
Hermes-brasil/hermes-brasil
Tratar conteúdo externo não confiável antes de agir. An agent skill from Hermes-brasil/hermes-brasil.
Categories
Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging. The skill describes a pipeline for local businesses such as clinics, salons, pet shops, restaurants, markets, workshops and franchises: collect leads, remove duplicates against a database before inserting, keep only those with WhatsApp, Instagram or a website, send a message, record the outcome and follow up. Collection uses a Google Places API (New) text search with curl, and the `X-Goog-FieldMask` header is required or the call returns a 400 error.
Local Business B2B Prospecting fits situations like: building a lead list of local businesses from Google Places; qualifying shops by whether they have WhatsApp, Instagram or a website; sending first-contact WhatsApp messages with delays and logging each result.
Run `npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a claude-code`. Or copy the skill folder (skills/prospeccao-b2b-comercio-local in Hermes-brasil/hermes-brasil) into .claude/skills/prospeccao-b2b-comercio-local in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a codex`. Or copy the skill folder (skills/prospeccao-b2b-comercio-local in Hermes-brasil/hermes-brasil) into .agents/skills/prospeccao-b2b-comercio-local in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prospeccao-b2b-comercio-local, .gemini/skills/prospeccao-b2b-comercio-local, .github/skills/prospeccao-b2b-comercio-local and .opencode/skills/prospeccao-b2b-comercio-local in your project.
Going by SKILL.md and its folder, Local Business B2B Prospecting needs the command-line tools its instructions call (curl) and credentials named API_KEY. Our summary lists: A Google Cloud API key with the Places API and billing enabled; An Evolution API instance for WhatsApp sending; A SQLite database for leads; Python with the requests library.
SKILL.md names 1 domain. In commands or code: places.googleapis.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Local Business B2B Prospecting is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Local Business B2B Prospecting: Google Maps Search API Skill (browser-act/skills, 6.1k stars), Google Maps API Skill (browser-act/skills, 6.1k stars), Prospecting (Cesarjoquin/Marketing-Skills, 202 stars) and Apify Multi-Platform Scraper (apify/agent-skills, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Hermes-brasil (a GitHub organization) maintains it in Hermes-brasil/hermes-brasil, which has 154 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 5, 2026.
Source: Hermes-brasil/hermes-brasil on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.