如果你的客户是本地商家,例如牙医、健身房、餐厅或装修承包商,Google Maps 上已经列出了他们,但邮箱地址在每家商家自己的网站上。逐个打开几百个网站去找,正是线索列表做不下去的地方。Lovely Router 一次完成这两步。发送商家类型和地点,每个地点返回一个 JSON 对象,包含从其网站找到的邮箱、电话和社交链接,按地点个数从预付费余额中计费。用一个 API 密钥,就能从脚本、CRM 导入任务或 AI 智能体中调用。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
用 Google Maps 建立带邮箱的本地商家线索列表. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the inputs (links, keywords or accounts) and how many results you need>工作原理
选择商家类型和区域
选择一个或多个搜索词,例如
dentist,再选一个地点,比如某个城市。搜索范围大约覆盖其周围radius公里。设置上限后运行工具
把搜索连同
maxResults和max_results发送到POST /v1/tools/google-maps-leads/run。运行会从你的余额中预留它的最高费用,并以 JSON 返回地点。导入列表
过滤掉没有邮箱的地点,与你的 CRM 去重,再导入其余的。保留商家名称和地址,方便销售在写信之前核实这家商家。
一次请求获取线索列表
带邮箱的 Google Maps 线索接受 searchTerms 和 location。一个地点对应一条结果,一次运行最多可返回 200 个:
curl https://lovelyrouter.com/v1/tools/google-maps-leads/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"searchTerms": ["dentist"],
"location": "Miami, FL, USA",
"maxResults": 3,
"websiteFilter": "withWebsite"
},
"max_results": 3
}'运行超过 60 秒仍未结束时会返回 202;轮询方法见运行工具。websiteFilter 可以只保留有网站的地点(withWebsite)、只保留没有网站的地点(withoutWebsite),或者全部保留。
每个地点包含什么
| 字段组 | 你能获得的内容 |
|---|---|
| 商家 | Google Maps 上列出的本地商家 |
| 联系方式 | 从其网站找到的邮箱和电话号码 |
| 社交 | 从其网站找到的社交主页链接 |
用 withoutWebsite 可以找出根本没有网站的商家。如果你做网站建设,这本身就是一份线索列表。
实用配方
在目标城市搜索 plumber,保留有网站的地点,把带邮箱的列表交给销售作为本周的任务。
在 searchTerms 中传入多个词,例如 restaurants、cafe 和 bakery,结果会合并为一个去重后的集合。每个词都会找出不同的地点。
把 websiteFilter 设为 withoutWebsite,用电话向他们推销网页设计或商家信息服务。
用脚本对五个城市运行同一个搜索,比较每个城市有邮箱的地点数量,决定从哪里开始。
首次发送营销邮件之前,先用 email-verify 验证邮箱,避免退信损害你的发信域名。
更想直接用自然语言提问?连接 MCP 服务器,然后对 Claude Code 或 Cursor 说:"找出迈阿密 100 家有网站的牙医,把名称、电话、邮箱和网站放进一个 CSV,并去掉没有邮箱的地点。把 max_results 设为 100。"
联系信息的使用须合法合规,由你自己负责:请遵守你和收件人所在地适用的隐私与反垃圾邮件规定。
搭配其他线索来源
本地商家只是受众之一。针对公司和个人,以及核实你收集到的信息:
Google 地图上的本地商家,以及从其网站提取的邮箱、电话和社交链接。适合整理本地线索清单。
按关键词和地点在 Google 地图上查找商家:名称、地址、电话、网站、评分、评论数、营业时间、坐标。
爬取网站,提取邮箱、电话号码和社交主页链接。
检查邮箱地址是否可送达:格式、域名、MX 记录和邮箱状态。
google-maps-places按关键词和地点查找地点,包含评分、评论数和营业时间,不需要邮箱时使用。website-contacts抓取任意网站上的邮箱、电话和社交链接,适用于来自其他渠道的线索。email-verify在发送之前检查地址是否可送达。
关于更完整的流程,请看潜在客户开发。
费用说明
按地点付费:启动运行时会预留它的最高费用,即每次调用费加上每个地点的费用乘以 max_results,结束后按实际返回的结果结算,预留的剩余部分退回你的余额。失败或超时的运行只为已交付的地点付费,在开始时就被拒绝的运行不收费。
一份 300 个地点的列表,就按 300 个地点计费。没有订阅,也没有每月最低消费:最低充值 $5,工具和模型共用一个余额。上方卡片显示的是当前价格;价格页面列出了所有工具。
常见问题
每次搜索能得到多少条线索?+
对每个搜索词,附近搜索最多返回大约 60 个地点,一次运行最多返回 200 个地点。要得到更大的列表,请使用多个搜索词或多个地点。
每个地点都有邮箱吗?+
不是。邮箱、电话和社交链接来自商家自己的网站,所以没有网站,或者没有公布邮箱地址的地点就不会有邮箱。
能搜索其他国家和语言吗?+
把 location 设为任意城市或地址,把 language 设为语言代码,例如 en、de、fr、es、ja 或 zh。地点名称和描述会使用该语言。
这和普通的地图搜索有什么区别?+
google-maps-places 返回商家的基本信息:地址、电话、评分和营业时间。这个工具还会从商家网站收集邮箱和社交链接。
需要订阅吗?+
不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,不会自动续费。