sales-lobstr

Lobstr.io 平台帮助

协助用户解答 Lobstr.io 平台相关问题——包括配置现成的抓取工具、运行数据采集任务、设置自动化计划、导出结果、管理额度和集成 API。Lobstr.io 是一家位于法国圣芒代的无代码网页抓取和数据采集平台。它提供 50 多款现成的抓取工具、多线程、基于 Cookie 的账号同步、计划任务自动化，以及包含 Python SDK、CLI 和 MCP Server 的完整 API。

第 1 步 — 收集背景信息

如果 references/learnings.md 存在，请先阅读，了解已积累的知识。

询问用户：

1. 你需要哪方面的 Lobstr.io 帮助？

   • A) 现成的抓取工具——选择和配置预构建的抓取工具（Google Maps、LinkedIn、Twitter、YouTube 等）
   • B) 无代码网页应用——在界面中运行抓取工具、管理任务、查看结果
   • C) 基于 Cookie 的账号同步——使用 Cookie 采集插件，抓取需要登录才能访问的内容（LinkedIn 等）
   • D) 计划任务自动化——设置带触发器的定期抓取任务
   • E) 数据导出——将结果导出到 Google Sheets、Amazon S3 或 SFTP
   • F) Webhook——配置任务状态通知（run.running、run.paused、run.done、run.error）
   • G) API / SDK / CLI——以编程方式访问、使用 Python SDK、CLI、MCP Server
   • H) Make 集成——将 Lobstr 连接到 make.com 自动化工作流
   • I) 企业定制抓取工具——针对特定用例量身打造的数据采集工具
   • J) 账号 / 账单 / 额度——定价层级、额度使用情况、浏览限制
   • K) 安全管理——浏览限制保护，避免账号被封禁
   • L) 其他——请描述具体需求

2. 你的角色是什么？

   • A) 销售 / 业务拓展
   • B) 市场营销 / 增长
   • C) 开发者 / 工程师
   • D) 数据分析师 / 研究人员
   • E) 代理机构 / 自由职业者
   • F) 其他

3. 你想实现什么目标？（描述具体目标或问题）

如果用户的请求已经提供了大部分背景信息，请直接进入相关步骤。 在合理假设的基础上先尽力给出答案（并明确说明这些假设），然后只在结尾询问最关键的 1～2 个澄清问题——不要因为还没收集齐背景信息而延迟回复。

注意：如果用户需要专门技能，请简要说明原因，并将其引导至相应技能。

第 2 步 — 转交或直接回答

如果请求对应某项专门技能，请转交：

• 通用潜在客户名单策略 / 构建目标名单 -> /sales-prospect-list
• 跨平台数据增强策略 -> /sales-enrich
• 电子邮件送达率 / 验证策略 -> /sales-deliverability
• 通过中间件将 Lobstr 连接到 CRM 或其他工具 -> /sales-integration
• Outscraper 相关问题 -> /sales-outscraper

其他情况下，请根据下方参考内容直接解答。

第 3 步 — Lobstr.io 平台参考

阅读 references/platform-guide.md，了解详细的模块说明、定价、集成方式和数据模型。

无需再了解平台指南的详细内容——专注于用户的具体情况。

第 4 步 — 可执行的指导

根据用户的具体问题：

1. 设置 Google Maps 潜在客户抓取任务：

   1. 前往 Lobstr 抓取工具目录，选择 “Google Maps Leads”
   2. 配置抓取工具参数——搜索查询（例如 “dentists in Austin, TX”）、结果数量限制和任何筛选条件
   3. 添加任务——每项任务都是要抓取的搜索查询或 URL
   4. 启动运行——Lobstr 通过多线程执行抓取工具，以提升速度
   5. 在 Web 应用中监控运行状态，或通过 Webhook 通知获取状态
   6. 将结果导出到 Google Sheets、S3，或下载为文件
   7. 每条唯一结果消耗 1 个积分——在控制面板中监控积分用量

