Veezee

Typed REST client and CLI for theVeezee API: LinkedIn, Reddit, and X (formerly Twitter) data for AI agents, metered in credits with per-call receipts. Zero runtime dependencies, built on Node 20's globalfetch. Current version: 0.6.1.

import { VeezeeClient } from "@veezee/sdk"; const client = new VeezeeClient(); await client.mint(); // reuses the key from vz init, or mints one the first time const profile = await client.linkedin.getProfile({ identifier: "williamhgates" }); console.log(profile.common.full_name, profile.common.headline);

mint()is idempotent: it reusesVEEZEE_API_KEYor~/.veezee/configif either already has a key, and only mints a new one when neither does. The trial key itself carries no balance; the free tier is a per-IP, per-day allowance (200 credits/day, recent data, first page only) checked against the calling IP, not the key. Claiming the key adds a free balance on top: attach an email, confirm it by signing in atveezee.io/login, and the account gets a one-time 10,000-credit grant (once per email, once per key) that spends at the same trial limits after each day's free allowance is used. Outgrow both and a call fails withTRIAL_CAP_EXCEEDEDcarryingupgrade_url: buy credits atveezee.io/upgrade(no login required) and they land on the same key you already have. Nothing to reconfigure: same key, same config file, same code, now with a real balance.

const client = new VeezeeClient({ apiKey: process.env.VEEZEE_API_KEY });

await client.linkedin.getProfile({ identifier: "williamhgates", sections: ["experience", "education"] }); // -> PersonEnvelope { common: { full_name, headline, experience, ... } } await client.linkedin.searchPeople({ keywords: "CTO", current_company: "anthropic", limit: 20 }); // -> PeopleSearchEnvelope { common: { results, cursor, total_matches } } await client.linkedin.getCompany({ identifier: "microsoft" }); // -> CompanyEnvelope { common: { name, industry, employee_count, ... } } await client.linkedin.getPosts({ identifier: "microsoft" }); // -> PostsEnvelope { common: { results, cursor, author_type } } await client.reddit.search({ query: "notion alternative", type: "comments" }); // -> RedditSearchEnvelope { common: { type: "comments", comments, cursor, returned_count } } await client.reddit.getSubredditPosts({ subreddit_name: "selfhosted", sort: "new" }); // -> RedditPostsEnvelope { common: { results, cursor, returned_count } } await client.x.getProfile({ identifier: "nasa" }); // -> XProfileEnvelope { common: { screen_name, name, followers, description, ... } } await client.x.search({ query: "veezee api", type: "recent" }); // -> XSearchEnvelope { common: { type: "recent", tweets, cursor, returned_count } } await client.resolveUrl({ url: "https://www.linkedin.com/in/williamhgates" }); // -> UrlResolutionEnvelope { common: { type: "person", id, handle, canonical_url } } // client.reddit.resolveUrl and client.x.resolveUrl work the same way for their own URLs. await client.getUsage(); // -> UsageEnvelope { common: { plan, platforms, balance_remaining, recent_receipts, upgrade_url, manage_url } } await client.checkout({ pack: "flex" | "production" }); // -> { checkout_url }. Needs no key: paying with none mints a fresh account and its key.

Every response is anenvelope:{ entity, platform, canonical_url, data_as_of, schema_version, common, platform_fields, freshness, usage }.usage.credits_chargedandusage.receipt_idare on every call;freshnesstells you how old the data is. Free-tier trial-key calls also carryusage.free_tier_hint, explaining what budget the call drew from and that paying upgrades this same key.

Non-2xx responses throw a typedVeezeeError(extendsError) carrying the API's problem+json body:

