id: hunter
name: Hunter.io
version: 1.0.0
description: "Hunter.io (API v2) — email OSINT: find the email addresses tied to a domain, find a specific person's email, verify an email's deliverability, and read account usage. API-key authentication; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: domain search, email finder, email verifier, account."
category: enrichment

# Per-instance configuration. The API key is sent as the 'api_key' query parameter.
config_schema:
  properties:
    api_key:
      type: string
      description: "Hunter.io API key"
      x-soar-sensitive: true
  required:
    - api_key

commands:
  - id: domain_search
    name: hunter-domain-search
    description: "Find email addresses associated with a domain."
    risk: read
    inputs_schema:
      properties:
        domain: { type: string, description: "Domain name (e.g. example.com)" }
        limit: { type: number, description: "Max results (default 10)" }
      required: [domain]
    outputs_schema: { properties: {} }
  - id: email_finder
    name: hunter-email-finder
    description: "Find the most likely email address for a person at a domain."
    risk: read
    inputs_schema:
      properties:
        domain: { type: string, description: "Domain name" }
        first_name: { type: string, description: "First name" }
        last_name: { type: string, description: "Last name" }
      required: [domain, first_name, last_name]
    outputs_schema: { properties: {} }
  - id: email_verifier
    name: hunter-email-verifier
    description: "Verify an email address's deliverability."
    risk: read
    inputs_schema:
      properties:
        email: { type: string, description: "Email address to verify" }
      required: [email]
    outputs_schema: { properties: {} }
  - id: account
    name: hunter-account
    description: "Get account information and remaining request quota."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }

  - id: test_connection
    name: hunter-test-connection
    description: "Verify the API key (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }
