Agent skill

Email Finder Hunter

by gooseworks-ai in gooseworks-ai/goose-skills

Email finder and verifier - find emails, verify deliverability, discover companies

MITAuto-check passedBackend & APIs

Install Email Finder Hunter

skills CLI
$ npx skills add gooseworks-ai/goose-skills --skill email-finder-hunter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gooseworks-ai/goose-skills email-finder-hunter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gooseworks-ai/goose-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/lead-generation/capabilities/email-finder-hunter .claude/skills/email-finder-hunter && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
email-finder-hunter
GitHub stars
1.2k
Used in
1 other repo
Token cost
~1.7k tokens
SKILL.md length
517 words
Files
2
Skills in repo
273
Repo updated
First seen
Licence
MIT

At a glance

Email finder and verifier - find emails, verify deliverability, discover companies

  • Works in 5 steps: Sales Outreach: Find verified emails at… → Lead Generation: Build email lists by… → Email Validation: Clean lists before… → …
  • Tasks that involve Transactional email
  • SKILL.md covers Setup, Capabilities, Usage and Use Cases, plus 1 more section
  • Calls curl, python3 and npx; reaches api.gooseworks.ai; needs GOOSEWORKS_API_KEY

What it does

Email Finder Hunter is an agent skill from gooseworks-ai/goose-skills. Email finder and verifier - find emails, verify deliverability, discover companies

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.meta.json`).

It sits in Backend & APIs, covering Transactional email. The repository describes itself as: Library of Growth & GTM skills + data APIs for Claude Code, Codex, Cursor to run ads, social, content, lead gen, seo and data scraping. The licence is MIT.

When your agent uses it

  • Tasks that involve Transactional email

Example prompts

  • “/email-finder-hunter”

Requirements

  • Python 3
  • Node.js
  • A credential in GOOSEWORKS_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Sales Outreach: Find verified emails at target companies
  2. Lead Generation: Build email lists by domain
  3. Email Validation: Clean lists before campaigns
  4. Company Research: Find companies matching criteria
  5. Contact Enrichment: Get full profiles from emails

What it can do on your machine

Read from SKILL.md and the folder at commit c650c6d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.gooseworks.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOSEWORKS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Email Finder Hunter loads about 1.7k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 517 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gooseworks-ai/goose-skills at commit c650c6d, republished under its MIT licence (© gooseworks-ai). 517 words, ~1,743 tokens.

Download SKILL.mdSave it as .claude/skills/email-finder-hunter/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
email-finder-hunter
description
Email finder and verifier - find emails, verify deliverability, discover companies
source
orthogonal

Hunter - Email Intelligence

Setup

Read your credentials from ~/.gooseworks/credentials.json:

bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Find email addresses, verify deliverability, and discover companies.

Capabilities

  • Combined Enrichment: Get both person AND company information from an email address in a single request
  • Email Enrichment: Get detailed person information from an email address - name, location, employment, social profiles
  • Email Count: Get count of email addresses we have for a domain, broken down by department and seniority
  • Discover Companies: Find companies matching criteria using filters or natural language
  • Company Enrichment: Get detailed company information from a domain - industry, description, location, size, tech stack, funding
  • Domain Search: Find all email addresses for a domain
  • Email Finder: Find the most likely email address for a person given their name and company domain
  • Email Verifier: Verify if an email address is deliverable

Usage

Combined Enrichment

Get both person AND company information from an email address in a single request.

Parameters:

  • email* (string) - Email address to enrich
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/combined/find","query":{"email":"jane@company.com"}}'
Email Enrichment

Get detailed person information from an email address - name, location, employment, social profiles.

Parameters:

  • email (string) - Email address to enrich
  • linkedin_handle (string) - LinkedIn handle to enrich
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/people/find","query":{"email":"john@company.com"}}'
Email Count

Get count of email addresses we have for a domain, broken down by department and seniority. FREE endpoint.

Parameters:

  • domain (string) - Domain to count emails for
  • company (string) - Company name (domain preferred)
  • type (string) - Filter: personal or generic
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-count","query":{"domain":"google.com"}}'
Discover Companies

Find companies matching criteria using filters or natural language. Returns up to 100 companies per request. FREE endpoint.

Parameters:

  • query (string) - Natural language search (e.g. Companies in Europe in Tech)
  • headquarters_location (object) - Filter by HQ location
  • industry (object) - Filter by industry
  • headcount (array) - Filter by employee count ranges
  • limit (integer) - Max results (default 100)
  • offset (integer) - Skip N results for pagination
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/discover","body":{"query":"AI startups in San Francisco"}}'
Show full SKILL.md (211 more words)Show less
Company Enrichment

Get detailed company information from a domain - industry, description, location, size, tech stack, funding.

Parameters:

  • domain* (string) - Company domain to enrich (e.g. hunter.io)
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/companies/find","query":{"domain":"anthropic.com"}}'

Find all email addresses for a domain. Returns emails with sources, confidence scores, and verification status.

Parameters:

  • domain* (string) - Domain to search (e.g. stripe.com)
  • limit (integer) - Max emails to return (default 10)
  • offset (integer) - Skip N emails
  • type (string) - Filter: personal or generic
  • seniority (string) - Filter: junior, senior, or executive
  • department (string) - Filter by department (sales, marketing, etc)
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/domain-search","query":{"domain":"stripe.com"}}'
Email Finder

Find the most likely email address for a person given their name and company domain.

Parameters:

  • domain (string) - Company domain (e.g. reddit.com)
  • company (string) - Company name (domain preferred)
  • first_name (string) - Person first name
  • last_name (string) - Person last name
  • full_name (string) - Full name (if first/last not available)
  • linkedin_handle (string) - LinkedIn profile handle
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-finder","query":{"domain":"openai.com","first_name":"Sam","last_name":"Altman"}}'
Email Verifier

Verify if an email address is deliverable. Returns status (valid, invalid, accept_all, webmail, disposable, unknown).

Parameters:

  • email* (string) - Email address to verify
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-verifier","query":{"email":"john@example.com"}}'

Use Cases

  1. Sales Outreach: Find verified emails at target companies
  2. Lead Generation: Build email lists by domain
  3. Email Validation: Clean lists before campaigns
  4. Company Research: Find companies matching criteria
  5. Contact Enrichment: Get full profiles from emails

Discover More

For full endpoint details and parameters:

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"hunter API endpoints"}' List all endpoints
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/combined/find"}'   # Get endpoint details

© gooseworks-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/lead-generation/capabilities/email-finder-hunter of gooseworks-ai/goose-skills.

  • SKILL.md
  • skill.meta.json

Open the folder on GitHubat commit c650c6d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gooseworks-ai/goose-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Email Finder Hunter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Email Finder Hunter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Email Finder Hunter this skillgooseworks-ai/goose-skills1.2k1 repos~1.7kAutomated safety check: PassMIT
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
WooCommerce Email Editor Developmentwoocommerce/woocommerce11k—~893Automated safety check: PassCustom licence
Email Best Practicesviclafouch/meme-studio1107 repos~787Automated safety check: PassNone
React Emailviclafouch/meme-studio1102 repos~3.6kAutomated safety check: PassMIT
Pinme Emailglitternetwork/pinme3.8k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes
  • Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.

    11k GitHub stars~893 tokensUpdated today
    Backend & APIsAuto-check passed
  • Email Best Practices

    viclafouch/meme-studio

    A skill your agent uses when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM…

    110 GitHub starsUsed in 7 repos~787 tokens
    Backend & APIsAuto-check passed
  • React Email

    viclafouch/meme-studio

    A skill your agent uses when creating HTML email templates with React components - welcome emails, password resets, notifications, order confirmations, newsletters, or transactional emails.

    110 GitHub starsUsed in 2 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Pinme Email

    glitternetwork/pinme

    A skill your agent uses when a PinMe project (Worker TypeScript) needs to integrate email sending (sendemail).

    3.8k GitHub stars~1.2k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Email Deliverability Audit

    growthenginenowoslawski/coldoutboundskills

    Diagnostic audit for a running cold email program. An agent skill from growthenginenowoslawski/coldoutboundskills.

    753 GitHub stars~3.4k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

More from gooseworks-ai/goose-skills

All 273 skills in this repo
  • Reddit Post Finder

    gooseworks-ai/goose-skills

    Scrape and search Reddit posts using Apify. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Create Image Fal

    gooseworks-ai/goose-skills

    Generate or edit an image via any FAL image model (nano-banana edit, gpt-image, flux, ...), ROUTED THROUGH THE fal-proxy so it bills the Ads agent.

    1.2k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Render Hook Replacement

    gooseworks-ai/goose-skills

    Replace an existing video's opening with a supplied clip or free kinetic text hook while retaining and verifying every original body frame, audio, captions and ending.

    1.2k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Blog Feed Monitor

    gooseworks-ai/goose-skills

    Scrape blog posts via RSS feeds (free, no API key) with Apify fallback for JS-heavy sites.

    1.2k GitHub starsUsed in 1 repo~578 tokens
    Auto-check passed
  • Competitor Post Engagers

    gooseworks-ai/goose-skills

    Find leads by scraping engagers from a competitor's top LinkedIn posts.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Render Chatgpt Chat

    gooseworks-ai/goose-skills

    Assemble a ChatGPT chat-reveal video ad from a thread + timeline JSON — one continuous Playwright recording of a ChatGPT mobile chat (user types with the iOS keyboard up → taps send → keyboard…

    1.2k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Email Finder Hunter

What does Email Finder Hunter do?

Email finder and verifier - find emails, verify deliverability, discover companies. Email Finder Hunter is an agent skill from gooseworks-ai/goose-skills.

When should I use Email Finder Hunter?

Email Finder Hunter fits situations like: tasks that involve Transactional email.

How do I install Email Finder Hunter in Claude Code?

Run `npx skills add gooseworks-ai/goose-skills --skill email-finder-hunter -a claude-code`. Or copy the skill folder (skills/lead-generation/capabilities/email-finder-hunter in gooseworks-ai/goose-skills) into .claude/skills/email-finder-hunter in your project. Claude Code loads it when a task matches its description.

How do I install Email Finder Hunter in Codex?

Run `npx skills add gooseworks-ai/goose-skills --skill email-finder-hunter -a codex`. Or copy the skill folder (skills/lead-generation/capabilities/email-finder-hunter in gooseworks-ai/goose-skills) into .agents/skills/email-finder-hunter in your project. Codex loads it when a task matches its description.

Can I use Email Finder Hunter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gooseworks-ai/goose-skills --skill email-finder-hunter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/email-finder-hunter, .gemini/skills/email-finder-hunter, .github/skills/email-finder-hunter and .opencode/skills/email-finder-hunter in your project.

What does Email Finder Hunter need to run?

Going by SKILL.md and its folder, Email Finder Hunter needs the command-line tools its instructions call (curl, python3 and npx) and credentials named GOOSEWORKS_API_KEY. Our summary lists: Python 3; Node.js; A credential in GOOSEWORKS_API_KEY.

Does Email Finder Hunter access the network?

SKILL.md names 1 domain. In commands or code: api.gooseworks.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Email Finder Hunter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Email Finder Hunter use?

Email Finder Hunter is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Email Finder Hunter use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Email Finder Hunter?

Skills that share tags, products or a category with Email Finder Hunter: Stripe Projects (fossasia/eventyay, 1.7k stars), WooCommerce Email Editor Development (woocommerce/woocommerce, 11k stars), Email Best Practices (viclafouch/meme-studio, 110 stars) and React Email (viclafouch/meme-studio, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Email Finder Hunter?

gooseworks-ai (a GitHub organization) maintains it in gooseworks-ai/goose-skills, which has 1,240 GitHub stars. The repository holds 273 skills in this directory. The repository was last updated on October 8, 2026.

Source: gooseworks-ai/goose-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.