Agent skill

Local Business B2B Prospecting

by Hermes-brasil in Hermes-brasil/hermes-brasil

Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.

MITAuto-check passedSales & Support

SKILL.md written in Portuguese; this summary is our English description.

Install Local Business B2B Prospecting

skills CLI
$ npx skills add Hermes-brasil/hermes-brasil --skill prospeccao-b2b-comercio-local -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Hermes-brasil/hermes-brasil prospeccao-b2b-comercio-local --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-src

Use ~/.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/

Facts

Skill name
prospeccao-b2b-comercio-local
GitHub stars
154
Token cost
~1.1k tokens
SKILL.md length
286 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.

  • Works in 6 steps: Coleta — Google Places API (New) —… → Dedup — Consultar banco ANTES de adicionar → Filtro — WhatsApp OU Instagram OU Site → …
  • Building a lead list of local businesses from Google Places
  • SKILL.md covers Visão geral do fluxo, 1. Coleta — Google Places API…, 2. Dedup — Consultar banco… and 3. Filtro — WhatsApp OU…, plus 5 more sections
  • Calls curl; reaches places.googleapis.com; needs API_KEY

What it does

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.

When your agent uses it

  • 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

Example prompts

  • “Collect pet shops in Curitiba from Google Places and skip any already in leads.db.”
  • “Filter this list of salons down to the ones with WhatsApp or Instagram.”
  • “Send the first message to the new leads with a two-minute gap and record each status in SQLite.”

Requirements

  • 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

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Coleta — Google Places API (New) — RECOMENDADO
  2. Dedup — Consultar banco ANTES de adicionar
  3. Filtro — WhatsApp OU Instagram OU Site
  4. Envio via WhatsApp (Evolution API)
  5. Registro no SQLite
  6. Abordagem de porta (presencial — alto diferencial)

What it can do on your machine

Read from SKILL.md and the folder at commit 8f94818. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • places.googleapis.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

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.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from Hermes-brasil/hermes-brasil at commit 8f94818, republished under its MIT licence (© Hermes-brasil). 286 words, ~1,094 tokens.

Download SKILL.mdSave it as .claude/skills/prospeccao-b2b-comercio-local/SKILL.md (or your agent's skills folder).
name
prospeccao-b2b-comercio-local
description
Prospeccao B2B de comercio local (Google Places + WhatsApp + registro).

Prospecção B2B — Comércio Local

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.

Visão geral do fluxo

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 Telegram

1. Coleta — Google Places API (New) — RECOMENDADO

Muito mais rápido e confiável que browser:

bash
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.

Setup (uma única vez)
  1. console.cloud.google.com → ativar Places API
  2. ATIVAR FATURAMENTO (obrigatório mesmo com crédito grátis)
  3. US$ 200/mês de crédito cobre ~20.000 buscas
  4. Gerar chave em Credentials > API Key
ErroCausaSolução
REQUEST_DENIED + "enable Billing"Faturamento não propagouAguardar 5-30 min
PERMISSION_DENIEDChave restritaLiberar no console
400 "FieldMask required"API Nova sem headerAdicionar X-Goog-FieldMask

2. Dedup — Consultar banco ANTES de adicionar

python
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}")

3. Filtro — WhatsApp OU Instagram OU Site

Regra prática: incluir comércios com WhatsApp OU Instagram OU site.

python
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 -> descartar

4. Envio via WhatsApp (Evolution API)

python
import 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.

5. Registro no SQLite

Após cada envio:

  • Sucesso → status='enviado'
  • Número inexistente → status='fixo'
  • Erro → status='erro_envio'

6. Abordagem de porta (presencial — alto diferencial)

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."

Pitfalls

  • Google Maps (browser) cai sem login e com CAPTCHA → preferir Places API
  • Nomes genéricos de loja retornam resultados de outras cidades → incluir bairro
  • Places API NÃO retorna Instagram → buscar separadamente (web_search)
  • Verificar conexão real do WhatsApp (profileName preenchido, não só status "open")
  • Enviar com delay para não ser bloqueado
  • Respeitar LGPD e boas práticas de prospecção

Quando usar

  • Prospecção B2B de comércio local
  • Captar leads para automação WhatsApp
  • Montar pipeline de vendas porta-a-porta + digital

© 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

Files

Just SKILL.md in skills/prospeccao-b2b-comercio-local of Hermes-brasil/hermes-brasil.

Open the folder on GitHubat commit 8f94818

Compare with similar skills

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.

Local Business B2B Prospecting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Business B2B Prospecting this skillHermes-brasil/hermes-brasil154—~1.1kAutomated safety check: PassMIT
Google Maps Search API Skillbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Google Maps API Skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT
ProspectingCesarjoquin/Marketing-Skills2021 repos~3.8kAutomated safety check: PassMIT
Apify Multi-Platform Scraperapify/agent-skills2.4k2 repos~1.4kAutomated safety check: NotesNone
Business Email Extractorgmapsscraper/google-maps-agent-skills132—~1.1kAutomated safety check: PassMIT

Similar skills

  • This skill is designed to help users automatically extract business data from Google Maps search results.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Sales & SupportAuto-check passed
  • Google Maps API Skill

    browser-act/skills

    This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • Prospecting

    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.

    202 GitHub starsUsed in 1 repo~3.8k tokens
    Sales & SupportAuto-check passed
  • Official

    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.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check: notes
  • Business Email Extractor

    gmapsscraper/google-maps-agent-skills

    Extract verified business email addresses from Google Maps listings.

    132 GitHub stars~1.1k tokensUpdated 4 mo ago
    Sales & SupportAuto-check passed
  • B2B Lead Generation

    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.

    609 GitHub stars~1.2k tokensUpdated 28 days ago
    Sales & SupportAuto-check passed

More from Hermes-brasil/hermes-brasil

All 8 skills in this repo
  • Hermes Agent Production Ops

    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.

    154 GitHub stars~1.2k tokensUpdated 6 days ago
    Auto-check: notes
  • Hermes Podcast Insights

    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.

    154 GitHub stars~802 tokensUpdated 6 days ago
    Auto-check passed
  • Human and Agent Kanban Orchestration

    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.

    154 GitHub stars~738 tokensUpdated 6 days ago
    Auto-check passed
  • RAG Company Knowledge Assistant

    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.

    154 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed
  • Think Tank Research

    Hermes-brasil/hermes-brasil

    Use quando precisar de pesquisa multi-persona com síntese protegida por evidências.

    154 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • Triagem Conteudo Externo

    Hermes-brasil/hermes-brasil

    Tratar conteúdo externo não confiável antes de agir. An agent skill from Hermes-brasil/hermes-brasil.

    154 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Local Business B2B Prospecting

What does Local Business B2B Prospecting do?

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.

When should I use Local Business B2B Prospecting?

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.

How do I install Local Business B2B Prospecting in Claude Code?

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.

How do I install Local Business B2B Prospecting in Codex?

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.

Can I use Local Business B2B Prospecting in Cursor, Gemini CLI or GitHub Copilot?

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.

What does Local Business B2B Prospecting need to run?

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.

Does Local Business B2B Prospecting access the network?

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.

Is Local Business B2B Prospecting safe to install?

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.

What licence does Local Business B2B Prospecting use?

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.

How many tokens does Local Business B2B Prospecting use?

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.

What are the alternatives to Local Business B2B Prospecting?

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.

Who maintains Local Business B2B Prospecting?

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.