veille

Veille for Hermes Agent

Gives Hermes Agent tools to check emails, domains, IPs, phone numbers, VAT numbers and IBANs for fraud and validity, through the Veille API.

Install

hermes plugins install veille

Hermes asks for VEILLE_API_KEY during the install. Create a key in the Veille dashboard.

Tools

| Tool | What it does |
|---|---|
| veille_check_email | Check an email address before accepting it: syntax, MX and SPF/DMARC records, disposable or temporary provider, role account, alias, typo suggestion and a 0-100 risk score. |
| veille_check_domain | Check a domain: MX records and mail provider, disposable or temporary domain, age and risk signals. |
| veille_check_ip | Check an IP address: country, network owner, and whether it is a VPN, proxy, Tor exit node or data center. |
| veille_check_phone | Check a phone number: validity, country, line type and carrier. |
| veille_check_vat | Validate a European VAT number and return the registered company name and address. |
| veille_check_iban | Validate an IBAN and return its country and bank details. |

The tools are hidden from the model until the API key is set.

What it does on your machine

• Network: calls https://api.veille.io only, with your VEILLE_API_KEY. Calls can use credits on your Veille account (pricing).
• Credentials: reads the key only through Hermes's secret scope. It stores nothing.
• Nothing else: no files written, no processes started, no telemetry, no self-update. Standard library only, no dependencies.

Development

python -m pytest

The tests mock the network and run without Hermes installed.

Contact

• Source: https://github.com/veilleio/hermes-plugin-veille
• Veille: https://www.veille.io
• Issues: https://github.com/veilleio/hermes-plugin-veille/issues

License

MIT

README from the reviewed commit cac7ce6; it updates when the author re-pins.