Prospect enrichment with Veezee
Turn identifiers you already have (LinkedIn profile URLs, slugs, or names) into current role, company, and experience data. LinkedIn only; this skill covers no other platform.
Setup (one free key, no signup)
Every call needs an API key. Minting one is free and human-free: no signup, no card. A call without a key fails with KEY_REQUIRED (401) carrying mint_url; the fix is the free mint below, never a payment. A fresh vz_trial_ key runs under a free per-IP daily budget of 200 credits, cached data only, first page only on any cursor sequence. Two equivalent surfaces; pick whichever your environment has:
- MCP: add the server
https://mcp.veezee.io/linkedin (streamable-http; https://mcp.veezee.io/all exposes every tool). Hosts that support MCP authorization (Claude Code, claude.ai) open a Veezee sign-in on connect (email code, no password): that is the whole auth step. Other hosts: mint a key with POST https://api.veezee.io/v1/keys/mint (empty body; the key is shown once) and put it in the connection's Authorization: Bearer header.
- SDK:
import { VeezeeClient } from "@veezee/sdk"; const client = new VeezeeClient(); await client.mint(); mints and stores the free key the first time and reuses it on later runs. Platform methods live on the namespace (client.linkedin.getProfile/searchPeople/getCompany/getPosts); client.resolveUrl and client.getUsage are top-level. The client sends retries and Idempotency-Keys for you. The veezee CLI (npx @veezee/sdk init) mints and stores the same key.
When the free budget or a trial cap runs out (TRIAL_CAP_EXCEEDED, INSUFFICIENT_CREDITS, BUDGET_EXHAUSTED), the error carries upgrade_url (https://veezee.io/upgrade) and a machine-readable offer. Hand that link to your human; purchases credit the same key directly and it keeps working unchanged.
The loop, per prospect
- Classify the identifier.
- Clean profile URL, slug (the part after
/in/), or URN: go straight to step 2. Do not call resolve_url on clean identifiers; it costs credits for nothing.
- Dirty or ambiguous URL (trackers, redirects, shortened):
resolve_url first, then use the returned handle.
- Name only:
search_people with keywords (and current_company if known), then take the best match.
get_profile with sections: ["experience"]. The first two sections are included in the base price; each section beyond two costs extra, four sections maximum.- Record
full_name, headline, current_position, and the experience entries. Every response carries usage with the exact credits charged.
Rules that save credits and errors
- A
search_people result with is_anonymous: true is a private profile. get_profile cannot dereference it. Treat the match as confirmed and move on; never retry.
- Check the budget BEFORE a batch:
get_usage is free, exempt from the rate limit, and works the same on a trial or paid key.
- Set
max_credits on calls when running a large batch; a call whose quote exceeds it is rejected with nothing charged.
- Default freshness is cached (usually a few hours old) and free.
freshness: "realtime" costs extra and needs a paid key (trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED); use it only when the user needs today's data.
- A company known only by its website?
get_company accepts the domain directly (a new domain quotes extra for verified resolution; known domains settle at the base price).
- On KEY_REQUIRED, mint the free key and retry the same call; it is never a payment problem. On TRIAL_CAP_EXCEEDED, INSUFFICIENT_CREDITS, or BUDGET_EXHAUSTED, stop the batch and give the error's
upgrade_url to your human; purchases credit the account directly and the same key keeps working afterward.
- A 403 NOT_ENTITLED means the key's account is not enabled for this platform; grants are explicit, write to hello@veezee.io to enable more.
Output
Report per prospect: name, current title, current company, and the two most recent experience entries. Include total credits spent (sum the usage.credits_charged fields) so the human can budget the next batch.