Hunter.io 邮箱挖掘与验证集成指南:基于 marketingskills 零依赖 CLI 的 Agent 实战
AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本篇技术指南聚焦 tools/integrations/hunter.md 所定义的 Hunter.io 集成方案如何在 AI AgentClaude Code 等的工作流中通过一个零依赖、单文件的 Node.js CLItools/clis/hunter.js完成域名邮箱挖掘、单联系人邮箱查找、邮箱验证、Leads 与 Campaign 管理。读完本文你将掌握 Hunter 的 API Key 认证机制、全部 7 大类 CLI 子命令的完整参数与调用链、限流约束以及该工具在prospecting获客技能中的定位与边界。一、Hunter.io 在项目中的集成定位Hunter.io 是面向外联outreach与链接建设link building的邮箱查找与验证平台。在 tools/REGISTRY.md 的工具索引中它被归类为Email Outreach类目与 Snov、Lemlist、Instantly 并列同时在 skills/prospecting/SKILL.md 的关键获客工具表中被定位为Email pattern verification邮箱模式推断 验证的专用工具。原文档定义的集成能力矩阵如下IntegrationAvailableNotesAPI✓REST API for domain search, email finder, verificationMCP-Not availableCLI✓Zero-dependency Node.js CLISDK-API-only从这张矩阵可以得到两个关键结论Hunter 没有 MCP 服务器、也没有官方 SDK因此在本项目中与 Hunter 交互的唯一官方接入方式是 REST API 直调与配套的 CLI 封装——这正是hunter.js存在的意义。二、认证方式与 CLI 底层实现2.1 API Key 认证Hunter 的认证机制是所有操作的第一步Type: API Keyquery parameter作为查询参数附加在 URL 上Parameter:api_key{key}Env var:HUNTER_API_KEYGet key: 在 Hunter 控制台的 API 页面获取2.2 CLI 如何读取与注入密钥源码验证查看 tools/clis/hunter.js 的实现可以确认认证链路第 3 行const API_KEY process.env.HUNTER_API_KEY——CLI只从环境变量读取密钥不接收任何--api-key参数杜绝密钥硬编码进脚本第 6-9 行若环境变量缺失立即输出{error:HUNTER_API_KEY environment variable required}并以退出码 1 终止第 4 行所有请求统一指向 API 根地址https://api.hunter.io/v2第 11-13 行api()封装函数会判断路径中是否已包含?自动选择或?作为分隔符再拼接api_key...——这意味着无论 GET 还是 POST、无论路径是否已带查询参数密钥注入都是自动完成的调用方无需关心 URL 拼接细节。2.3 安装与运行方式该 CLI 属于 tools/clis/README.md 描述的零依赖、单文件、Node 18、无需 npm install系列可用三种方式运行# 方式一直接用 node 运行 node tools/clis/hunter.js domain search --domain example.com --limit 10 # 方式二软链到全局 bin 目录后直接调用 ln -sf $(pwd)/tools/clis/hunter.js ~/.local/bin/hunter hunter email find --domain example.com --first-name John --last-name Doe # 方式三把 tools/clis 目录加入 PATH export PATH$PATH:/path/to/marketingskills/tools/clis hunter account info安全建议密钥统一存放到 shell profile~/.zshrc、~/.bashrc或.env文件已被 gitignore并在 fork 仓库后审查提交记录确保无密钥泄露。三、核心操作域名邮箱挖掘3.1 搜索域名下的邮箱列表node tools/clis/hunter.js domain search --domain example.com --limit 10源码对应domain search分支tools/clis/hunter.js它构建/domain-search路径并支持以下参数参数必填说明源码处理--domain✓目标域名缺省时报错--domain required第 63-64 行--limit-返回结果数量上限通过params.set(limit, ...)注入第 66 行--type-邮箱类型过滤可取personal/generic见源码 usage 提示第 67 行3.2 统计某域名可用邮箱数量node tools/clis/hunter.js domain count --domain example.com对应源码domain count分支第 71-77 行请求/email-count端点同样支持--type过滤。该命令不消耗邮箱搜索结果配额适合在挖掘前评估目标域名的数据规模辅助判断是否值得投入搜索额度。四、核心操作定位特定联系人邮箱4.1 查找指定人员的邮箱Email Findernode tools/clis/hunter.js email find --domain example.com --first-name John --last-name Doe源码email find分支第 86-95 行对三个参数有严格校验--domain缺失 →--domain required--first-name缺失 →--first-name required--last-name缺失 →--last-name required。三者齐备后CLI 将三个值映射为 Hunter API 期望的first_name/last_name参数源码第 93 行请求/email-finder端点。这是通过姓名 域名反查邮箱的核心操作用于锁定具体决策人。4.2 验证单个邮箱地址node tools/clis/hunter.js email verify --email johnexample.com对应源码email verify分支第 97-102 行请求/email-verifier端点--email为唯一必填参数。该操作用于在发送前确认地址可达性。五、Leads 管理原文档提供了完整的 Leads 增删查操作# 列出 Leads node tools/clis/hunter.js leads list --limit 20 # 创建 Lead node tools/clis/hunter.js leads create --email johnexample.com --first-name John --last-name Doe --company Example Inc # 删除 Lead node tools/clis/hunter.js leads delete --id 12345结合源码tools/clis/hunter.js可以确认完整的参数契约子命令请求必填参数可选参数leads listGET /leads---limit、--offset分页leads getGET /leads/{id}--id-leads createPOST /leads--email--first-name、--last-name、--company分别映射为first_name/last_name/company写入请求体leads deleteDELETE /leads/{id}--id-值得注意源码还额外实现了leads get子命令原集成文档未列明用于按 ID 查询单个 Lead 详情可作为补充操作使用node tools/clis/hunter.js leads get --id 12345六、Campaign 管理Campaign 操作用于管理 Hunter 中的外联活动# 列出所有 Campaign node tools/clis/hunter.js campaigns list # 获取 Campaign 详情 node tools/clis/hunter.js campaigns get --id 12345 # 启动 / 暂停 Campaign node tools/clis/hunter.js campaigns start --id 12345 node tools/clis/hunter.js campaigns pause --id 12345源码campaigns分支第 156-187 行揭示了底层端点campaigns list请求GET /campaigns支持--limit/--offsetcampaigns get请求GET /campaigns/{id}而start/pause则分别对/campaigns/{id}/start与/campaigns/{id}/pause发起POST请求——这是典型的动作型端点设计与查询型 GET 端点形成区分。七、账户配额查询与隐藏能力7.1 查询账户用量node tools/clis/hunter.js account info对应源码account info分支第 109-112 行请求GET /account端点返回当前账户的套餐类型、已用/剩余搜索与验证配额。建议在批量操作前先执行此命令避免配额耗尽导致后续命令报错。7.2 隐藏在源码中的 leads-lists 能力从源码结构看CLI 还实现了一组原集成文档未提及的leads-lists命令第 189-207 行用于管理 Lead 分组列表# 列出所有 Lead 列表 node tools/clis/hunter.js leads-lists list [--limit n] [--offset n] # 获取某个列表详情 node tools/clis/hunter.js leads-lists get --id id它请求 Hunter 的/leads_lists端点为把 Leads 组织成可复用分组提供了额外入口适合在需要按细分市场管理联系人时使用。八、命令模式、JSON 输出与安全演练8.1 统一的命令模式与项目内全部 CLI 一致见 tools/clis/README.mdhunter.js 遵循{tool} resource action [options]结构即资源 动作 可选参数。同时所有命令的输出均为JSON 格式写入 stdout便于管道化处理# 用 jq 提取邮箱列表 node tools/clis/hunter.js domain search --domain example.com --limit 10 | jq .data.emails[].value # 保存到文件供后续脚本使用 node tools/clis/hunter.js domain search --domain example.com --limit 50 hunter-leads.json8.2 dry-run 安全演练所有命令均支持--dry-run开关。从源码第 14-16 行可见开启后api()函数不会真正发起网络请求而是返回一个描述对象包含方法、目标 URL密钥已被替换为***脱敏、请求头与请求体node tools/clis/hunter.js email verify --email johnexample.com --dry-run输出中url字段形如https://api.hunter.io/v2/email-verifier?email...api_key***可在发送真实请求前核对路径、参数拼装是否正确。8.3 错误处理机制源码第 246-248 行显示任何未捕获异常都会被捕获并输出{error: message}到 stderr 后以退出码 1 退出响应若无法解析为 JSON则回退输出{status, body}对象第 26-30 行。这意味着 Agent 可以通过检查退出码与 JSON 结构来可靠地判断命令成败。九、在 prospecting 工作流中的协同用法Hunter 不是孤立工具它在 skills/prospecting/SKILL.md 的获客流程中与多个工具协同先用 Apollo / Clay 等构建企业画像再用 Hunter 按域名与姓名推断联系人邮箱并做轻量验证最终将验证通过的联系人送入 cold-email 外联序列。skills/prospecting/references/data-sources.md 对 Hunter 给出了清晰的边界说明直接引用如下要点适用场景小批量名单的邮箱模式发现 轻量验证优势基于域名的邮箱发现、内置投递性验证、免费额度适合偶发使用注意Hunter 本质是模式猜测工具准确度取决于目标公司的邮箱命名模式是否可推断重要警示无论 Hunter 结果如何发送前都应经过专用验证器如 Truelist二次校验——外联信誉在退信率超过 2% 时会严重受损而 Hunter 类数据准确率通常在 60%–80% 区间存在约 20%–40% 的验证缺口。建议的实操流水线结合本文 CLI 命令# 1. 评估目标域名的邮箱存量 node tools/clis/hunter.js domain count --domain example.com # 2. 挖掘该域邮箱限定个人邮箱 node tools/clis/hunter.js domain search --domain example.com --type personal --limit 20 # 3. 对重点联系人反向锁定邮箱 node tools/clis/hunter.js email find --domain example.com --first-name Jane --last-name Smith # 4. 逐个验证关键联系人 node tools/clis/hunter.js email verify --email jane.smithexample.com # 5. 沉淀为 Leads node tools/clis/hunter.js leads create --email jane.smithexample.com --first-name Jane --last-name Smith --company Example Inc十、速率限制Rate Limits原文档明确的限流约束是规划批量任务的硬性前提免费套餐每月 25 次搜索、50 次验证付费套餐配额随等级提升API 速率10 请求/秒。结合上述约束批量任务应做三件事先执行account info摸清配额余量、控制--limit避免单次拉取过大、并通过人工节流如脚本内 sleep保证每秒不超过 10 次请求。十一、典型应用场景Use Cases原文档给出的三大场景构成了本文全部命令的落地背景Link building链接建设为目标域名挖掘联系人邮箱用于外联获取外链——对应domain search、email findProspecting获客从公司域名批量构建潜在客户名单——对应leads create、leads listVerification验证在发送 Campaign 前清洗邮箱列表降低退信率——对应email verify。十二、集成速查与延伸阅读事项位置Hunter 集成文档本文主题tools/integrations/hunter.mdhunter CLI 完整源码tools/clis/hunter.js全部营销 CLI 的安装/认证/安全规范tools/clis/README.md工具注册表含 Hunter 索引行tools/REGISTRY.mdprospecting 技能中的工具定位skills/prospecting/SKILL.mdHunter/Snov 数据源对比与验证边界skills/prospecting/references/data-sources.md总结Hunter.io 在 marketingskills 中的接入完全围绕hunter.js这一零依赖 CLI 展开。其 API Key 环境变量认证、resource/action命令结构、JSON 输出与--dry-run演练机制使其天然适配 Agent 的脚本化调用结合 prospecting 技能中的先挖掘、再验证、后外联的流程约束即可构成一条完整、可审计的外联数据管线。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐marketingskills 项目中的 Snov.io 集成用零依赖 Node.js CLI 实现邮箱挖掘、验证与邮件序列外联marketingskills 项目中的 Snov.io 集成用零依赖 Node.js CLI 实现邮箱挖掘、验证与邮件序列外联 本文以 Snov.io 集成AI 技能人工智能深入解析 go-ircgopkg.in/irc.v3极简 IRC 消息解析库与 Go 客户端构建实战深入解析 go ircgopkg.in/irc.v3极简 IRC 消息解析库与 Go 客户端构建实战 本文基于 scan4all 仓库中 vendor 的AI 技能人工智能SendGrid 邮件平台集成实战指南marketingskills 中的 API 操作、Webhook 事件与零依赖 Agent CLISendGrid 邮件平台集成实战指南marketingskills 中的 API 操作、Webhook 事件与零依赖 Agent CLI 本篇技术指南围绕AI 技能人工智能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

