使用场景

B2B 获客 API:
采集 Google Maps 与 LinkedIn 销售线索

在 Google Maps 上查找本地商家,在 LinkedIn 上找到决策人,再补全并验证他们的邮箱。让智能体通过 MCP 完成,或一次 API 调用搞定。

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
Google MapsLinkedInWebEmaillovelyjsonitems[0]"name": "Austin Smile Dental""phone": "+1 512 555 0142""website": "austinsmile.com""email": "hello@austinsmile.com""verified": true"rating": 4.8"reviews": 312

用你自己的代码或 AI 智能体构建销售线索名单。在 Google Maps 上搜索本地商家,在 LinkedIn 上查找公司和人员,从他们的网站提取邮箱和电话,并在发送前逐一验证每个邮箱地址。每一步都是一个数据工具:JSON 输入、JSON 输出,按结果计价,费用从与模型共用的同一个预付费密钥中扣除。面向本地商家销售?从 Google Maps 线索采集工具开始。面向企业的 B2B 获客?从 LinkedIn 开始。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。

Build a B2B lead list for me: find businesses on Google Maps and decision makers on LinkedIn, add their emails and verify them. 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 industry, the location, the roles you want and the columns of the CSV>
01

工作原理

010203
  1. 选择数据源

    如果目标是本地商家,Google Maps 线索只需一次运行,就能返回商家信息以及从其网站上找到的邮箱、电话和社交媒体链接。如果目标是公司和人员,使用 LinkedIn 公司搜索、LinkedIn 人员搜索或 LinkedIn 公司员工。

  2. 设置上限后运行

    把工具的 input 和 max_results 上限发送到 POST /v1/tools/{id}/run。上限在运行开始前就确定了这次运行的最高费用。

  3. 补全并验证

    把网站发给网站联系方式,把 LinkedIn 个人主页 URL 发给邮箱查找,再把每个邮箱地址发给邮箱验证。

02

一次请求采集 Google Maps 线索

下面这次运行会查找迈阿密有网站的牙科诊所,并读取每个网站上的联系方式:

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", "dental clinic"],
      "location": "Miami, FL, USA",
      "maxResults": 100,
      "websiteFilter": "withWebsite"
    },
    "max_results": 100
  }'

响应中包含运行的 status、charge_usd 中的费用,以及 items 中的商家:每一条都是一个 Google Maps 地点,附带从其网站上找到的邮箱、电话和社交媒体链接。websiteFilter 设为 withWebsite 时只保留有网站的地点;如果你的业务是帮人做网站,可以设为 withoutWebsite,只保留没有网站的地点。运行超过 60 秒仍未结束时会返回 202 和一个 poll 路径;轮询方法见运行工具。

Tip

一次附近搜索每个搜索词大约能找到 60 个地点。要覆盖一个较宽泛的品类,可以在 searchTerms 中传入多个相关词:结果会合并并去重,max_results 对它们统一生效。

03

让智能体帮你建名单

search_toolsrun_toolget_run

把 MCP 服务器连接到 Claude Code:

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

然后对它说:"查找迈阿密有网站的牙科诊所。获取它们的邮箱,逐一验证每个地址,给我一个包含名称、网站、邮箱和验证结果的 CSV。先用 suggest_tools 做规划,每次运行都设置 max_results,开始之前先告诉我预估费用。"

04

工具一览

工具主要输入返回内容
google-maps-leadssearchTerms、location、radius、websiteFilter商家信息,以及其网站上的邮箱、电话和社交媒体链接
google-maps-placessearchTerms、location、minRating、openNow名称、地址、电话、网站、评分、评论数、营业时间、坐标
website-contactsstartUrls、maxDepth、sameDomain邮箱、电话号码和社交媒体主页链接,按网站合并(每个网站最多 5 个页面)
linkedin-company-searchsearchQuery、locations、companySize名称、行业、规模、LinkedIn URL
linkedin-companycompanies(URL)或 searches(名称)简介、行业、规模、总部、网站、关注者数
linkedin-company-employeescompanies、jobTitles、locations姓名、个人简介标题、职位、个人主页 URL
linkedin-people-searchsearchQuery、locations、currentCompanies、currentJobTitles每次调用最多 25 份简要档案
linkedin-email-finderlinkedinUrls每份档案对应的工作邮箱
email-verifyemails语法、域名、MX 记录和邮箱状态
05

