Vibe Prospecting

B2B 잠재 고객 발굴 — 기업, 연락처, 정보 보강, 이벤트.

플랫폼

잠재 고객 발굴 작업 전에 아래 규칙을 사용하여 호스트를 감지하고, 정확히 하나의 플랫폼 가이드를 읽고 인증, 워크플로우, 플래그 및 문제 해결을 따르세요.

런타임 감지 (필수, 순서대로)

시스템 컨텍스트의 호스트 ID (먼저 확인 — 도구 이름보다 우선함):
- Claude Code — 컨텍스트에 사용자가 Claude Code / Anthropic의 CLI라고 명시되어 있거나, CLI 환경 블록(cwd, shell, platform)이 표시됩니다. → claude-code.md만 읽으십시오. claude-chat.md 또는 cowork.md를 읽지 마십시오. 목록의 MCP 도구(mcp__*__fetch-entities)는 이를 변경하지 않습니다.
- OpenAI Codex — 컨텍스트에 Codex 또는 CODEX_SHELL=1이 식별됩니다. → codex.md
- OpenClaw — 컨텍스트에 OpenClaw 또는 OPENCLAW_CLI=1 / OPENCLAW_SHELL이 식별됩니다. → openclaw.md
1단계가 일치하지 않는 경우에만 — CLI 호스트 ID가 없고 셸도 없는 경우:
- Claude Cowork — Cowork 워크스페이스, .plugin 설치, 커넥터 스토어. → cowork.md
- Claude Chat — claude.ai 또는 Claude 데스크탑 MCP 커넥터(Cowork 아님). → claude-chat.md
폴백: 터미널, 스크립트, CI 또는 알 수 없는 호스트 → other.md

MCP 도구 이름만으로 플랫폼을 유추하지 마십시오(mcp__claude_ai_*, mcp__*__fetch-entities 등). 1단계에서 이미 Claude Code, Codex 또는 OpenClaw를 식별한 경우 도구 접두사는 호스트 신호가 아닙니다.

플랫폼	지금 읽기
Claude Code	`claude-code.md` — `vpai` CLI
OpenAI Codex	`codex.md`
OpenClaw 게이트웨이	`openclaw.md`
Claude Cowork	`cowork.md` — MCP 커넥터; Claude Code 아님
Claude Chat (claude.ai, Claude 데스크탑)	`claude-chat.md` — MCP 커넥터; Cowork 또는 Claude Code 아님
기타 (터미널, 스크립트, CI, 일반 호스트)	`other.md`

CLI 호스트는 vpai를 사용합니다 — 각 플랫폼 가이드는 자체 포함되어 있습니다(샘플 게이트, stdout/csv_path, CSV 업로드). 채팅/Cowork는 각 MCP 도구의 설명과 입력 스키마만 따릅니다.

엄격한 규칙

tool_reasoning(또는 플랫폼에 해당하는 항목)은 모든 실제 호출에 사용합니다. 사용자의 요청을 그대로 사용하십시오. 전체 워크플로우에서 재사용하십시오. 실제 실행 없이 도구의 입력 스키마를 검사할 때만 건너뜁니다.
세션 + CSV를 통해 연결하고, ID를 절대 붙여넣지 마십시오. 각 단계는 session_id 및 **csv_path**를 반환합니다(이름은 호스트에 따라 약간 다를 수 있음). session_id를 절대 임의로 만들지 마십시오. 첫 번째 단계에서는 생략하고 MCP가 반환한 값을 사용하고, 이후 단계에서는 이전 도구 JSON에서 정확히 복사하십시오. 이전 **csv_path**에서 --csv-path (CLI)를 전달하십시오. 플랫폼이 소스 CSV에서 ID를 읽을 때 도구 인수에 원시 ID 목록을 붙여넣지 마십시오. 이전 회사로 범위가 지정된 fetch-entities 잠재 고객의 경우, 플랫폼 가이드에 따라 **--businesses-csv-path**를 통해 이전 비즈니스 출력의 **csv_path**를 전달하십시오.
단계 사이에 CSV를 편집할 수 있습니다 — ID 열을 유지하십시오. CLI 호스트에서 **csv_path**의 파일을 읽고, 필터링/중복 제거/열을 추가하거나 행을 다시 작성한 다음 **--csv-path**를 통해 결과를 다음 단계로 전달하십시오. 엔터티 ID 열(business_id 또는 prospect_id)을 항상 유지하십시오. 비즈니스 워크플로우의 경우 business_id, 잠재 고객 워크플로우의 경우 prospect_id입니다. 다음에 처리하려는 모든 행에는 해당 열에 비어 있지 않은 ID가 있어야 합니다. 해당 헤더의 이름을 바꾸거나 삭제하지 마십시오. CLI는 ID 주입 및 조인을 위해 해당 헤더를 그대로 읽습니다.
autocomplete를 먼저 사용하십시오 (다음 필드 대상): naics_category, linkedin_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region. 반환된 표준화된 값을 사용하고, 사용자의 원래 표현을 사용하지 마십시오.
도구 매개변수를 절대 임의로 만들지 마십시오. 워크플로우에서 각 고유 도구를 처음 실제 실행하기 전에 해당 도구의 라이브 입력 스키마(커넥터 또는 플랫폼의 스키마 검색에서)를 읽으십시오. 계획된 호출이 명확해 보이는 경우에도 이 작업을 수행하십시오. 스키마는 변경될 수 있습니다. 해당 스키마에서 확인된 필드로만 각 호출을 구성하십시오.
세션 연속성. 동일한 워크플로우의 모든 후속 단계에서 이전 도구 JSON의 **session_id**를 재사용하십시오. 절대 임의로 만들지 마십시오. 정보 보강, 이벤트 또는 범위가 지정된 가져오기를 연결할 때 이전 단계의 **csv_path**를 --csv-path(CLI)를 통해 재사용하십시오. 진정으로 새로운 작업에 대해서만 새 세션을 시작하십시오.
fetch-entities-statistics는 통계가 전체 가져오기를 지원하는 경우에만 사용하십시오. 계획된 fetch-entities 페이로드를 **fetch-entities-statistics**의 입력 스키마와 비교하십시오. 사용하려는 모든 필터 키, 값 형태, entity_type 및 범위(세션 범위의 비즈니스 CSV 포함)가 **fetch-entities**와 동일한 방식으로 허용되는 경우에만 통계를 호출하십시오. 누락되거나, 지원되지 않거나, 다른 형태가 필요한 부분이 있으면 통계를 건너뛰십시오. 부분 또는 추측된 하위 집합으로 호출하지 마십시오. 통계를 호출할 때는 **fetch-entities**와 동일한 필터 객체(및 지원되는 범위)와 필수 **tool_reasoning**을 재사용하십시오. 필터 또는 범위가 변경되고 전체 가져오기 필터 세트가 여전히 통계에 적합한 경우, 전체 규모 가져오기 전에 통계를 다시 호출하십시오.

도구 메커니즘

라이브 입력 스키마가 명시적으로 설명하지 않을 수 있는 동작 및 주의 사항. 허용된 필터 값, 열거형 문자열 및 정보 보강 유형 이름에 대해서는 항상 각 도구의 입력 스키마를 사용하십시오.

자동 완성

자동 완성 필요: linkedin_category, naics_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region.

자동 완성 불필요: company_country_code (ISO Alpha-2), company_region_country_code (ISO 3166-2), 고정 버킷(company_size, company_revenue, company_age, job_level, job_department — 정확한 허용 문자열은 fetch-entities / fetch-entities-statistics 입력 스키마에서 제공됨), website_keywords (자유 텍스트).

상호 배타: linkedin_category 및 naics_category — 둘 중 하나만 사용하십시오. company_region_country_code 및 company_country_code — 둘 중 하나만 사용하십시오.

값 선택: 자동 완성은 노이즈가 많은 변형을 반환할 수 있습니다. 표준적인 정리된 값(일반적으로 첫 번째 정리된 결과)을 선택하십시오. 여러 값은 OR 논리로 범위를 넓힙니다. 더 넓은 검색을 원하지 않는 한 거의 중복된 값을 피하십시오.

가져오기(Fetch)

**job_title**은 정확히 일치하는 것이 아니라 부분 문자열 일치입니다. 경영진 검색의 경우 job_level(일반적으로 c-suite)과 결합하여 보조원, 고문 및 사무실 직위를 제거하십시오.
**company_size**는 정확한 숫자 기준이 없는 고정 버킷을 사용합니다. "직원 N명 이상"의 경우 인접한 버킷으로 근사하거나 firmographics로 정보를 보강하여 정확한 인원수를 확인하십시오.
비즈니스 위치 필터(company_country_code, company_region_country_code, city_region)는 본사만 일치합니다. 지점 또는 운영 위치는 일치하지 않습니다.
이전 회사의 잠재 고객: 이전 단계의 비즈니스로 범위가 지정된 entity_type: prospects인 fetch-entities의 경우, 플랫폼 가이드에 따라 세션을 통해 연결하고 이전 비즈니스 단계의 **csv_path**를 **--businesses-csv-path**로 전달하십시오.
행 제한 및 페이지 매김: 플랫폼 가이드 참조 (CLI: --number-of-results; 채팅/Cowork: MCP 도구 문서).
max_per_company: 잠재 고객 가져오기 시 자동으로 적용되어 결과가 여러 회사에 분산됩니다(한 대규모 고용주에서 모두 가져오지 않음). 사용자가 설정하지 않는 한 --args에서 생략하십시오. 사용자가 설정한 값이 자동 상한을 재정의합니다.

이벤트 (`fetch-businesses-events` / `fetch-prospects-events`)

이전 단계의 세션 및 business_id(비즈니스 이벤트) 또는 prospect_id(잠재 고객 이벤트)가 있는 소스 CSV에서 연결하십시오.
ID가 소스 CSV에서 오는 경우 business_ids / **prospect_ids**를 인라인으로 전달하지 마십시오.
배치는 요청당 최대 20개 ID로 제한됩니다. 호스트가 자동으로 청크를 나누고 병합할 수 있습니다.
출력 열은 event_<event_type> 형식입니다. 각 셀은 해당 유형의 JSON 배열 문자열입니다(최신순, 유형당 상한 적용). 해당 유형의 이벤트가 없으면 비어 있습니다.

매칭(Match)

이미 **fetch-entities**를 실행한 경우 매칭을 건너뛰십시오. 해당 결과에는 ID가 포함됩니다.
CSV 파일 업로드는 CLI 전용입니다. 플랫폼 가이드를 참조하십시오.

정보 보강(Enrich)

**financial-metrics**에는 **parameters.date**가 필요합니다(입력 스키마에서 형식 참조).
**website-keywords**에는 **parameters.keywords**가 필요합니다.
정보 보강만으로는 회사에 있는 사람을 찾을 수 없습니다. 대신 **fetch-entities**와 **entity_type: prospects**를 사용하십시오(필요한 경우 이전 회사로 범위 지정).
소스 CSV에서 연결할 때 **business_ids / prospect_ids**는 도구 인수에 나타날 필요가 없습니다.

필터 패턴

{ "values": ["v1", "v2"], "negate": false }   // 포함 또는 제외
{ "gte": 6, "lte": 24 }                         // 범위
true | false | null                                 // 부울 (래핑되지 않음)

예외 — business_intent_topics: { "topics": ["Category:Topic"], "negate": false }를 사용하십시오(values 아님). 주제는 autocomplete에서 가져와야 합니다.

위치 일치: 비즈니스 위치 필터(company_country_code, company_region_country_code, city_region)는 회사의 본사만 일치합니다. 지점/운영 위치는 일치하지 않습니다. "영국 내 회사" 검색은 영국에 본사를 둔 회사를 반환하고, 예를 들어 해당 국가에서 단순히 운영하는 외국 회사는 제외합니다. 이는 모든 fetch-entities / fetch-entities-statistics 비즈니스 쿼리의 기본값이며 사용자가 구성할 수 없습니다.

제한

도구	제한
`match-business`	호출당 50개
`match-prospects`	호출당 40개
`enrich-business`	호출당 50개 ID
`enrich-prospects`	호출당 50개 ID
`fetch-businesses-events` / `fetch-prospects-events`	배치 시 요청당 최대 20개 ID. `event_types` 및 `timestamp_from`를 전달하십시오. 연결 시 ID는 소스 CSV에서 가져오고 인라인 ID 배열이 아닙니다.

문제 해결

오류	해결 방법
인증, 커넥터 설정, CLI 호출, 플래그 또는 연결 구문	플랫폼 테이블에서 일치하는 플랫폼 가이드 읽기
빈 결과	필터 값 확인, 통제 어휘 필드에 대해 `autocomplete` 실행, 도구의 입력 스키마 다시 읽기
`linkedin_category` + `naics_category` 함께 사용	상호 배타적 — 하나만 사용
임의 생성되거나 확인되지 않은 매개변수	호출 전에 라이브 입력 스키마 다시 읽고, 확인된 필드에서만 인수 구성

지원

사용자가 지원 관련 질문(예: 지원팀에 연락하는 방법, 연락 대상, 문제 발생 또는 작동 중단 등)을 하는 경우 간략하게 답변하고 이곳을 안내하십시오. Explorium 내부를 깊이 파고들거나 지나치게 설명하지 마십시오.

지원이 필요하시면 문의 페이지를 통해 Vibe Prospecting 팀에 연락해 주십시오:

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

vibe-prospecting