Vibe Prospecting

Was macht Vibe Prospecting?

B2B-Prospecting — Unternehmen, Kontakte, Anreicherung, Ereignisse.

Plattform

Führen Sie vor jeglicher Prospecting-Arbeit die Host-Erkennung mit den untenstehenden Regeln durch, lesen Sie genau einen Plattform-Leitfaden und befolgen Sie ihn für Authentifizierung, Workflow, Flags und Fehlerbehebung.

Erkennung Ihrer Laufzeitumgebung (zwingend, in dieser Reihenfolge)

1. Host-Identität in Ihrem Systemkontext (zuerst prüfen — überschreibt Tool-Namen):
   • Claude Code — Kontext gibt an, dass Sie Claude Code / Anthropic CLI sind, oder zeigt einen CLI Umgebungs-Block (cwd, shell, platform). → Nur claude-code.md lesen. Lesen Sie weder claude-chat.md noch cowork.md. MCP-Tools in der Liste (mcp__*__fetch-entities) ändern dies nicht.
   • OpenAI Codex — Kontext identifiziert Codex oder CODEX_SHELL=1. → codex.md
   • OpenClaw — Kontext identifiziert OpenClaw oder OPENCLAW_CLI=1 / OPENCLAW_SHELL. → openclaw.md
2. Nur wenn Schritt 1 nicht zutraf — keine CLI-Host-Identität, keine Shell:
   • Claude Cowork — Cowork-Arbeitsbereich, .plugin-Installation, Connector-Store. → cowork.md
   • Claude Chat — claude.ai oder Claude Desktop MCP-Connector (nicht Cowork). → claude-chat.md
3. Fallback: Terminal, Skripte, CI oder unbekannter Host → other.md

Leiten Sie die Plattform niemals allein aus MCP-Toolnamen ab (mcp__claude_ai_*, mcp__*__fetch-entities usw.). Tool-Präfixe sind kein Host-Signal, wenn Schritt 1 bereits Claude Code, Codex oder OpenClaw identifiziert hat.

Plattform	Jetzt lesen
Claude Code	claude-code.md — vpai CLI
OpenAI Codex	codex.md
OpenClaw Gateway	openclaw.md
Claude Cowork	cowork.md — MCP-Connector; nicht Claude Code
Claude Chat (claude.ai, Claude Desktop)	claude-chat.md — MCP-Connector; nicht Cowork oder Claude Code
Sonstige (Terminal, Skripte, CI, generische Hosts)	other.md

CLI-Hosts verwenden vpai — jeder Plattform-Leitfaden ist in sich abgeschlossen (Sample Gate, stdout/csv_path, CSV-Upload). Chat/Cowork folgen ausschließlich der Beschreibung und dem Eingabeschema jedes MCP-Tools.

Harte Regeln