酒店床品褶皱总修不干净?GPTImage 一键去褶皱实测,30 秒床单秒平

酒店床品褶皱总修不干净?GPTImage 一键去褶皱实测,30 秒床单秒平

民宿酒店房间照,床单稍有褶皱,整张图就显廉价。客人划 OTA 的时候,手指停不停就看这一眼。以前修褶皱要么污点修复慢慢刷,要么重拍,两种都费时间。 这次实测 51psai 的 床品去褶皱,走的是提示词模板&#…

2026/10/3 7:30:01 阅读更多 →
水浸超声检测设备哪家好?C扫描系统的技术要点

水浸超声检测设备哪家好?C扫描系统的技术要点

水浸超声检测把工件和探头浸在水中,以水作为耦合介质,通过多轴机械扫查生成C扫描图像。它耦合稳定、可使用聚焦探头、易于自动化,是航空锻件、复合材料、焊接组件批量检测的主流方法。水浸超声检测设备哪家好?先看系统由哪些部分组成,再比较厂商。一、机械扫查系统通常为三轴到…

2026/10/4 7:33:24 阅读更多 →
GESP2026年9月认证C++一级( 第三部分编程题(1、新龟兔赛跑))精讲

GESP2026年9月认证C++一级( 第三部分编程题(1、新龟兔赛跑))精讲