2. 通过 Cookie 同步抓取 LinkedIn Sales Navigator：

   1. 安装 Lobstr Cookie 拾取浏览器扩展
   2. 在浏览器中正常登录 LinkedIn
   3. 点击扩展，将会话 Cookie 与 Lobstr 同步——不会共享你的密码
   4. 在 Lobstr 中选择 “LinkedIn Sales Navigator Leads” 抓取工具
   5. 配置搜索参数（职位、行业、地点、公司规模等）
   6. 启用安全管理——设置浏览限制，避免 LinkedIn 检测到过多自动化活动
   7. 启动运行并监控进度——结果包括姓名、职位、公司、地点和个人资料 URL
   8. 控制抓取量——遵守安全浏览限制，以保护你的 LinkedIn 账户

3. 设置定期计划抓取：

   1. 需要付费套餐（Free 套餐不提供计划安排功能）
   2. 配置你的 squid，设置所需的抓取工具和参数
   3. 添加任务（URL 或搜索查询）
   4. 在计划设置中定义频率（每天、每周或自定义间隔）和触发条件
   5. 设置通知——为 run.done 和 run.error 事件配置 Webhook，或启用 Gmail 提醒
   6. 还可设置自动导出到 Google Sheets 或 S3，以便自动交付结果
   7. 监控积分消耗——定期运行的任务每次运行都会消耗积分

4. 使用 API 以编程方式自动化抓取：

   1. 从 Lobstr 控制面板获取 API 密钥
   2. 创建 squid：使用抓取工具配置调用 POST /v1/squids
   3. 添加任务：使用要抓取的 URL 或参数调用 POST /v1/tasks
   4. 启动运行：调用 POST /v1/runs 并引用该 squid
   5. 轮询运行状态：调用 GET /v1/runs/{id}，直到状态变为 done
   6. 获取结果：为已完成的运行调用 GET /v1/results
   7. 轮询的替代方案：通过 POST /v1/delivery?squid={id} 配置 Webhook，在运行完成时接收 POST 通知
   8. 注意速率限制：/results 的限制为每秒 2 个请求——获取大型结果集时请实施退避策略

5. 将结果导出到 Google Sheets：

   1. 在 Lobstr 的集成设置中关联你的 Google 账户
   2. 运行完成后，在结果视图中选择 “Export to Google Sheets”
   3. 选择现有电子表格或新建一个
   4. Free 套餐的导出上限为 30 行——升级到付费套餐即可完整导出
   5. 如需自动导出，可将计划安排与 Google Sheets 集成结合使用，让每次定期运行都自动导出

注意事项

基于调研整理，仅供参考——请仔细核对，尤其是涉及套餐限制功能和集成注意事项的内容，这些信息可能已过时。

1. 免费套餐限制非常多——100 个积分、每次导出 30 行、无定时功能、无 Premium 抓取器、数据保留 7 天。 免费套餐仅适合测试。任何严肃的数据采集都需要付费套餐，起价为 €50/月。积分不会结转，且免费套餐每次导出最多 30 行，因此无法下载完整结果集。
2. 每条唯一结果消耗 1 个积分，积分不会逐月结转。 无论由哪个抓取器生成，每条唯一结果都消耗 1 个积分。未使用的积分会在每个计费周期结束时过期。请规划抓取量，使其符合你的积分额度，并监控用量，以免月中积分耗尽。
3. 基于 Cookie 的账号同步需要谨慎管理安全设置，以避免平台封禁。 在登录后抓取（尤其是 LinkedIn）时，请务必在 Lobstr 的安全管理设置中配置浏览限制。账号上的自动化活动过于频繁，可能触发检测，导致账号受限或被封禁。请从保守的限制开始，再逐步提高。
4. Webhook 端点必须在 30 秒内以 2xx 状态码响应，否则 Lobstr 会重试。 如果你的端点响应缓慢或返回错误，Lobstr 最多会重试 3 次，每次尝试间隔 15 分钟。3 次尝试均失败后，将放弃投递。请异步处理 webhook 负载——快速接受请求，并在后台作业中处理数据。
5. /results 端点的速率限制严格为每秒 2 个请求，远低于其他端点。 获取大型结果集时，请在客户端代码中实现适当的速率限制和退避机制。请批量获取结果，避免频繁轮询。/squids 和 /runs 端点的限制较宽松，为每分钟 120 个请求。
6. HubSpot、Slack、Zapier 和 Airtable 集成标注为“即将推出”——目前尚不可用。 如果你现在需要将 Lobstr 连接到这些工具，请使用 Make 集成作为桥接，或利用 Lobstr 的 webhook 和 API 功能构建自定义集成。
7. Free 套餐的数据保留期为 7 天，付费套餐最长为 28 天——请及时导出或获取结果。 超过保留期后，结果会自动删除。请设置自动导出到 Google Sheets 或 S3，或在任务运行完成后立即通过 API 获取结果。请勿将 Lobstr 控制面板用作长期数据存储。

