ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

使用 Hunter Automation Skill 在 Codex 中落地 Hunter.io 邮件智能自动化全指南

使用 Hunter Automation Skill 在 Codex 中落地 Hunter.io 邮件智能自动化全指南 使用 Hunter Automation Skill 在 Codex 中落地 Hunter.io 邮件智能自动化全指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本指南以开源仓库 awesome-codex-skills 中的 Hunter Automation Skill 为骨架讲解如何通过自然语言驱动 Hunter.io 完成域名邮箱发现、特定联系人邮箱推断、投递性验证、邮箱数量预估、线索保存与账户配额监控六大核心任务。读完本文你将掌握该 Skill 的全部工具参数、调用方式与实战注意事项能够在 Codex CLI/API 环境中用一句话完成原本需要多步 API 调用的邮件外呼准备流程。一、Skill 定位给 Codex 装上 Hunter.io 的邮件情报能力Hunter Automation 是 awesome-codex-skills 仓库composio-skills/目录下的技能之一其元数据SKILL.md 的 YAML frontmatter定义如下name:Hunter Automationdescription: 通过 Composio MCP 集成以自然语言自动化 Hunter.io 邮件情报工作——按域名搜索邮箱、查找特定联系人、验证邮件可投递性、管理线索、监控账户用量category:email-intelligence邮件情报requires.mcp:rube从分类与依赖声明可以看出这个 Skill 本身不内置任何 Hunter 相关代码它的价值在于把何时触发、调用哪些工具、参数怎么填、踩过哪些坑沉淀成结构化的指令让 Codex 在遇到邮件情报类任务时自动按最优路径执行。仓库 README 对此的定位是Skills tell your agenthowto work. An MCP Gateway gives it secure access to the tools it needs.技能告诉 Agent怎么做MCP 网关为它提供安全访问所需工具的通道Hunter Automation 正是这一理念在email-intelligence类别下的具体落地。底层工具通过 Composio 的 Rube MCP 网关暴露工具以HUNTER_*前缀命名共 6 个。下表是全篇的索引Action动作Tool Slug工具名Required Params必填参数搜索域名邮箱HUNTER_DOMAIN_SEARCHdomain或company查找某人邮箱HUNTER_EMAIL_FINDER姓名 domain或company验证邮箱HUNTER_EMAIL_VERIFIERemail获取邮箱数量HUNTER_EMAIL_COUNTdomain或company保存/更新线索HUNTER_UPSERT_LEADemail查看账户信息HUNTER_ACCOUNT_INFORMATION无二、环境准备三步接通 Rube MCP 与 Hunter.io根据 SKILL.md 的 Setup 章节接通环境只需三步第一步添加 Composio MCP 服务器。在客户端Codex CLI / API的 MCP 配置中加入端点https://rube.app/mcp第二步连接 Hunter.io 账号。按提示完成 Hunter.io 账户的 OAuth/API Key 认证授权。仓库中同目录的其他 Skill如 slackbot-automation/SKILL.md展示了 Rube MCP 的连接管理模式通过RUBE_MANAGE_CONNECTIONS工具检查连接状态若连接未处于ACTIVE则跟随返回的授权链接完成配置确认状态变为 ACTIVE 后再运行工作流。Hunter 场景下即确保存在一个 toolkit 为 Hunter、状态 ACTIVE 的连接。第三步用自然语言下达指令。例如直接说Find all executive email addresses at stripe.com using HunterCodex 会依据 frontmatter 中的description自动触发本 Skill并调用对应HUNTER_*工具。参考仓库内其他 Skill 的通用实践slackbot-automation/SKILL.mdRube MCP 的推荐执行模式是先用RUBE_SEARCH_TOOLS以 use_case 检索获取最新工具 schema 与执行建议再确认连接 ACTIVE最后通过RUBE_MULTI_EXECUTE_TOOL携带tool_slug、schema 合规的arguments、memory与session_id执行具体工具。工具 schema 会随版本变化不要硬编码参数结构每次执行前先做一次工具发现是最稳妥的做法。三、核心工作流详解六合一以下六个工作流完整继承自 SKILL.md并补充了参数语义与组合用法。3.1 按域名搜索邮箱HUNTER_DOMAIN_SEARCH发现某个域名或公司所有公开可获取的邮箱地址支持按部门、职级、邮箱类型过滤。示例提示词Find all executive email addresses at stripe.com using Hunter关键参数参数说明约束/默认值domain待搜索的域名如stripe.com与company二选一必填company公司名称如Stripe与domain二选一必填type邮箱类型过滤personal个人或generic通用如 infoseniority职级过滤数组junior、senior、executivedepartment部门过滤数组executive、it、finance、sales等required_field要求结果必须携带的字段数组full_name、position、phone_numberlimit单次请求最大返回数1–100默认 10免费/基础套餐上限 10offset分页偏移量默认 0实战要点department与seniority均为数组类型一次可传多个值如同时要 executive finance 两个部门分页由limit/offset控制见 4.3 节坑点批量抓取时要循环翻页直到结果为空或达到上限免费/基础套餐单次最多返回 10 条如需更大结果集需付费套餐见 4.6 节。3.2 查找特定联系人的邮箱HUNTER_EMAIL_FINDER给定姓名 域名/公司推断该人最可能使用的邮箱地址Hunter 的 Email Finder 能力。示例提示词Find the email for Alexis Ohanian at reddit.com using Hunter关键参数参数说明约束/默认值domain目标域名如reddit.com优先于companycompany公司名如Reddit未提供domain时使用first_namelast_name名 姓如AlexisOhanian与full_name二选一full_name全名如Alexis Ohanian与 first/last name 二选一max_duration最大请求时长秒3–20默认 10时长越长结果越准实战要点姓名参数三选一组合必须提供其一first_name last_name或full_namemax_duration是精度-延迟的权衡旋钮Hunter 会花更长时间从多个来源交叉验证建议在可接受延迟内尽量调高例如批量外呼前的关键决策人定位可以设到上限 20 秒。3.3 验证邮箱可投递性HUNTER_EMAIL_VERIFIER检查某个邮箱是否有效、可投递、适合发送。示例提示词Verify if john.doeexample.com is a valid email address关键参数email必填——待验证的邮箱地址如john.doeexample.com。响应内容包含验证状态verification status、可投递性评分deliverability score、MX 记录校验结果MX record validation、风险评级risk assessment。实战要点该工具是外呼前的质检关卡建议在HUNTER_DOMAIN_SEARCH/HUNTER_EMAIL_FINDER拿到候选邮箱后逐条调用对验证状态的语义解读要谨慎accept_all与risky状态代表不确定性严格投递性工作流中应剔除或单独处理见 4.5 节。3.4 获取邮箱数量预估HUNTER_EMAIL_COUNT查询 Hunter 数据库中某个域名/公司拥有的邮箱数量。该调用免费不消耗 API 额度。示例提示词How many email addresses does Hunter have for stripe.com?关键参数参数说明约束/默认值domain查询域名如stripe.com与company二选一必填company公司名与domain二选一必填至少 3 个字符type按类型统计personal或generic返回内容总数以及按类型type、部门department、职级seniority维度的细分统计。实战要点由于免费且不扣额度非常适合在投入真实搜索配额之前做市场容量侦察先用它评估目标域名/公司的数据丰度再决定是否投入付费的搜索配额返回的是估算值而非保证可获取的数量见 4.2 节坑点。3.5 保存与更新线索HUNTER_UPSERT_LEAD以邮箱为主键单次 upsert 调用即可创建或更新线索无需先查询是否存在。示例提示词Save johnstripe.com as a lead in Hunter with name John Doe, position CTO关键参数参数说明约束/默认值email线索邮箱upsert 主标识必填姓名/职位/公司等线索元数据name、position、company 等可选按需提供实战要点upsert 语义意味着同一email重复提交会更新而非报错适合在流水线中幂等地沉淀线索——发现一个、验证一个、落库一个无需额外的存在性检查建议与 3.1/3.2 组合成发现 → 验证 → 入库的完整链路。3.6 检查账户用量与配额HUNTER_ACCOUNT_INFORMATION查看 Hunter 账户的套餐详情、剩余搜索次数与验证配额。示例提示词How many Hunter API searches do I have left this month?关键参数无该工具不需要任何参数。实战要点批量操作前先调用它确认配额充足避免大批量任务跑到一半撞上配额上限与 3.4 的免费计数配合可以设计出先看免费容量、再查剩余配额、最后决定搜索规模的节流式工作流。四、已知坑点来自 Skill 作者的经验清单SKILL.md 沉淀了 7 条实战坑点逐一展开如下HTTP 401 凭据无效出现authentication_failed错误说明 API Key 无效或已过期。务必先修复凭据再执行批量操作否则整批任务都会以同样的 401 失败浪费配额与时间。邮箱数量是估算值HUNTER_EMAIL_COUNT返回的是用于容量评估与优先级排序的近似数字不是保证可检索到的真实邮箱数量。用它判断值不值得挖不要把它当成功率承诺。域名搜索使用 offset 分页HUNTER_DOMAIN_SEARCH通过limit/offset翻页不能假设第一页就是全部结果。要持续翻页直到返回结果为空或达到上限否则会漏掉数据。空结果不是错误HUNTER_DOMAIN_SEARCH可能返回emails: []且不带任何错误码。这应解读为无数据继续流程即可不要把它当作失败反复重试——重试只会浪费配额。验证状态的细微差别HUNTER_EMAIL_VERIFIER返回的accept_all接受所有邮件或risky有风险状态代表不确定性。严格的可投递性工作流应排除这两类或为它们设计单独的处理分支。免费/基础套餐限制免费与基础套餐将HUNTER_DOMAIN_SEARCH限制为每次请求最多 10 条结果。需要更高上限必须升级付费套餐。域名格式很重要必须使用裸域名如stripe.com不要带协议头https://或www.前缀否则查询会失败或返回空结果。五、组合实战一条完整的邮件外呼准备管线将上述六个工作流按业务顺序串联可以形成一条可复制的外呼准备管线容量侦察免费HUNTER_EMAIL_COUNT评估目标公司数据丰度决定是否值得投入配额体检零成本HUNTER_ACCOUNT_INFORMATION确认剩余搜索次数与验证配额邮箱发现HUNTER_DOMAIN_SEARCH按部门/职级过滤抓取目标邮箱记得limit/offset翻页、处理空结果精准补位对少数关键决策人用HUNTER_EMAIL_FINDER调高max_duration提升准确率定向推断投递性验证HUNTER_EMAIL_VERIFIER逐条过滤剔除accept_all/risky与无效地址线索落库HUNTER_UPSERT_LEAD将验证通过的邮箱幂等写入线索库供后续外呼系统使用。每一步之间都可以用自然语言触发整个链路无需手写任何 Hunter API 调用代码。六、将 Skill 安装到 Codexhunter-automation 与仓库内其他 Skill 一样安装到 Codex 的$CODEX_HOME/skills默认~/.codex/skills后即可在会话中按描述自动触发。参考 README.md 与 skill-installer/SKILL.md 提供的两种方式方式一使用 Skill Installer 脚本推荐git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/hunter-automation安装脚本会将 Skill 放入$CODEX_HOME/skills/hunter-automation默认安装到~/.codex/skills可通过--dest覆盖目标目录、--ref指定分支。脚本在目标目录已存在时会中止避免覆盖。方式二手动安装将 composio-skills/hunter-automation 目录整体复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 使其加载新的 frontmatter 元数据在会话中自然描述任务如用 Hunter 找一下 stripe.com 的销售部门邮箱Codex 会根据description字段自动匹配并触发本 Skill。验证安装ls ~/.codex/skills查看目录、head ~/.codex/skills/hunter-automation/SKILL.md查看元数据是否就绪。安装/更新 Skill 后务必重启 Codex 才能生效。七、结语Hunter Automation 是指令即能力设计的典型样本Skill 本身不含一行业务代码却把 Hunter.io 六个核心 API 的调用姿势、参数边界与经验坑点完整编码进了一套自然语言接口。配合 Rube MCP 网关的连接管理开发者可以在 Codex 中零代码完成从域名发现、定向查找、投递性验证到线索入库的完整邮件情报链路。理解本 Skill 的六个工具与其组合方式也就掌握了用 Codex Skills 封装任意 SaaS API 的方法论——这正是 awesome-codex-skills 仓库希望传递的实践模式。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表