import { VeezeeError } from "@veezee/sdk"; try { await client.linkedin.getProfile({ identifier: "someone" }); } catch (err) { if (err instanceof VeezeeError) { console.error(err.code, err.message); // message is a next-turn instruction if (err.is_retriable) { // safe to retry as-is; the client already retried transient errors internally } } }

The client retriesRATE_LIMITED,CONCURRENCY_LIMIT,UPSTREAM_UNAVAILABLE,INTERNAL, and network/timeout failures up to 3 attempts with exponential backoff, honoringretry_after_secondswhen present. Every metered call gets oneIdempotency-Key(UUID), reused across its own retries: retries never double-charge. Terminal errors (bad input, insufficient credits, auth) throw immediately without retrying.

Errors a payment can fix also carryupgrade_url(give it to your human),credits_required(onINSUFFICIENT_CREDITS: the credits the call needed), andoffer(typedOfferV1): pack prices,checkout_url(the same link asupgrade_url), andresume, which says exactly how to retry after payment.

A call made with no resolvable key throwscode: "KEY_REQUIRED"carryingmint_url: runvz initor callclient.mint(), then retry. A management call (listKeys,createKey,revokeKey,rotateKey,setBalanceAlert) made with no resolvable management token throwscode: "AUTH_REQUIRED": runvz login, then retry.

The package ships aveezeebin, withvzas a short alias for the same binary (noun-verb, mirrors the methods above):

veezee init [--force] veezee linkedin profile get <identifier> [--sections a,b] [--realtime] veezee linkedin search [--keywords x] [--title x] [--company x] [--past-company x] [--school x] [--first-name x] [--last-name x] [--limit n] [--cursor x] [--freshness x] veezee linkedin company get <identifier> veezee linkedin posts get <identifier> veezee reddit search <query> [--type posts|comments|subreddits|users] [--sort x] [--range x] veezee reddit subreddit <name> [--include-settings] veezee reddit subreddit-posts <name> [--sort x] [--range x] [--include-promoted] veezee reddit user <username> [--sections comments,posts,subreddits] veezee reddit post <id1,id2,...> [--detail concise|full] [--comment-id x] veezee x search <query> [--type recent|popular|people] veezee x profile <identifier> [--by screen_name|id] veezee x tweets <identifier> [--mode posts|posts_and_replies|highlights] [--no-retweets] veezee x tweet <tweet_id> veezee resolve-url <url> veezee usage veezee login [--device] [--no-browser] veezee logout veezee keys list [--account <id>] veezee keys create [--label <name>] [--account <id>] veezee keys revoke <key_id> [--account <id>] veezee keys rotate <key_id> [--account <id>] veezee alert <threshold|off> [--account <id>]

Runvz initfirst (once): it mints a free trial key and writes it to~/.veezee/config, masked hint only ever printed to stdout, never the raw key.vz init --jsonprints the same result as JSON (still no raw key) for scripting.vz init --forcere-mints and overwrites the stored key.

For example,vz reddit search "notion alternative" --type commentsorvz x profile nasa. Every platform namespace also has its ownresolve-url:vz reddit resolve-url <url>,vz x resolve-url <url>.

Add--jsonon any command for machine-readable output (the raw envelope; errors print the full error shape as JSON too). Every data command takes--max-credits <n>to cap spend on that call: if the quote exceeds the cap the API returns a typed error and charges nothing. Unknown flags are rejected with the valid-flag list (exit 2), never silently ignored. Auth resolves in order:--key <apiKey>, then theVEEZEE_API_KEYenv var, then~/.veezee/configfromvz init.--base-urloverrides the API host. Exit codes:0success,1failure,2usage or invalid-input error,4auth required.vz --versionprints the SDK version. Runvz --help(or no args) for examples.

vz loginis a separate, optional step: it proves an email (browser callback by default, or--devicefor a headless code-entry flow) and stores avzm_management token in~/.veezee/config, masked hint only ever printed to stdout.vz keys list|create|revoke|rotateandvz alert <threshold|off>use that token, resolved in order:--key <vzm_...>, thenVEEZEE_MGMT_TOKEN, then the stored token.vz keys createandvz keys rotateprint the rawapi_keyto stdout once (the "shown once" warning goes to stderr): store it immediately, it cannot be retrieved again.vz logoutclears the locally stored token; it does not revoke it server-side.

The package ships eight installable SKILL.md packs underskills/: prospect-enrich, candidate-sourcing, company-enrichment, account-research, post-voice-research, reddit-monitoring, launch-sentiment-sweep, and outreach-list-builder. Afternpm install @veezee/sdk, add them to your agent with theskills CLIlocal-path syntax:

npx skills add ./node_modules/@veezee/sdk/skills

The same packs also install straight from GitHub (veezeehq/veezee-skills):npx skills add veezeehq/veezee-skills. Pack index and docs:veezee.io/docs/skills.

npm install npm run build # tsc -> dist/ npm test # compiles test/ and runs node --test npm pack --dry-run

Full API reference:https://veezee.io/docs. SDK page:https://veezee.io/docs/sdk. CLI page:https://veezee.io/docs/cli. Hosted MCP servers (same tools, no install):https://veezee.io/docs/clients, listed in theMCP Registryasio.veezee/linkedin,io.veezee/reddit, andio.veezee/x-twitter.

SerpApi MCP Server for Google and other search engine results