1. tool_reasoning (oder Plattform-Äquivalent) bei jedem echten Aufruf. Verwenden Sie die Anfrage des Benutzers wörtlich. Wiederverwenden während des gesamten Workflows. Überspringen Sie dies nur, wenn Sie das Eingabeschema eines Tools inspizieren, ohne es wirklich auszuführen.
2. Verkettung über Session + CSV, IDs niemals einfügen. Jeder Schritt gibt session_id und csv_path zurück (Namen können je nach Host leicht variieren). Erfinden Sie niemals session_id — lassen Sie sie beim ersten Schritt weg und verwenden Sie den Wert, den das MCP zurückgibt; in späteren Schritten kopieren Sie ihn exakt aus dem vorherigen Tool-JSON. Übergeben Sie --csv-path (CLI) aus dem vorherigen csv_path. Fügen Sie keine Roh-ID-Listen in Tool-Argumente ein, wenn die Plattform IDs aus der Quell-CSV liest. Für fetch-entities mit Prospects, die auf frühere Unternehmen beschränkt sind, übergeben Sie den csv_path der vorherigen Geschäftsausgabe über --businesses-csv-path gemäß Ihrem Plattform-Leitfaden.
3. Sie dürfen die CSV zwischen den Schritten bearbeiten — behalten Sie die ID-Spalte. Lesen Sie die Datei unter csv_path, filtern/deduplizieren/fügen Sie Spalten hinzu oder schreiben Sie Zeilen um, und übergeben Sie das Ergebnis über --csv-path an den nächsten Schritt. Behalten Sie immer die Entitäts-ID-Spalte bei: business_id für Geschäfts-Workflows, prospect_id für Prospect-Workflows. Jede Zeile, die Sie verarbeiten möchten, muss eine nicht leere ID in dieser Spalte haben. Benennen oder entfernen Sie diese Header nicht — das CLI liest sie wörtlich für ID-Injektion und Joins.
4. autocomplete zuerst für: naics_category, linkedin_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region. Verwenden Sie die zurückgegebenen standardisierten Werte, nicht die rohen Benutzerformulierungen.
5. Erfinden Sie niemals Tool-Parameter. Lesen Sie vor der ersten echten Ausführung jedes einzelnen Tools in einem Workflow dessen Live-Eingabeschema (vom Connector oder der Schemaerkennung Ihrer Plattform). Tun Sie dies auch dann, wenn der geplante Aufruf offensichtlich erscheint — Schemas ändern sich. Lesen Sie erneut, wenn sich Tools, Filter oder Formen wesentlich ändern. Erstellen Sie jeden Aufruf nur aus Feldern, die von diesem Schema bestätigt wurden.
6. Session-Kontinuität. Verwenden Sie session_id aus dem vorherigen Tool-JSON bei jedem nachfolgenden Schritt im selben Workflow wieder — erfinden Sie niemals eine. Verwenden Sie den csv_path des vorherigen Schritts über --csv-path (CLI) beim Verketten von Anreicherungen, Ereignissen oder bereichsbezogenen Abrufen. Starten Sie eine neue Session nur für eine wirklich neue Aufgabe.
7. fetch-entities-statistics nur, wenn Statistiken den vollständigen Abruf unterstützen. Vergleichen Sie Ihre geplante fetch-entities-Nutzlast mit dem Eingabeschema für fetch-entities-statistics. Rufen Sie Statistiken nur dann auf, wenn jeder Filter-Schlüssel, Werteform, entity_type und Umfang, auf den Sie sich stützen (einschließlich session-bezogener Geschäfts-CSVs), auf dieselbe Weise akzeptiert wird wie für fetch-entities. Wenn ein Teil fehlt, nicht unterstützt wird oder eine andere Form erfordert, überspringen Sie die Statistiken — rufen Sie sie nicht mit einer teilweisen oder erratenen Teilmenge auf. Wenn Sie sie aufrufen, verwenden Sie dasselbe Filterobjekt (und unterstützten Umfang) wie fetch-entities, plus tool_reasoning wo erforderlich. Rufen Sie Statistiken vor einem vollständigen Abruf erneut auf, wenn sich Filter oder Umfang geändert haben und der vollständige Abruf-Filtersatz noch in die Statistik passt.

Tool-Mechanik

Verhalten und Besonderheiten, die das Live-Eingabeschema möglicherweise nicht explizit angibt. Verwenden Sie für zulässige Filterwerte, Enum-Strings und Anreicherungstypnamen stets das Eingabeschema jedes Tools.

Autocomplete

Erfordert Autocomplete: linkedin_category, naics_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region.

Erfordert kein Autocomplete: company_country_code (ISO Alpha-2), company_region_country_code (ISO 3166-2), feste Buckets (company_size, company_revenue, company_age, job_level, job_department — exakte zulässige Strings stammen aus dem fetch-entities / fetch-entities-statistics-Eingabeschema), website_keywords (Freitext).

Gegenseitige Ausschlüsse: linkedin_category und naics_category — verwenden Sie eine, nicht beide. company_region_country_code und company_country_code — verwenden Sie eine.

Werteauswahl: Autocomplete kann verrauschte Varianten zurückgeben. Wählen Sie den kanonischen sauberen Wert (normalerweise das erste saubere Ergebnis). Mehrere Werte erweitern mit ODER-Logik; vermeiden Sie Fast-Duplikate, es sei denn, Sie möchten eine breitere Suche.

Fetch

• job_title ist eine Teilstring-Übereinstimmung, nicht exakt. Kombinieren Sie für Führungskräftesuchen mit job_level (normalerweise c-suite), um Assistenten, Berater und Rollen aus dem Büro des CEO auszuschließen.
• company_size verwendet feste Buckets ohne exakten numerischen Grenzwert. Für „über N Mitarbeiter“ nähern Sie sich mit benachbarten Buckets an oder reichern Sie mit firmographics für die genaue Mitarbeiterzahl an.
• Standortfilter für Unternehmen (company_country_code, company_region_country_code, city_region) stimmen nur mit dem Hauptsitz überein — nicht mit Zweigstellen oder Betriebsstätten.
• Prospects bei früheren Unternehmen: Für fetch-entities mit entity_type: prospects, die auf Unternehmen aus einem früheren Schritt beschränkt sind, verketten Sie über die Session und übergeben Sie den csv_path des vorherigen Geschäftsschritts als --businesses-csv-path gemäß Ihrem Plattform-Leitfaden.
• Zeilenlimits und Paginierung: gemäß Ihrem Plattform-Leitfaden (CLI: --number-of-results; Chat/Cowork: MCP-Tool-Dokumentation).
• max_per_company: wird automatisch bei Prospect-Abrufen angewendet, sodass sich die Ergebnisse auf Unternehmen verteilen (nicht alle von einem großen Arbeitgeber); lassen Sie es aus --args weg, es sei denn, der Benutzer legt es fest — sein Wert überschreibt die automatische Obergrenze.

