@mackody/quickenrich-mcp 0.1.0

package/scripts/token-cli-smoke.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, "quickenrich-token.mjs");
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function run(args, options = {}) {
+  const result = spawnSync(process.execPath, [cliPath, ...args], {
+    encoding: "utf8",
+    input: options.input,
+    env: {
+      ...process.env,
+      QUICKENRICH_API_KEY: "",
+      QUICKENRICH_TOKEN: "",
+    },
+  });
+  if (result.status !== 0) throw new Error(`Command failed: ${args.join(" ")}\n${result.stderr || result.stdout}`);
+  return result.stdout.trim();
+}
+
+const tempDir = mkdtempSync(join(tmpdir(), "quickenrich-token-smoke-"));
+const configPath = join(tempDir, "config.json");
+
+try {
+  const emptyStatus = JSON.parse(run(["status", "--json", "--config", configPath]));
+  assert(emptyStatus.configured === false, "Initial status should be unconfigured.");
+
+  const setOutput = run(["set", "--config", configPath], { input: "test-token-123\n" });
+  assert(setOutput.includes("Saved Quick Enrich API key"), "Set command did not report save.");
+  assert(!setOutput.includes("test-token-123"), "Set command printed the token.");
+  assert((statSync(configPath).mode & 0o777) === 0o600, "Config file was not chmod 600.");
+
+  const configuredStatus = JSON.parse(run(["status", "--json", "--config", configPath]));
+  assert(configuredStatus.configured === true, "Status should be configured after set.");
+  assert(configuredStatus.source === configPath, "Status source should be config path.");
+  assert(!JSON.stringify(configuredStatus).includes("test-token-123"), "Status printed the full token.");
+
+  const testOutput = JSON.parse(run(["test", "--json", "--config", configPath]));
+  assert(testOutput.ok === true, "Test command should succeed locally.");
+  assert(!JSON.stringify(testOutput).includes("test-token-123"), "Test command printed token.");
+
+  const removeOutput = run(["remove", "--config", configPath]);
+  assert(removeOutput.includes("Removed Quick Enrich API key"), "Remove command did not report removal.");
+  const removedStatus = JSON.parse(run(["status", "--json", "--config", configPath]));
+  assert(removedStatus.configured === false, "Status should be unconfigured after remove.");
+
+  console.log(JSON.stringify({ ok: true }, null, 2));
+} finally {
+  rmSync(tempDir, { recursive: true, force: true });
+}

package/skills/quickenrich/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: quickenrich
+description: Use when working with the bundled Quick Enrich MCP server for lead enrichment, batch lead pulls, or API-key setup.
+---
+
+# Quick Enrich MCP
+
+Use `quickenrich_auth_status` first to confirm whether `QUICKENRICH_API_KEY` or the local token config is present.
+
+Prefer compact batch surfaces:
+
+- Use `quickenrich_pipeline` for company-finder to domain-search workflows.
+- Use `quickenrich_batch_pull_leads` for company-domain batches, Contact Finder paging, and Company Finder paging.
+- Use `quickenrich_batch_employee_search` when you have exact LinkedIn URLs or exact names plus company URLs.
+- Use `quickenrich_reverse_email` when you already have an email and need the matching person record.
+- Use `quickenrich_contact_finder` or `quickenrich_company_finder` for discovery filters.
+
+For large runs, pass `input_file`, `output_file`, and `resume_file` instead of pasting CSV/JSONL into the prompt. Use `projection` to keep row envelopes small and `max_credits` before any paid lane.
+
+Credit-sensitive calls should be scoped with limits before execution. Contact finder is discovery-only; it returns `has_email` and `has_phone`, not the actual email or phone. Use `quickenrich-token doctor` before live runs and never paste API keys into prompts.