1. 项目概述一个为AI智能体打造的B2B销售线索挖掘技能如果你正在寻找一种方法让AI助手比如Claude能像你的顶级销售开发代表一样直接从自然语言对话中帮你挖掘、筛选和导出潜在客户那么这个名为“SMB Sales Boost”的OpenClaw技能就是你一直在等的工具。简单来说它把一个专业的B2B销售线索数据库无缝地接入了你的AI工作流。你不再需要手动登录各种平台、填写复杂的筛选表单或者学习API调用。你只需要像跟同事聊天一样告诉你的AI助手“帮我找找过去一周在佛罗里达州新注册的牙科诊所”它就能理解你的意图自动执行搜索并以结构化的表格形式将结果呈现给你。这个技能的核心价值在于它将复杂的销售线索获取过程抽象成了一个极其简单的自然语言接口。它面向的是所有需要通过寻找新注册中小企业来拓展业务的团队或个人无论是销售主管、市场专员、创业者还是自由职业者。尤其适合那些正在进行“冷启动”市场拓展、需要快速建立潜在客户列表的Go-to-Market团队。你不再需要是技术专家只要你会描述你的目标客户AI就能帮你找到他们。2. 核心设计思路为什么选择“技能”模式与双数据库架构2.1 “技能”模式 vs 传统API集成效率的跃迁传统的销售线索工具集成通常意味着开发团队需要花费数周甚至数月的时间研读API文档、编写和测试集成代码、构建前端界面、处理错误和速率限制。这个过程不仅耗时而且将使用门槛限制在了技术人员手中。“SMB Sales Boost”技能采用了一种截然不同的思路。它将自己封装为一个标准的OpenClaw技能包。OpenClaw是一个允许AI智能体如Claude扩展其能力的框架。技能包中包含了AI理解该领域任务所需的所有“知识”API端点描述、参数定义、使用示例以及安全约束。这意味着一旦技能被安装并配置好API密钥AI就“学会”了如何操作整个SMB Sales Boost系统。这种设计带来了几个根本性的优势零代码交互最终用户完全通过自然语言与AI对话来完成所有操作无需编写一行代码。意图理解AI可以理解模糊的、口语化的查询并将其转化为精确的API调用。例如“找找评分高的承包商”会被自动翻译为针对home_improvement数据库、starRating字段大于等于4的筛选条件。上下文连贯AI能记住你之前的搜索和筛选条件并在后续对话中基于此进行优化或组合形成一个连贯的销售勘探会话。安全封装所有对底层API的调用都通过一个受控的客户端脚本smb_api.py进行该脚本内置了防止路径遍历、注入攻击等安全机制用户无需关心底层实现细节。2.2 双数据库架构精准匹配不同的销售场景该项目没有采用“一刀切”的数据库而是精心设计了两个独立的线索库这直接反映了对B2B销售场景的深刻理解。2.2.1 家装承包商数据库 (home_improvement)这个库专门针对本地服务行业尤其是家装、维修、园林绿化等承包商。其数据特点鲜明核心触点电话号码是首要联系方式。对于需要电话销售的团队如家居建材供应商、工具租赁公司来说这是黄金信息。质量信号提供了星级评分和评论数量。这不仅仅是联系方式更是初步的资质筛选工具。你可以优先联系评分高、口碑好的承包商他们的业务更稳定合作意愿可能更强。深度信息包含评论片段和个人资料URL。销售代表在打电话前可以通过评论了解客户的服务特点和潜在痛点准备更有针对性的开场白。适用场景非常适合销售高价值、需要建立信任的本地化服务或产品如定制橱柜、高端建材、商业保险等。2.2.2 通用新注册企业数据库 (other)这个库覆盖面更广包含所有类型新注册的中小企业。其数据维度更加多元双渠道触点同时提供电话号码和电子邮件地址。这为多渠道触达电话邮件提供了可能极大提高了 Outreach 的覆盖率和灵活性。网络足迹包含企业注册的网站URL、爬取到的其他URL以及网站描述。这对于了解企业业务范围、市场定位非常有帮助。AI智能分类这是该库的一大亮点。系统会使用AI模型为每条线索估算1-3个所属行业类别存储在AI Categories字段。这意味着即使企业名称模糊你也能通过AI分类进行精准筛选。例如一家名为“星辰科技”的公司AI可能将其分类为[IT Services, Software Development]。适用场景几乎适用于所有B2B销售场景特别是依赖邮件营销、内容营销或需要广泛行业覆盖的团队如SaaS软件销售、企业服务、办公用品批发等。注意两个数据库的字段命名采用了带空格的显示名称如Company Name,Phone Primary而非程序员习惯的下划线命名。这在通过API筛选时需要特别注意确保字段名完全匹配。3. 实操部署与核心配置详解3.1 环境准备与技能安装部署这个技能你只需要一个运行着兼容OpenClaw框架的AI助手环境例如某些特定配置的Claude工作空间。以下是具体的步骤获取技能包通常你需要从技能的发布页面或仓库如Github下载smb-sales-boost-skill的整个文件夹。放置技能目录将该文件夹完整地放置到你的OpenClaw工作空间的skills/目录下。最终的目录结构应该如下所示你的工作空间路径/ └── skills/ └── smb-sales-boost/ # 技能文件夹 ├── SKILL.md # 核心技能定义文件含OpenClaw元数据 ├── smb_api.py # 安全的API客户端脚本 ├── openapi.json # 完整的API规范供AI参考 └── README.md # 用户说明文档即你提供的原始内容订阅与密钥你需要拥有一个有效的SMB Sales Boost订阅Starter, Growth, Scale, Platinum, Enterprise任一档位。然后在SMB Sales Boost的用户面板的“API”选项卡中生成一个API密钥。密钥通常以smbk_开头。3.2 关键配置API密钥的安全注入技能的运行依赖于API密钥。OpenClaw技能框架提供了两种主流且安全的方式来配置密钥绝对禁止将密钥硬编码在代码或直接写在对话中。方案一通过OpenClaw配置文件管理推荐这是最规范、可维护性最好的方式。你需要编辑OpenClaw的全局配置文件通常位于~/.openclaw/openclaw.json在skills.entries部分添加本技能的配置。{ skills: { entries: { smb-sales-boost: { // 技能名称通常与文件夹名对应 enabled: true, apiKey: { source: env, // 指定密钥来源为环境变量 provider: default, id: SMB_SALES_BOOST_API_KEY // 环境变量名 }, env: { // 在这里直接定义环境变量的值仅限安全、私有的环境 SMB_SALES_BOOST_API_KEY: smbk_your_actual_key_here_do_not_share } } } } }优势配置集中管理与技能代码分离。即使技能包更新配置也不会丢失。注意在团队共享或可能存在安全风险的环境下不建议将真实的密钥明文写在配置文件中。此时可以使用apiKey配置引用外部密钥管理工具而将env部分留空或从更安全的地方加载。方案二通过系统环境变量设置如果你更习惯使用命令行或者是在临时环境中测试可以在启动你的AI助手之前在终端中设置环境变量。# 在Linux/macOS的终端中 export SMB_SALES_BOOST_API_KEYsmbk_your_actual_key_here # 然后在此终端中启动你的AI助手应用 # 在Windows PowerShell中 $env:SMB_SALES_BOOST_API_KEYsmbk_your_actual_key_here优势简单快捷适用于一次性测试。劣势环境变量只在当前会话有效重启或新开终端后需要重新设置。且在多用户系统上环境变量可能被其他进程读取安全性稍弱。方案三客户端脚本直接使用技能包自带的smb_api.py脚本也可以独立运行用于调试或直接调用API。它接受密钥作为第一个命令行参数。python smb_api.py smbk_your_key_here search --keywords *coffee* --state CA注意在共享服务器或可能留下历史记录的环境中使用命令行参数传递密钥存在风险。该脚本也会尝试读取SMB_SALES_BOOST_API_KEY环境变量因此方案二与之结合更安全。核心安全准则无论采用哪种方式都必须将SMB_SALES_BOOST_API_KEY视为密码对待。切勿将其提交到代码仓库、粘贴到公开的聊天室或共享文档中。一旦怀疑密钥泄露应立即在SMB Sales Boost面板中将其撤销并生成新密钥。3.3 信用点系统解析与成本控制SMB Sales Boost的Starter, Growth, Scale计划采用信用点Credit消耗模型理解这个模型是控制成本的关键。3.3.1 信用点如何消耗查询消耗每次使用GET /leads搜索线索时返回的每一条新线索扣除1信用点。“新线索”指你账户从未导出过的记录。导出消耗使用POST /leads/export导出时导出的每一条新线索扣除1信用点。免费重访已导出过的线索后续再次查询或导出不扣除信用点。这意味着你购买的线索是一次性付费永久可访问。3.3.2 如何精明地使用信用点技能提供了精细的控制参数避免信用点被意外耗尽maxCredits最大信用点这是最重要的预算控制阀。你可以为单次查询或导出设置一个信用点上限。例如设置maxCredits10那么这次操作最多只消耗10个点即使匹配到1000条新线索也只会处理返回或导出前10条。maxResults最大结果数这个参数控制返回或导出的线索总条数包括新旧线索。结合maxCredits使用可以精确控制输出规模。预览模式 (GET /leads/preview)在花费信用点之前务必使用此功能。它会返回匹配的线索数量并展示脱敏后的数据如隐藏部分电话号码和邮箱让你确认筛选条件是否准确预估潜在消耗。maxCredits0技巧将此参数设为0可以免费获取所有你已经导出过的线索。非常适合用于数据回顾、二次分析或构建报告。3.3.3 信用点套餐与购买策略套餐每月赠送信用点单点价格单次最大购买量适用场景分析Starter500$0.102,500适合个人创业者或小微团队试水每月探索500个新线索。Growth2,000$0.07510,000适合有稳定线索需求的小型销售团队性价比开始显现。Scale10,000$0.0550,000适合中型团队或代理机构进行规模化、常态化的线索挖掘。Platinum100,000$0.03500,000适合大型企业或高速增长的销售团队追求最低单点成本。Enterprise250,000$0.021,250,000定制级套餐适用于超大规模、持续性的销售拓客需求。实操建议新手可以从Starter计划开始利用每月赠送的点数测试不同关键词和筛选组合的效果。当找到高效的关键词模型后再根据月度消耗量升级到更划算的计划或批量购买信用点。所有套餐都支持通过POST /purchase-credits随时增购点数也可以通过PATCH /auto-top-up设置自动充值避免工作中断。4. 高级搜索技巧与实战工作流4.1 掌握通配符与关键词策略搜索的精准度和广度直接取决于关键词的设置。系统支持强大的通配符 (*) 和逻辑组合。4.1.1 基础通配符用法*代表任意数量的任意字符。*dental*会匹配包含 “dental” 子串的任何词如 “dental clinic”, “cosmetic dentistry”, “dental lab supplies”。*auto*repair*匹配 “auto body repair”, “automotive repair shop”, “24/7 auto repair”。*med*spa*匹配 “med spa”, “medical spa”, “medspa wellness”。4.1.2 构建高效的关键词列表不要只用一个关键词。针对一个目标客户群体构建一个包含多种变体、同义词、相关业务词的关键词数组能大幅提高召回率。// 针对“宠物美容”行业 { positiveKeywords: [ *pet*groom*, // 覆盖 pet grooming *dog*groom*, // 覆盖 dog groomer *cat*groom*, // 覆盖 cat grooming salon *pet*salon*, // 覆盖 pet salon *mobile*groom*, // 覆盖 mobile pet grooming *pet*spa* // 覆盖 pet spa ] }逻辑关系同一个数组内的关键词是“或(OR)”关系只要匹配其中任意一个线索就会被纳入。4.1.3 排除关键词的妙用negativeKeywords用于过滤掉你不需要的线索这对于提高线索质量至关重要。排除连锁品牌如果你只做独立小店可以排除*franchise*,*chain*。排除非目标业务搜索“bakery”时排除*pizza*,*donut*以避免匹萨店和甜甜圈店。排除特定地点在州级别搜索时可以用城市名排除例如在加州搜索时排除*Los Angeles*如果不想覆盖该市。4.1.4 URL搜索的特殊处理当搜索条件应用于URL字段时系统会自动将搜索词中的空格替换为%通配符。这是因为URL中常用连字符(-)或下划线(_)连接单词。你输入dental clinic系统实际搜索%dental%clinic%这将匹配example.com/dental-clinic,best-dental-clinic-nyc.com,dentalclinic.org4.2 理解“最后更新”时间抓住黄金线索Last Updated字段是这个系统中最具行动价值的字段它直接指示了线索的“新鲜度”和“可触达性”。对于家装数据库 (home_improvement)Last Updated时间戳更新意味着系统新发现或更新了该承包商的电话号码。对于依赖电话销售的行业这就是最直接的销售机会窗口。对于通用数据库 (other)Last Updated更新意味着以下至少一项联系信息发生了变动主要电话、次要电话、主要邮箱、次要邮箱、完整地址。很多企业注册后会先搭建网站过一段时间才公布联系方式。这个时间戳正好捕捉了联系方式“从无到有”或“从旧到新”的关键时刻。实操建议在几乎所有搜索中都应该习惯性地加上时间筛选。例如“lastUpdatedFrom”: “rel:7d”查找过去7天内更新过的线索。这是获取高意向度新线索的最佳实践。“lastUpdatedFrom”: “2024-01-01”查找今年以来的所有新线索。 将时间筛选与地域、行业筛选结合能帮你快速定位当前最活跃、最可能产生需求的目标市场。4.3 从搜索到转化的完整工作流示例假设你是一家为中小企业提供云财务软件的公司SaaS目标客户是员工数在10-50人、非科技行业的服务型企业。以下是一个完整的自然语言驱动的工作流第一步探索与验证零成本你对AI说我想找找纽约州新注册的营销机构和设计工作室先看看大概有多少家别花点数。AI会调用GET /leads/preview使用类似[*market*agency*, *design*studio*, *creative*agency*]的关键词并设置州为NY。返回结果会显示匹配总数和脱敏的样本不消耗信用点。你发现匹配了1200家数量可观。第二步精准筛选与首次获取你不错。那我想要其中过去30天内更新过、并且AI分类里包含‘Marketing’或‘Advertising’的线索先花50个点数看看质量。AI调用GET /leads在上一步关键词基础上添加lastUpdatedFrom: “rel:30d”并在aiCategories字段筛选包含“Marketing”或“Advertising”。同时设置maxCredits: 50。返回50条最新的、经过AI分类验证的高质量线索消耗50信用点。第三步分析结果并优化关键词浏览这50条结果你发现很多“设计工作室”其实是室内设计或服装设计并非你的目标。于是你优化关键词排除室内设计。你把‘*interior*design*’加到排除词里。另外再生成一些关于‘business consulting’和‘coaching’的关键词看看。AI可以调用POST /ai/generate-keywords为你生成一批带通配符的“商业咨询”和“教练服务”相关关键词。你可以将这些新关键词加入搜索列表。第四步保存为预设并设置邮件提醒你对当前的筛选组合纽约州、过去30天更新、特定AI分类、优化后的关键词很满意决定将其保存并让系统定期推送新线索。你把这个搜索条件保存为‘NY_Marketing_Agencies_30d’。然后设置一个每周一的邮件提醒把新线索发到我邮箱。AI会先调用POST /filter-presets保存预设然后调用POST /email-schedules创建一个每周一运行的邮件任务。之后每周你都会自动收到符合条件的新注册企业列表。第五步导出数据并分配当你积累了一批线索后可以导出给销售团队。你把‘NY_Marketing_Agencies_30d’这个预设匹配到的、我还没导出过的线索导出成CSV最多花200个点数。AI调用POST /leads/export指定预设ID并设置maxCredits: 200。系统会生成一个包含200条新线索的CSV文件。你还可以利用“分发给销售团队”的功能让AI自动将导出的线索平均分配给多个邮箱或CRM集成。5. AI增强功能让线索挖掘更智能除了基础的搜索技能集成了多项AI功能用于优化你的勘探策略。5.1 AI自动优化关键词列表这是提升搜索效率的利器。当你创建一个关键词列表后可以对其启用“自动优化”。你帮我启用‘TX_Pet_Services’这个关键词列表的自动优化功能。AI调用POST /ai/auto-refine/enable。系统会启动一个单次运行的AI优化流程通常包含四个阶段验证阶段评估现有关键词的有效性和重复性。发现阶段基于现有关键词和数据库内容智能推荐最多15个新的正面关键词和5个新的负面关键词。评分阶段为所有关键词包括新的进行质量评分。应用阶段将优化后的列表更新或提供建议供你审核。 这个功能能帮你发现那些你没想到但实际存在的业务表述不断扩大搜索的覆盖网。5.2 AI行业分类建议如果你刚开始进入一个新市场不确定该搜索哪些行业类别可以让AI给你建议。你我销售健身器材给小型健身房和工作室AI能建议我关注哪些行业分类吗AI调用POST /ai/suggest-categories输入你的业务描述。系统会返回一个相关的行业分类列表例如[Fitness Centers, Personal Trainers, Yoga Studios, Martial Arts Schools]。你可以直接将这些分类用于aiCategories字段的筛选快速锁定目标客户群。5.3 基于AI分类的筛选对于other数据库AI Categories字段是强大的筛选器。不同于关键词的模糊匹配AI分类是系统对企业主营业务的“判断”准确度更高。精准定位直接筛选aiCategories包含 “IT Services”可以找到科技服务公司避免关键词搜索“tech”时误伤“Tech Restaurant”这种不相关的企业。组合筛选你可以要求aiCategories同时包含 “Legal” 和 “Consulting”来寻找法律咨询公司而不是单纯的律师事务所或管理咨询公司。排除分类同样你可以排除某些分类比如做B2B软件的要排除[Restaurants, Retail]。6. 账户、订阅与数据管理6.1 账户信息与订阅管理你可以随时通过自然语言查询账户状态。你我现在的订阅计划是什么还剩多少点数AI调用GET /me端点返回你的套餐详情、剩余信用点、自动充值设置等信息。你我想升级到Growth计划。AI会调用POST /subscription/change-plan但在执行前必须向你确认因为这会触发计费变更。同样取消订阅 (POST /subscription/cancel) 或购买额外点数 (POST /purchase-credits) 都需要明确的用户确认这是技能内嵌的安全防护机制。6.2 数据导出与文件安全导出功能 (POST /leads/export) 非常强大支持CSV、JSON、XLSX格式。导出的文件包含完整的联系方式属于敏感信息。安全存储实践默认输出目录导出的文件默认保存在技能配置或smb_api.py脚本指定的安全目录如/mnt/user-data/outputs。确保该目录的访问权限受到严格控制。文件命名导出的文件名通常包含时间戳和筛选条件便于追溯。例如leads_marketing_ny_20240527.csv。严禁公开分享绝对不要将包含真实电话号码和邮箱的导出文件上传到公开的云盘、代码仓库或群聊中。内部传阅也应通过安全的企业通信工具进行。定期清理建立制度对过期或无用的线索文件进行安全删除。6.3 黑名单管理如果你发现某些域名或企业明显不是你的目标客户或者是不希望重复获取的可以将其加入导出黑名单。你把 example.com 和 anotheroldleadsite.com 加到黑名单里。AI调用POST /export-blacklist。此后任何来自这些域名的线索都不会出现在你的导出结果中帮助你保持线索列表的清洁。7. 常见问题与排查实录在实际使用中你可能会遇到一些典型情况。以下是我根据经验总结的排查思路和解决方法。问题一搜索返回结果为零或过少。可能原因1关键词过于具体或拼写错误。排查检查关键词是否使用了正确的通配符。dentist只会匹配精确包含“dentist”的字符串而*dentist*能匹配“dentists”、“cosmetic dentist”。解决使用更宽泛的通配符并添加同义词变体。尝试使用预览功能测试不同关键词组合的效果。可能原因2筛选条件组合过于严格。排查同时应用了州、城市、更新时间、AI分类、评分等多个筛选器可能叠加出了一个非常小的交集。解决逐步放宽条件。先只用一个核心关键词和州筛选看有多少结果。然后逐步增加其他条件观察结果数的变化找到限制最多的那个条件。可能原因3选择了错误的数据库。排查你正在home_improvement数据库里搜索“软件公司”而这个库只有承包商。解决确认你的目标客户属于哪个数据库。大多数B2B销售应使用other数据库。可以通过GET /settings/database查看当前数据库并用POST /settings/switch-database切换注意有冷却时间。问题二导出的联系人信息无效空号、错号、无效邮箱。可能原因1线索新鲜度不够。分析企业注册时填写的联系方式可能不准确或已变更。时间越久信息失效概率越高。解决始终优先筛选Last Updated为最近如7天、30天的线索。这些是系统最新验证或抓取到的信息准确率最高。可能原因2目标行业特性。分析某些行业如自由职业者、咨询师可能更倾向于使用个人手机或临时邮箱变动频繁。解决结合AI分类和网站信息综合判断。一个拥有正规官网、详细业务描述、且AI分类明确的企业其公开联系方式的可靠性远高于一个单页网站。实操心得将线索验证作为销售开发流程的第一步。可以设计一个简单的自动化脚本用导出的电话号码去主流社交平台如LinkedIn搜索关联的企业主页进行二次验证这能显著提升销售触达的效率。问题三信用点消耗过快。可能原因1频繁进行宽泛搜索。分析每次搜索*service*这样宽泛的关键词可能会匹配数万条线索即使只返回前100条也会瞬间消耗100点。解决养成使用maxCredits参数的习惯。在探索阶段设为10或20。同时务必先使用GET /leads/preview查看匹配数量再决定是否进行正式查询。可能原因2重复导出已拥有的线索。分析如果不加区分地导出系统会为所有新线索扣点包括那些你可能在之前搜索中已经看到过但未导出的。解决在导出时可以设置maxCredits: 0来先免费导出所有旧线索。然后再针对新线索进行有预算的导出。或者在导出后立即将当前筛选条件保存为预设后续只导出该预设下“上次导出后”的新线索。问题四AI分类似乎不准确。可能原因企业业务描述模糊或AI模型局限。分析AI分类是基于网站内容估算的对于业务复杂或描述不清的企业分类可能有偏差。解决不要完全依赖AI分类作为唯一筛选条件。将其与关键词搜索结合使用。例如用关键词*web*design*结合AI分类[Marketing, Creative Services]比单独使用任一种方法都更精准。同时你可以将分类不准确的线索反馈给平台有助于模型迭代优化。问题五API调用返回错误或超时。可能原因1速率限制。排查SMB Sales Boost API有不同的速率限制如常规端点60次/分钟导出端点5分钟1次。频繁操作可能触发限制。解决AI技能通常会处理这些错误并给出友好提示。如果是你自己在调试smb_api.py请确保在脚本中加入了适当的延迟例如time.sleep以避免频繁调用。批量操作时尤其要注意导出功能的冷却时间。可能原因2API密钥失效或权限不足。排查密钥可能已过期、被撤销或当前订阅计划不支持某些高级功能如AI生成关键词。解决检查密钥是否有效并确认你的订阅套餐是否包含你正在尝试使用的功能。可以调用GET /me来验证密钥和套餐状态。这个技能将强大的B2B销售数据库变成了AI助手的一项“本能”。关键在于转变思维从“我如何操作这个软件”变为“我如何向我的AI伙伴描述我的理想客户”。通过精心设计的关键词、巧妙利用时间筛选和AI分类以及严格的信用点预算控制你可以构建一个高效、自动化、且持续优化的销售线索流水线。记住最好的工作流始于一次清晰的对话“帮我找到那些刚刚出现、正需要我的产品的人。”