enrich

Find and enrich companies and people from the command line, built to be driven by an agent (Claude, Codex, and others). JSON to stdout, structured errors to stderr; credits metered per record returned (no results, no charge).

npm install -g @tofuhq/enrich && enrich guide

enrich guide prints the full playbook. First steps:

enrich signup <email>                     # sign in (free), then: enrich verify <code>
enrich credits                            # your plan, balance, renewal (free)
enrich company identify stripe.com        # resolve a company (free)
enrich company get stripe.com --fields headcount,funding
enrich company search --where 'country in US' --where 'employees < 1000' --sort employee_growth_12m:desc

Commands

| | | |---|---| | signup <email> / verify <code> | create an account and sign in (free) | | company get <keys…> / person get <keys…> | enrich by domain / LinkedIn URL / email | | company search / person search | find by criteria: --where 'field op value' (repeatable), --all, --sort, --count-only | | company get --input <csv> --column <name> | batch-enrich a CSV column | | company identify <query> | resolve a fuzzy name/domain/URL to matches (free) | | <entity> values <field> [q] | resolve canonical filter values (free) | | <entity> schema [filters\|fields] | the fields you can filter by / request back (free) | | plans / subscribe <plan> / billing | tiers, subscribe (starter|pro), manage subscription | | invite <emails…> | invite people to earn free credits (200 each, +800 on signup) | | credits / usage / account | plan & balance, recent activity, signed-in status (free) | | feedback <message> | report a bug or request a feature (free) |

Notes

• Filter operators: = != > < >= <= in not_in contains starts_with near. Multiple --where clauses AND together; use --filter-file for OR/nested trees.
• Costs are billed per record returned (no results = no charge). Free commands are marked above.
• Exit codes: 0 ok · 1 usage · 2 auth · 3 rate-limited · 4 out of credits · 5 not found · 6 partial batch · 7 server.

Run enrich guide for recipes, the cost table, and the agent workflow.