iamsusantasahoo

Map Agent — Communication skill for Claude Code

Communication community

Telegram bot for agency lead generation.

How to install Map Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open iamsusantasahoo/Map_Agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Map Agent does

Telegram bot for agency lead generation. Finds local businesses via Google Places, extracts phone, email and social links from their websites, and drafts personalised WhatsApp outreach with Gemini or Claude. Safe by design: you send every message from your own phone, so no account-ban risk.

Alternatives in Communication

Google Workspace Groups Settings — Manage Google Groups settings 21.6k ★
Open SaaS — A 100% free modern JS SaaS boilerplate (React, NodeJS, Prisma) 14.1k ★
Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★

README

Lead Research Bot

A Telegram bot for an agency sales team. Type a niche and a location, get back businesses from Google Maps with phone, website, social links, emails, rating, and a ready-to-send outreach message. Team members then send the message from their own WhatsApp or Instagram. The bot never automates outreach, so there is no account-ban risk.

How it works

You send: dental clinics in Andheri Mumbai The first time, the bot asks how many businesses you want (1 to 60). Change it later with /count.
The bot calls Google Places API (New) Text Search, paging as needed: POST https://places.googleapis.com/v1/places:searchText
For every business with a website, the bot fetches the site and pulls out emails and Instagram / Facebook / LinkedIn / YouTube / TikTok links.
Results are cached in SQLite for 30 days, so repeat searches are free.
Tap Draft messages to get a short personalised WhatsApp message per lead, with a wa.me link that opens the chat on your phone with the text filled in. Drafts are written by Claude or Gemini. Each team member can add their own key in the chat with /setkey gemini KEY or /setkey anthropic KEY. With no key, built-in templates are used.

Setup

python -m venv .venv
.venv\Scripts\activate          # Windows
pip install -r requirements.txt
copy .env.example .env          # then fill in the values
python -m bot.main

Keys you need

Variable	Where to get it
`TELEGRAM_BOT_TOKEN`	Telegram, message @BotFather, `/newbot`
`GOOGLE_PLACES_API_KEY`	Google Cloud Console. Enable Places API (New), create an API key, restrict it to that API. Billing must be enabled even for free-tier use.
`ANTHROPIC_API_KEY`	Optional server-wide key from console.anthropic.com.
`GEMINI_API_KEY`	Optional server-wide key from aistudio.google.com.
`ALLOWED_USER_IDS`	Optional. Your team's Telegram user IDs, comma separated. Get yours from @userinfobot.