---
name: ravn
description: Use Ravn from Claude or the terminal to validate emails, find work emails, enrich CSVs, and look up companies, phones and people.
title: Ravn Core Skill for Claude — Ravn
---

# Ravn

Run `npx ravn <tool> --flag value` (key from `ravn login` or RAVN_API_KEY). Output is JSON when piped.

- First: `npx ravn whoami` (free) to see plan, lookups used this month and the monthly spending cap.
- List tools: `npx ravn tools`. Every tool takes its input fields as flags, e.g.
  `npx ravn validate_email --email jane@acme.com`,
  `npx ravn search_business_email_by_name --name "Jane Doe" --company acme.com`,
  `npx ravn scrape_website --domain acme.com`.
- CSVs: always `--dry-run` first, then `--limit 10` as a sample, then the full run:
  `npx ravn enrich leads.csv --tool search_business_email_by_name --map name=Name,company=Domain --out enriched.csv`.
- Branch on `status` ("ok" or "not_found"). A miss is free. Errors carry `error.code`.
- Before sending to any list, run `validate_emails` and drop invalid and risky addresses. Never contact anyone who asked not to be contacted.