一、先听懂故事:新龟兔赛跑 🐢🐇很久很久以前……兔子和乌龟进行了一场赛跑。以前兔子因为骄傲自满,比赛的时候睡觉,输给了乌龟。这一次兔子吸取了教训:“这次我绝对不睡觉!”所以:&…

2026/10/4 7:34:41 阅读更多 →

最新新闻

Codex从代码生成模型到智能体的演进与工程实践全攻略

Codex从代码生成模型到智能体的演进与工程实践全攻略

聊到 Codex,很多人还停留在“它是当年 GitHub Copilot 背后的代码生成模型”这个印象里。但今天再聊 Codex,语境已经变了——它正在从“生成代码的大模型”演进成“真正能接手软件工程任务的智能体”。这个变化直接决定了一件事:我们使用 AI …

2026/10/4 10:39:18 阅读更多 →
MOOS-ivp实验指南:从安装到运行的完整实践

MOOS-ivp实验指南:从安装到运行的完整实践

MOOS-ivp是水下机器人、无人船领域绕不开的一套开源软件架构,很多学校和研究机构的“自主水下航行器”课程第一节课就是装它。我当年拿到“MOOS-ivp 实验一 MOOS软件的安装与执行”这个任务时,以为就是跑个安装脚本就完事,结果被编译依赖、环…

