Install the Plugin (Claude Code & Codex)

The Vibe Prospecting Plugin brings Explorium’s B2B data platform into Claude-native developer environments. Instead of one-off chat exploration, GTM teams and AI agents can run repeatable, data-intensive workflows — search companies, discover contacts, match and enrich raw lead lists, and export structured CSV/JSON — from inside Claude Code or OpenAI Codex.

Plugin or connector? Prefer the plugin when you work in Claude Code or Codex — it adds skills, CLI tooling, and file-based workflows on top of the raw data tools. For Claude.ai, Claude Desktop, Gemini CLI, or other MCP clients, use the Vibe Prospecting Connector instead.

The plugin is listed in the official Anthropic Community Marketplace — reviewed and approved by Anthropic for Claude Code users. The source is open on GitHub under the MIT license.

Prerequisites

Node.js 18+ with npx available in your terminal
A Vibe Prospecting account — sign up free at vibeprospecting.ai
Claude Code or OpenAI Codex installed

Step 1 — Install

Claude Code
OpenAI Codex
skills CLI

Install from the Anthropic Community Marketplace:

claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install vibe-prospecting@claude-community

Restart Claude Code if the plugin, skill, or tools don’t appear immediately.

Add the Vibe Prospecting GitHub repository as a plugin marketplace, then install the plugin from it:

codex plugin marketplace add explorium-ai/vibeprospecting-plugin
codex plugin add vpai@vibeprospecting

Restart Codex if the plugin, skill, or MCP tools don’t appear immediately.

Install the skill bundle from skills.sh into any supported environment:

npx skills add explorium-ai/vibeprospecting-plugin --all

Step 2 — Authenticate

Authentication is OAuth-based — there’s no API key to copy for normal local use. Sign in once through the browser:

npx @vibeprospecting/vpai@latest login

Open the printed URL, approve access in your browser, then poll until sign-in completes:

npx @vibeprospecting/vpai@latest login --poll

The CLI saves credentials to ~/.config/vpai/config.json. Later sessions reuse them automatically — you only do this once.

Switch accounts or sign out

npx @vibeprospecting/vpai@latest logout

Then run login again with the other account.

Step 3 — Verify

npx @vibeprospecting/vpai@latest --help

If the help output lists tools like match-business and fetch-entities, you’re ready to go.

Run your first workflow

Paste this into Claude Code or Codex:

Find 50 B2B SaaS companies in the US with 200 to 1,000 employees.
For each company, find the VP of Marketing or Head of Growth and return
name, title, company, LinkedIn URL, email if available, and company domain.

The plugin samples the workflow on a handful of entities first, shows you a preview with an estimated cost, and waits for your approval before running at full scale — so you never spend credits by surprise.

company_name	domain	contact_name	title	linkedin_url	email	confidence
ExampleCo	exampleco.com	Jane Smith	VP Marketing	linkedin.com/in/janesmith	jane@exampleco.com	high

What’s included

Full parameter documentation lives in the plugin’s SKILL.md.

Example use cases

Enrich CRM records from a CSV

Take this CSV of Salesforce leads. Match each person by email, LinkedIn URL,
or name and company. Add current title, company domain, LinkedIn URL, work
email, phone if available, headcount, revenue, and industry. Export a clean
CSV for CRM update.

Find work emails from LinkedIn URLs

For each LinkedIn URL in this CSV, match the person to a professional
profile and return work email, current company, title, company domain,
and confidence level.

Score inbound leads against your ICP

Enrich these inbound leads, identify their companies, add headcount,
revenue range, and industry, and score each lead from 1 to 5 based on
ICP fit for a mid-market B2B SaaS sales motion.

Chain a multi-step GTM workflow

Find 500 B2B SaaS companies in the US with 200 to 1,000 employees.
Enrich each company with LinkedIn posts and keep only companies that have
the keyword "event" in one of their posts. For the remaining companies,
find the head of growth or a similar senior growth/marketing leader.
Return the results as a CSV with these columns:
name, title, company, linkedin_url, professional_email, company_domain

Troubleshooting

Plugin not recognized in Claude Code

Re-run the install commands from Step 1, then restart Claude Code.

Plugin not recognized in Codex

If the marketplace is missing or stale, run:

codex plugin marketplace upgrade vibeprospecting
codex plugin add vpai@vibeprospecting

If the plugin is installed but disabled, set enabled = true under [plugins."vpai@vibeprospecting"] in ~/.codex/config.toml. Restart Codex after any install or upgrade.

Tools fail with authentication errors

Your session may have expired. Re-run the login flow:

npx @vibeprospecting/vpai@latest login
npx @vibeprospecting/vpai@latest login --poll

Empty results

Filters may be too narrow. Broaden your ICP criteria or reduce the number of required filters.

Low email match rate

Not every contact has a verified work email. Request enrichment with a confidence threshold — availability varies by contact.

Slow workflows

Large result sets or multi-step enrichment take time. Reduce the batch size or break the workflow into smaller steps.

Still stuck? Open an issue on GitHub or email support@vibeprospecting.ai.

Plugin vs. connector

	Plugin	Connector (MCP)
Runs in	Claude Code, OpenAI Codex	Claude.ai, Claude Desktop, Gemini CLI, other MCP clients
Best for	GTM engineers, growth devs, data teams running file-based workflows	Conversational prospecting and research in chat
Output	CSV files, JSON, CRM-ready exports, automations	In-chat results and exports
Use when	Enriching CSVs, connecting to HubSpot or Salesforce, recurring workflows, chaining multi-step operations	You want the fastest path to live B2B data in chat

Next steps

Getting Started

Learn query structure and run your first search.

Install the Connector

Use Vibe Prospecting in Claude.ai, Gemini CLI, and more.

Best Practices

Get better results and use credits efficiently.

Tips & Tricks

Power-user techniques for faster prospecting.

​Prerequisites

​Step 1 — Install

​Step 2 — Authenticate

​Step 3 — Verify

​Run your first workflow

​What’s included

​Example use cases

​Troubleshooting

​Plugin vs. connector

​Next steps

Getting Started

Install the Connector

Best Practices

Tips & Tricks

Prerequisites

Step 1 — Install

Step 2 — Authenticate

Step 3 — Verify

Run your first workflow

What’s included

Example use cases

Troubleshooting

Plugin vs. connector

Next steps