• 持续改进：如果你发现此处未涵盖的内容，请将其附加到 references/learnings.md，并注明今天的日期。

第 5 步 — 相关技能

• /sales-prospect-list — 使用 Lobstr 和其他来源的数据构建并完善潜在客户名单
• /sales-enrich — 跨平台数据丰富策略（将 Lobstr 数据与其他数据丰富工具结合）
• /sales-integration — 将 Lobstr 连接到 CRM、自动化工具或其他工具
• /sales-deliverability — 针对抓取所得联系人数据的邮件送达率和验证策略
• /sales-outscraper — 类似的数据抓取和提取平台——比较其功能并选择合适的工具
• /sales-do — 不确定该使用哪项技能？路由器会将任何销售目标匹配到合适的技能。安装：npx skills add sales-skills/sales --skill sales-do

示例

示例 1：从 Google Maps 构建本地商家潜在客户名单

用户说：“我需要使用 Lobstr 抓取巴黎所有咖啡店的地址、电话号码和评分。” 技能执行：

1. 推荐 Lobstr 目录中的现成抓取工具“Google Maps Leads”
2. 建议将巴黎按区或街区划分，以尽可能全面地覆盖结果，例如“coffee shops, Paris 1er”“coffee shops, Paris 2ème”等，因为范围过大的查询可能会漏掉结果
3. 为每个地理区域创建任务，并启动多线程运行
4. 结果包含商家名称、地址、电话、网站、Google 评分、评论数量、营业时间和类别
5. 将完整结果导出到 Google Sheets，供销售团队使用（超过 30 行需要付费计划）
6. 建议设置每月定时运行，以收集新开业的咖啡店 结果：用户获得了一份详尽的巴黎咖啡店名单，包含联系信息和评分；名单已导出到 Google Sheets，并设置为每月更新

示例 2：通过 Cookie 同步抓取 LinkedIn Sales Navigator 潜在客户

用户说：“我想从 LinkedIn Sales Navigator 中提取德国 SaaS 公司的 CTO 搜索结果。” 技能执行：

1. 指导用户安装 Lobstr Cookie 采集浏览器扩展，并同步 LinkedIn 会话 Cookie
2. 选择“LinkedIn Sales Navigator Leads”抓取工具（高级版，需要付费计划）
3. 配置搜索参数：title = “CTO”，industry = “SaaS / Software”，location = “Germany”
4. 启用安全管理，并设置较为保守的浏览限制（例如每天 100 个个人资料），以保护 LinkedIn 账户
5. 启动运行，并通过 webhook 通知监控 run.done 事件
6. 结果包含姓名、职位、公司、所在地、LinkedIn 个人资料 URL 和其他可用字段
7. 提醒用户注意 LinkedIn 的服务条款——抓取可能违反其 TOS，用户应自行评估风险承受能力 结果：用户获得了一份通过 Sales Navigator 定向收集的德国 SaaS CTO 名单；在浏览限制下安全采集完成，可用于规划外联活动