实用配方

先找好评餐厅,再拿联系方式。

用 "minRating": 4.5 运行 google-maps-places,然后把每个地点的 website 作为 startUrls 传给 website-contacts,并设置 "maxDepth": 1。

英国小型金融科技公司的增长负责人。

用 "searchQuery": "fintech"、"locations": ["United Kingdom"] 和 "companySize": ["11-50"] 运行 linkedin-company-search。把公司 URL 传给 linkedin-company-employees 并设置 "jobTitles": ["Head of Growth"],再把个人主页 URL 传给 linkedin-email-finder。请写 "United Kingdom",不要写 "UK":LinkedIn 可能把 "UK" 理解为乌克兰。

某个城市的创始人。

一次 linkedin-people-search 调用,设置 "searchQuery": "founder" 和 "locations": ["San Francisco"],最多返回 25 份档案,按调用计费一次。

补全客户名单。

把公司名称作为 searches 发给 linkedin-company,获取每家公司的行业、规模、总部和网站。

06

合规使用数据

线索工具返回的是公开的商业信息,其中一部分属于个人数据:姓名、职位、工作邮箱。你有责任依法使用这些数据,包括在 GDPR、CCPA 等隐私法规下具备合法依据、响应个人的请求,以及不发送未经请求的群发消息。在建立外联名单之前,请先阅读可接受使用政策。

07

费用说明

每个工具按结果收费、按调用收费,或两者兼有;上方卡片显示的是当前价格。大多数线索工具按地点、公司、档案、网站或邮箱计费。人员搜索按调用计费,一次调用最多返回 25 份档案。启动运行时会预留它的最高费用,即每次调用费加上每条结果费乘以 max_results,结束后按实际返回的结果结算。失败的运行只为结束前已交付的结果付费,因此没有任何结果的失败运行不收费。无需订阅:你只需充值一个预付费余额,模型费用也从中支付。参阅价格。

08

常见问题

?
能从 Google Maps 商家信息中获取邮箱吗?+

可以。google-maps-leads 工具会在 Google Maps 上查找商家,并在同一次运行中读取它们的网站,提取邮箱、电话和社交媒体链接。如果要为已有的销售线索做数据补全,把它们的网站发给 website-contacts 工具即可。

一次 Google Maps 运行能返回多少条线索?+

最多为你设置的 max_results 上限,每次运行最多 200 个地点。一次附近搜索每个搜索词大约能找到 60 个地点,因此要覆盖较宽泛的品类,请传入多个相关搜索词。

如何确认一个邮箱地址真实有效?+

对你的名单运行 email-verify 工具,它就是一个邮箱验证 API:会检查每个地址的语法、域名、MX 记录和邮箱状态,按邮箱计费。

AI 智能体能自己建立线索名单吗?+

可以。把 MCP 服务器连接到 Claude Code、Cursor 或其他 MCP 客户端,智能体会用 suggest_tools 做规划,用 get_tool 读取输入结构,再用 run_tool 运行工具。给它一个设置了消费上限的 API 密钥,这样会超出上限的运行在扣费之前就会被拒绝。

用这种方式收集线索合法吗?+

这取决于你和名单中的人所在的地区,以及你如何使用这些数据。你有责任依法使用结果,可接受使用政策列出了这些工具不得用于哪些用途。

接下来,可以看看社交聆听,了解潜在客户在讨论什么;看看招聘数据,获取招聘信号;或者阅读找到合适的工具,规划带费用估算的多步骤任务。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。