2026/10/4 10:39:18 阅读更多 →
AI Agent Harness Engineering 用户体验设计:从意图识别到交互闭环,让智能体更懂用户

AI Agent Harness Engineering 用户体验设计:从意图识别到交互闭环,让智能体更懂用户

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 10:39:17 阅读更多 →
ENVI遥感水质反演全流程:从模型原理到工程实践

ENVI遥感水质反演全流程:从模型原理到工程实践

1. 项目背景与目标:为什么要用ENVI做水质反演干遥感这行的,十有八九都会碰到水质反演这个需求。不管你是做环保监测、水利普查,还是搞农业面源污染评估,领导一拍脑袋说要看看某个湖、某条河的整体水质状况,你总不能雇条…

2026/10/4 10:39:17 阅读更多 →
OpenClaw Telegram 通道实战指南:Bot API 接入、群组策略、草稿流式输出与 webhook 部署

OpenClaw Telegram 通道实战指南:Bot API 接入、群组策略、草稿流式输出与 webhook 部署

人工智能AI Agent即时通讯后端本地部署语音 【免费下载链接】openclaw-cn 中文社区版OpenClaw,同原版保持定期更新,已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。🦞 项目地址&am…

2026/10/4 10:38:17 阅读更多 →
OpenShell:跨平台终端体验重构框架,统一Linux/macOS/Windows/WSL开发工作流

OpenShell:跨平台终端体验重构框架,统一Linux/macOS/Windows/WSL开发工作流

1. OpenShell 是什么?它不是 Shell,而是一套跨平台终端体验重构方案OpenShell 这个名字乍一听容易让人联想到“开源的 Shell”,比如 bash、zsh 或 fish——但实际完全不是一回事。它既不是 Linux 的 shell 解释器,也不是 macOS 的…

2026/10/4 10:38:17 阅读更多 →

日新闻

KT148A语音芯片外挂8002D功放的工程实践指南

KT148A语音芯片外挂8002D功放的工程实践指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →
LLC谐振变换器增益公式推导:从FHA等效到完整归一化表达式

LLC谐振变换器增益公式推导:从FHA等效到完整归一化表达式

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →
ARM架构深度解析:从RISC设计理念到交叉编译实战

ARM架构深度解析:从RISC设计理念到交叉编译实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →

周新闻

KT148A语音芯片外挂8002D功放的工程实践指南

KT148A语音芯片外挂8002D功放的工程实践指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →
LLC谐振变换器增益公式推导:从FHA等效到完整归一化表达式

LLC谐振变换器增益公式推导:从FHA等效到完整归一化表达式

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →
ARM架构深度解析:从RISC设计理念到交叉编译实战

ARM架构深度解析:从RISC设计理念到交叉编译实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 1:00:58 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/2 10:36:31 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/4 9:43:54 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/3 9:42:36 阅读更多 →