示例 3：通过 API 和 webhook 自动执行定期数据收集

用户说：“我需要设置一条自动化管道，每周抓取竞争对手的 Google Maps 评论，并将结果推送到我们的 S3 存储桶。” 技能执行：

1. 通过 POST /v1/squids 创建一个配置为使用 Google Maps Reviews 抓取工具的 squid
2. 通过 POST /v1/tasks 添加包含竞争对手 Google Maps URL 或地点 ID 的任务
3. 通过 POST /v1/delivery?squid={id} 配置指向 Lambda 函数 URL 的 webhook，并监听 run.done 事件
4. 设置每周运行 squid 的定时自动化（需要付费计划）
5. 在 Lambda 函数中：收到 run.done webhook 后，调用 GET /v1/results（遵守每秒 2 次请求的速率限制），并将结果写入 S3 存储桶
6. 添加错误处理：同时监听 run.error webhook 事件，并通过 SNS 或 Slack 发送提醒
7. 监控额度使用情况——每周运行都会消耗额度，因此需确认计划包含足够的月度额度 结果：用户拥有一条完全自动化的每周管道：Lobstr 按计划抓取竞争对手的评论，webhook 触发 Lambda，结果写入 S3——全程无需人工操作，并可在发生错误时收到提醒

故障排除

运行卡在“running”状态或耗时过长

症状：运行长时间处于“running”状态，且没有结果出现。 原因：任务量大、目标平台受到速率限制或网络问题，都可能导致运行时间超出预期。针对受速率限制的平台（如 LinkedIn）进行多线程运行时，安全管理设置可能会有意限制运行速度。 解决方案：在 Web 应用中查看运行详情，检查进度指示器（已完成任务数与总任务数）。如果启用了安全管理，浏览限制可能会降低执行速度，这是为了保护账户而采取的预期行为。对于规模很大的运行，可以考虑拆分成较小的批次。如果运行确实卡住（长时间没有进展），请暂停并重新启动。配置 run.error Webhook，这样一旦出错就能立即收到通知，而不是事后才发现。

月中额度耗尽

症状：你收到额度已耗尽的通知，或运行在预期之前就停止产出结果。 原因：每条唯一结果消耗 1 个额度。大型抓取任务可能比预期更快耗尽额度，尤其是使用 Google Maps 或 LinkedIn 等高流量抓取工具时。额度不会结转，因此上月未使用的额度无法继续使用。 解决方案：开始大型运行前，请在控制面板中查看额度使用情况。估算额度消耗：任务数乘以每项任务的预期结果数，即可得出大致的额度成本。对于持续运行的定时任务，请计算每月所需额度（每周运行次数 × 每次运行的结果数 × 4 周），并确保套餐额度足够。如果额度总是耗尽，请升级到更高级别的套餐。也可以缩小搜索范围或更严格地筛选输入，以减少结果数量。

Webhook 未收到通知

症状：你通过 POST /v1/delivery?squid={id} 配置了 Webhook，但运行完成时，端点没有收到 POST 请求。 原因：常见问题包括：端点无法通过公网访问（例如 localhost 或被防火墙拦截）、端点未能在 30 秒内返回 200/201/202（Lobstr 会将响应缓慢视为失败）、TLS/SSL 证书问题，或 Webhook 配置不正确。 解决方案：确认端点可通过公网访问——先使用 webhook.site 等工具进行测试，确认 Lobstr 正在发送请求。确保端点在 30 秒内返回 2xx 状态码，并将繁重的处理工作转交给后台任务。检查 TLS 证书是否有效且不是自签名证书。检查 Webhook 配置：确认你正在监听正确的事件（run.done、run.error 等），且 squid ID 正确。请记住，Lobstr 最多会重试失败的投递 3 次，间隔为 15 分钟——检查是否收到了重试请求。如果其他方法都无效，可在调试 Webhook 设置期间使用 Gmail 通知作为备用方案。