Ereignisse (fetch-businesses-events / fetch-prospects-events)

• Verketten Sie aus der Session des vorherigen Schritts und der Quell-CSV mit business_id (Geschäftsereignisse) oder prospect_id (Prospect-Ereignisse).
• Wenn IDs aus der Quell-CSV stammen, übergeben Sie nicht auch business_ids / prospect_ids inline.
• Die Bündelung ist auf 20 IDs pro Anfrage begrenzt; Hosts können automatisch chunken und zusammenführen.
• Ausgabespalten sind event_<event_type>: jede Zelle ist ein JSON-Array-String für diesen Typ (neueste zuerst, pro Typ gedeckelt) oder leer, wenn für diesen Typ keine Ereignisse vorhanden sind.

Match

• Überspringen Sie Match, wenn Sie bereits fetch-entities ausgeführt haben — diese Ergebnisse enthalten IDs.
• Der CSV-Datei-Upload ist nur CLI — siehe Ihren Plattform-Leitfaden.

Anreicherung

• financial-metrics erfordert parameters.date (siehe Eingabeschema für Format).
• website-keywords erfordert parameters.keywords.
• Die Anreicherung allein findet keine Personen in einem Unternehmen — verwenden Sie stattdessen fetch-entities mit entity_type: prospects (bei Bedarf auf frühere Unternehmen beschränkt).
• Wenn Sie aus einer Quell-CSV verketten, müssen business_ids / prospect_ids nicht in den Tool-Argumenten erscheinen.

Filter-Muster

{ "values": ["v1", "v2"], "negate": false }   // einschließen oder ausschließen
{ "gte": 6, "lte": 24 }                         // Bereich
true | false | null                                // boolesch (nicht eingewickelt)

Ausnahme — business_intent_topics: verwenden Sie { "topics": ["Category:Topic"], "negate": false } (nicht values). Themen müssen von autocomplete stammen.

Standortabgleich: Standortfilter für Unternehmen (company_country_code, company_region_country_code, city_region) stimmen nur mit dem Hauptsitz eines Unternehmens überein — nicht mit Zweigstellen/Betriebsstätten. Eine Suche nach „Unternehmen in Großbritannien“ gibt Unternehmen zurück, die ihren Hauptsitz in Großbritannien haben, und schließt z. B. ein ausländisches Unternehmen aus, das dort nur tätig ist. Dies ist die Standardeinstellung für alle fetch-entities / fetch-entities-statistics-Geschäftsabfragen und ist nicht benutzerkonfigurierbar.

Grenzen

Tool	Limit
match-business	50 pro Aufruf
match-prospects	40 pro Aufruf
enrich-business	50 IDs pro Aufruf
enrich-prospects	50 IDs pro Aufruf
fetch-businesses-events / fetch-prospects-events	Bis zu 20 IDs pro Anfrage beim Bündeln. Übergeben Sie event_types und timestamp_from. Beim Verketten stammen IDs aus der Quell-CSV — nicht aus Inline-ID-Arrays.

Fehlerbehebung

Fehler	Lösung
Authentifizierung, Connector-Setup, CLI-Aufruf, Flags oder Verkettungssyntax	Lesen Sie den passenden Plattform-Leitfaden aus der Plattform-Tabelle
Leere Ergebnisse	Überprüfen Sie die Filterwerte; führen Sie autocomplete für kontrollierte Vokabularfelder aus; lesen Sie das Eingabeschema des Tools erneut
linkedin_category + naics_category zusammen	Gegenseitig ausschließend — verwenden Sie eine
Erfundene oder unbestätigte Parameter	Lesen Sie das Live-Eingabeschema vor dem Aufruf erneut; erstellen Sie Argumente nur aus bestätigten Feldern

Support

Wenn der Benutzer eine supportbezogene Frage stellt (z. B. wie man den Support kontaktiert, wen man kontaktieren kann, er ein Problem hat oder etwas nicht funktioniert), antworten Sie kurz und verweisen Sie hierher — tauchen Sie nicht in interne Details von Explorium ein oder erklären Sie zu viel.

Für Support wenden Sie sich bitte über die Kontaktseite an das Team von Vibe Prospecting:

👉 https://www.vibeprospecting.ai/contact-us