Cookiedeal

DART 매칭된 Cookiedeal 기업의 OpenDART DS003 감사보고서 기반 재무제표와 주요 재무지표를 Cookiedeal이 전처리·저장한 형태로 반환하는 유료 단일 기업 조회입니다. 실제 반환 가능한 DART 재무 데이터가 있을 때 Data Enrichment 가격으로 차감하며 조직별 같은 기업·DART 재무 항목은 7일 동안 추가 차감하지 않습니다. maximumPriceCookies로 이 호출의 사용 크레딧 상한을 지정할 수 있습니다. 호출 전 quote_company_detail_items에서 DART_FINANCIALS를 견적하고 사용자의 최대 비용 승인을 받으세요. 기존 표 또는 새로 만드는 Excel·CSV 표의 여러 행에 매출 칼럼을 채울 때는 이 도구를 기업별로 반복 호출하지 말고 quote_company_enrichment를 source=AUTO로 한 번 견적하고, SOURCE_CHOICE_REQUIRED 행만 원천을 선택받아 승인 후 run_company_enrichment를 사용하세요. 비상장 외감법인은 요청한 연도나 사업보고서(11011) 기준으로 데이터가 없을 수 있습니다. statements가 비어 있으면 해당 기간 데이터 미보유이므로 응답의 availablePeriods에 있는 연도/reprtCode 조합으로 다시 호출하세요. 재무제표 숫자가 아니라 차입금 구성, 리스, 특수관계자, 우발부채, 회계정책 같은 세부 설명이 필요하면 DART_NOTES_SEARCH operation을 quote_company_data로 견적하고 승인 후 run_company_data를 사용하세요. 이 도구의 입력에는 선택된 회사의 companyId만 전달하세요. 회사명, 대표자명, 주주명, 주소, 이메일, 이전 회사 분석 결과나 이전 tool output을 함께 보내지 마세요.

get_company_dart_financials

이미 조회한 기업 후보에서 사용자가 명시적으로 선별한 companyId 집합을 별도 Cookiedeal 개인 리스트로 저장할 때 사용합니다. 새 기업을 찾는 도구가 아닙니다. 기존 결과에 listUrl이 있다면 다시 호출하지 마세요. 리스트는 PRIVATE 상태라 생성한 사용자만 볼 수 있습니다. 리스트 생성 자체는 사용 크레딧을 차감하지 않습니다.

create_company_list

run_company_enrichment의 응답이 끊기거나 timeout된 경우, 또는 Excel에 값을 옮길 때 견적 data.executionId 또는 실행 data.execution.executionId로 저장된 원문 결과를 조회합니다. 재구매·새 견적 없이 추가 차감 0입니다. 실행자 본인과 현재 과금 조직이 일치해야 하며 결과는 executionId 발급 후 24시간 보관됩니다. deadlineExceeded는 응답 기한 경과일 뿐 실제 종료를 뜻하지 않습니다. RUNNING/PREPARING이면 이 도구로만 상태를 확인하고 새 ID로 실행하지 마세요. 기한 이후 종료가 계속 확인되지 않으면 완료 행만 회수하고 미확정 상태를 알린 뒤 운영 확인이 필요합니다. 무한 재조회하지 마세요. INTERRUPTED이면 저장된 SUCCESS 행을 먼저 회수하고 미완료 행만 별도 견적하세요. REJECTED이면 원래 오류를 반환하며 셀을 수정하지 않습니다. spreadsheet.values는 rowKeys와 fieldCodes 순서의 원문 배열이며 writableRows=true인 행만 쓰세요. false 행의 기존 셀과 행 위치는 보존하세요. 값을 모델이 재작성하지 말고 클라이언트가 지원하면 직접 전달하세요. 쓴 셀을 다시 읽어 verify_company_enrichment_cells로 검증할 수 있습니다.

get_company_enrichment_result

웹 채팅과 Excel 모두 주소 요청은 quote_company_enrichment에 fields=["ADDRESS"], source="COOKIEDEAL"을 사용하세요. 저장 리스트 전체 주소는 검색 결과 data.list.listId 또는 listUrl의 listId만 전달하고 rows를 만들지 마세요. 본인·현재 조직의 PRIVATE 리스트만 허용하며 최대 100행입니다. 승인 후 같은 listId와 견적의 data.list.snapshot을 listSnapshot으로 전달해 run_company_enrichment를 호출하세요. 기존 Excel 행 또는 특정 기업만 조회할 때는 대신 알려진 companyId 또는 원문 사업자번호와 rowKey를 담은 rows 전체를 사용합니다. 주소를 얻기 위해 PUBLIC_SUMMARY나 quote_company_detail_items를 반복 호출하지 마세요. 기업개요가 있어도 주소가 없으면 MISSING·0쿠키입니다. listId 입력은 billing.maximumQuotedCookies와 상태별 건수를 보여준 뒤 비용 승인을 받으세요. rows 입력의 분할·견적 합산·비용 승인은 quote_company_enrichment의 공통 배치 규칙을 따르세요. 회사 수에 단가를 곱해 추정하지 마세요. 실행에는 같은 fields·source와 승인된 maximumPriceCookies를 전달하고 rows[].values.ADDRESS.value의 실제 주소를 사용하세요. 리스트 구성·순서가 바뀌면 다시 견적·승인하며 저장 리스트의 셀은 수정하지 않습니다. 이용권 상태만으로 주소를 가져왔다고 설명하지 마세요. 명시적 요청 없이 Excel 작성이나 리스트 재검색으로 전환하지 마세요. 주소의 기준일은 알 수 없으므로 현재 영업 소재지로 단정하지 마세요. Cookiedeal 정규화 기업 데이터의 단일 기업 견적 도구입니다. 과금하거나 데이터를 반환하지 않으며 chargeCookies, billableItemCodes, alreadyPurchasedItemCodes, unavailableItemCodes를 반환합니다. get_company_financials는 MAJOR_FINANCIAL_SUMMARY, SEPARATE_FINANCIAL_STATEMENTS, CONSOLIDATED_FINANCIAL_STATEMENTS, FINANCIAL_RATIOS를 함께 견적하고, get_company_dart_financials는 DART_FINANCIALS, get_company_shareholders는 SHAREHOLDER_STATUS, get_company_executives는 EXECUTIVES, get_company_supply_chain은 MAJOR_PARTNERS를 견적하세요. 견적 후 해당 전용 유료 조회 도구에 승인한 maximumPriceCookies를 전달하세요. 기존 표 또는 새로 만드는 Excel·CSV 표의 여러 행을 보강할 때는 quote_company_enrichment를 사용하세요. 응답에는 후속 MCP 호출에 필요한 내부 식별자와 Cookiedeal 제공 기업 데이터가 포함될 수 있습니다.

quote_company_detail_items

단일 기업의 공개 요약, DART 소유·주주, 인물·임직원, 자본·증권, 공시 이벤트, 공시 보고서·목차·섹션·XBRL fact 데이터를 조회하기 전에 가용성과 조직 이용권을 기준으로 최대 비용을 견적합니다. DART_REPORT_*와 DART_FINANCIAL_FACTS는 기존 DART 공시 보고서·주석 이용권을 함께 사용하며 실제 가격은 견적 결과가 기준입니다. 실제 원천 payload는 반환하지 않고 크레딧도 차감하지 않습니다. operation별 값이 없으면 MISSING으로 견적하며, source 조회가 실패하면 payload 대신 availabilityError를 반환합니다. data.hasDeliverableData=false이면 승인 요청이나 run_company_data 호출 없이 조회 조건 또는 기업을 바꿔 다시 견적하고, 값이 있을 때만 승인 후 같은 operation, companyId, parameters와 quoteFingerprint로 run_company_data를 호출하세요.

quote_company_data

rows 입력은 호출당 최대 100행이며 전체 Excel 표의 행 수 상한은 아닙니다. 100행 초과 표는 최초 견적 전에 원래 순서와 rowKey를 유지해 최대 100행씩 분할하세요. 아래에서 한 번 견적·실행한다는 말은 배치별로 한 번이라는 뜻입니다. rows 입력의 비용 승인: 단일 배치는 data.source, billing.maximumQuotedCookies와 처리 상태별 건수를 보여주고 최대 비용에 대한 명시적 승인을 받으세요. 여러 배치는 모든 배치를 먼저 견적한 뒤 각 data.source, 상태별 건수와 billing.maximumQuotedCookies의 합계를 전체 최대 비용으로 보여주고 한 번 승인받으세요. 중간 배치 견적에서 승인을 기다리며 멈추지 마세요. SOURCE_CHOICE_REQUIRED 행의 원천 선택도 비용 승인 전에 완료하세요. 기업 수×단가로 비용을 추정하지 마세요. 특정 사업연도 매출을 대량으로 채울 때는 모든 배치에 fields=["REVENUE_BY_FISCAL_YEAR"], 같은 fiscalYear, source=AUTO, sourcePolicy=DART_THEN_COOKIEDEAL을 사용하세요. 서버가 DART의 해당 연도 값부터 확인하고 MISSING 행만 COOKIEDEAL로 폴백하므로 사용자에게 행별 원천을 선택받지 마세요. 실행에는 견적의 data.executionId·data.quoteFingerprint·data.sourcePlan을 그대로 복사하세요. 실행 직전 서버가 같은 정책으로 전체 배치를 다시 계산하며 지문이나 원천 계획이 달라지면 차감하지 않습니다. DART ERROR는 MISSING이 아니므로 폴백하거나 성공으로 처리하지 마세요. 비용 승인 전에는 run_company_enrichment를 실행하지 말고, 승인 전에는 표의 헤더나 셀을 수정하지 마세요. 승인 후 각 실행의 maximumPriceCookies에는 전체 합계가 아닌 그 배치에 승인된 견적 금액을 전달하세요. 승인 범위가 같은 남은 배치는 추가 승인 없이 이어서 실행하세요. 새 비용이나 원천 선택이 승인 범위를 벗어나면 다시 승인받으세요. 배치마다 견적 data.executionId를 run_company_enrichment의 executionId로 복사하세요. DART_THEN_COOKIEDEAL 실행은 data.quoteFingerprint도 그대로 전달하세요. 같은 ID의 입력은 변경할 수 없습니다. 가격·원천 계획 거절 후 입력을 수정하려면 해당 배치만 다시 견적해 새 executionId와 quoteFingerprint를 받으세요. timeout·통신 오류·응답 유실은 새 ID로 재구매하지 말고 get_company_enrichment_result(executionId)로 기존 결과부터 확인하세요. 결과는 executionId 발급 후 24시간 보관하며 재조회 차감은 0, 원래 실행의 누적 차감은 execution.chargedCookies입니다. 실행에는 해당 배치의 견적과 같은 전체 rows·rowKey·순서·fields·source·fiscalYear·sourcePolicy를 유지하세요. 사용하지 않은 선택 인자는 새로 추가하지 마세요. MISSING·UNMATCHED·ERROR 행도 rows에서 빼지 말고, AUTO의 sourcePlan에서만 제외하세요. 성공한 배치는 다시 실행하지 말고 최종 차감액은 각 실행의 billing.chargedCookiesForThisCall을 합산하세요. 이 분할 규칙은 rows 입력에만 적용합니다. listId 전체 보강은 기존 100행 상한과 listSnapshot 계약을 유지하며 리스트를 임의 분할하거나 미리보기로 전체 rows를 재구성하지 마세요. 웹 채팅과 Excel 모두 주소 요청은 quote_company_enrichment에 fields=["ADDRESS"], source="COOKIEDEAL"을 사용하세요. 저장 리스트 전체 주소는 검색 결과 data.list.listId 또는 listUrl의 listId만 전달하고 rows를 만들지 마세요. 본인·현재 조직의 PRIVATE 리스트만 허용하며 최대 100행입니다. 승인 후 같은 listId와 견적의 data.list.snapshot을 listSnapshot으로 전달해 run_company_enrichment를 호출하세요. 기존 Excel 행 또는 특정 기업만 조회할 때는 대신 알려진 companyId 또는 원문 사업자번호와 rowKey를 담은 rows 전체를 사용합니다. 주소를 얻기 위해 PUBLIC_SUMMARY나 quote_company_detail_items를 반복 호출하지 마세요. 기업개요가 있어도 주소가 없으면 MISSING·0쿠키입니다. listId 입력은 billing.maximumQuotedCookies와 상태별 건수를 보여준 뒤 비용 승인을 받으세요. rows 입력의 분할·견적 합산·비용 승인은 quote_company_enrichment의 공통 배치 규칙을 따르세요. 회사 수에 단가를 곱해 추정하지 마세요. 실행에는 같은 fields·source와 승인된 maximumPriceCookies를 전달하고 rows[].values.ADDRESS.value의 실제 주소를 사용하세요. 리스트 구성·순서가 바뀌면 다시 견적·승인하며 저장 리스트의 셀은 수정하지 않습니다. 이용권 상태만으로 주소를 가져왔다고 설명하지 마세요. 명시적 요청 없이 Excel 작성이나 리스트 재검색으로 전환하지 마세요. 주소의 기준일은 알 수 없으므로 현재 영업 소재지로 단정하지 마세요. 기존 표 또는 SPREADSHEET 검색으로 새로 만들 Excel·CSV 표를 배치당 최대 100행씩 견적하는 도구입니다. rowKey와 원문 사업자번호만으로 보강할 수 있으며 companyId 칼럼을 새로 만들 필요가 없습니다. 번호가 없는 행은 companyId만 전달하고, 기존 표에 두 식별자가 함께 있다면 둘 다 전달하세요. 불일치 시 원인을 확인하고 하나를 임의로 버려 재시도하지 마세요. 각 행을 resolve_company, get_company_financials, get_company_dart_financials 또는 다른 단일 기업 도구로 개별 조회하지 마세요. "2025년 매출"처럼 연도를 명시한 대량 요청은 fields=["REVENUE_BY_FISCAL_YEAR"], fiscalYear="2025", source=AUTO, sourcePolicy=DART_THEN_COOKIEDEAL을 사용하세요. 서버가 DART의 해당 연도 값을 먼저 확인하고 정상 조회 결과가 없는 행만 COOKIEDEAL을 확인하므로 행별 원천을 사용자에게 묻지 않습니다. 이 정책의 실행에는 견적의 data.executionId·data.quoteFingerprint·data.sourcePlan을 그대로 복사하세요. 실행 직전 같은 정책으로 전체 배치를 다시 확인하며 견적과 원천·가용성·이용권·가격이 달라지면 차감하지 않습니다. 사용자가 최신 매출의 원천을 명시하지 않았다면 기존처럼 배치별로 source를 생략하거나 AUTO로 정확히 한 번 호출하세요. 기존 AUTO는 값이 있는 원천이 행마다 하나뿐이면 그 원천을 자동 선택하고, 둘 다 있으면 해당 행만 SOURCE_CHOICE_REQUIRED로 반환합니다. 이때 두 원천을 다시 따로 견적하지 말고 SOURCE_CHOICE_REQUIRED 행에 대해서만 사용자에게 원천을 선택받으세요. 사용자가 원천을 명시했다면 배치별로 해당 COOKIEDEAL 또는 DART source로 정확히 한 번 견적하며 기존 명시 원천 흐름은 그대로 유지합니다. 비용 승인은 공통 배치 규칙을 따르세요. 비용 승인 후 AUTO 실행에서는 배치별로 selectedSource가 있는 모든 실행 가능 행과 사용자가 선택한 SOURCE_CHOICE_REQUIRED 행의 원천을 sourcePlan에 담아 해당 배치의 같은 전체 rows·fields·fiscalYear·sourcePolicy, source=AUTO 및 해당 배치에 승인된 maximumPriceCookies로 run_company_enrichment를 정확히 한 번 호출하세요. 명시 원천 실행에서는 견적과 같은 source·rows·fields·fiscalYear를 사용합니다. 값은 반환하지 않고 사용 크레딧도 차감하지 않습니다. 사업자등록번호를 정확히 매칭하며, 같은 기업이 여러 행에 있어도 기업·원천별 과금 데이터셋당 한 번만 견적에 포함합니다. ADDRESS 단독, REPRESENTATIVE_NAME 단독, 지정 사업연도 매출(REVENUE_BY_FISCAL_YEAR) 또는 최근 결산기 매출 필드(REVENUE_LATEST, REVENUE_PREVIOUS, REVENUE_TWO_PERIODS_AGO)를 지원합니다. 대표자명은 COOKIEDEAL만 지원하며 개인사업자와 법인 모두 보강 대상입니다. 매출 필드는 선택한 source의 재무정보 가격 항목과 7일 이용권을 기업별로 공유합니다. DART도 Cookiedeal이 전처리·저장해 제공하는 별도 유료 데이터 원천입니다. get_company_public_summary의 availableSections나 accessEvaluation을 보강 가능 여부로 해석하지 말고 이 도구의 rows.status와 billing.maximumQuotedCookies를 보강 가능 여부와 견적의 기준으로 사용하세요. 목록 탐색이나 Cookiedeal 리스트 생성 요청에는 사용하지 마세요.

quote_company_enrichment

기존 PRIVATE 리스트에서 조건에 맞는 기업을 제외하기 전에 대상 건수와 남을 건수를 확인합니다. 새 리스트를 만들지 않습니다. 최대 10,000개 기업, 현재 조직의 본인 소유 PRIVATE 리스트만 지원하며 활성 구독에 포함되어 추가 크레딧은 0입니다. filters의 지역·업종·매출(억원)·직원수 조건에 일치하는 기업이 제거 대상입니다. 유지할 조건과 혼동하지 마세요. 수도권은 서울·인천·경기입니다. 지역 미상 기업을 보존하려면 수도권 외 지역을 regionList로 명시하세요. excludeRegionList는 지역 미상도 선택할 수 있습니다. 리스트 링크, 조건, 제외 건수와 남을 건수를 보여주고 사용자 확인을 기다리세요. 확인 전에는 apply_company_list_removal을 호출하지 마세요. 확인 기한은 15분입니다.

preview_company_list_removal

선택된 법인의 등기 열람 가격과 7일 재열람 가능 여부를 확인합니다. 크레딧을 차감하거나 열람 요청을 생성하지 않습니다. billing.maximumQuotedCookies를 사용자에게 보여주고 승인받은 뒤 같은 companyId와 recordKind로 request_corporate_registry_view를 호출하세요.

quote_corporate_registry_view

이미 결제하거나 유효한 재열람권으로 요청한 법인등기부등본 PDF 상태를 추가 차감 없이 조회합니다. 요청이 아직 PENDING/FETCHING이면 가능한 경우 완료까지 잠시 기다린 뒤 결과를 반환합니다. COMPLETED이면 PDF 다운로드 URL과 모델이 PDF를 분석할 때 따라야 할 한국어 분석 가이드를 반환합니다. 링크가 만료되었거나 사용자가 다른 대화를 이어간 뒤 돌아온 경우에도 이 도구로 최신 링크를 재발급받을 수 있습니다.

get_corporate_registry_view

사용자가 "법인등기부등본 확인", "법인 등기 열람", "등기부등본 떼줘", "등기부등본 원문/PDF 조회"처럼 특정 회사의 법인등기부등본 원문 확인을 요청하면 이 도구를 사용합니다. 활성 구독 MCP 과금 조직의 사용 크레딧을 자동 차감해 인터넷등기소 법인등기부등본 열람본 PDF 생성을 요청하고 다운로드 링크를 제공합니다. 단, 이 도구는 법적 효력이 있는 발급본을 발급하지 않고 열람본 PDF만 제공합니다. 법인등기부등본은 법인만 대상이며 개인사업자는 제외됩니다. 단일 기업 요청에서는 기업 후보 응답에서 사용자가 선택한 companyId만 사용하세요. 프리트라이얼 구독 조직은 법인/부동산 등기 열람 합산 최초 1회만 사용할 수 있습니다. 신규 요청은 비동기 처리되지만 이 도구가 가능한 경우 완료까지 잠시 기다려 COMPLETED와 PDF 링크를 같은 응답으로 반환합니다. 그래도 처리 중이면 PENDING/FETCHING과 registryViewId를 반환하므로 이후 get_corporate_registry_view 또는 get_latest_corporate_registry_view_for_company로 상태와 PDF 링크를 다시 확인하세요.

request_corporate_registry_view

사용자가 부동산등기사항증명서, 부동산등기부등본, 등기기록, 소유자/근저당/압류/전세권 확인처럼 특정 부동산의 등기 열람을 요청하면 먼저 이 도구로 후보를 검색합니다. 이 도구는 검색 전용이라 크레딧을 차감하지 않습니다. 주소, 지번, 도로명주소처럼 사람이 입력한 주소성 검색어는 웹과 동일하게 기본 SIMPLE 간편검색을 사용하세요. PROPERTY_UNIQUE_NUMBER는 사용자가 부동산고유번호를 명시한 경우에만 사용하세요. 검색어가 주소 일부처럼 모호하면 반환된 후보 전체를 소재지, 부동산고유번호, 구분, 상태로 보여주고 사용자가 특정 후보를 선택하게 하세요. 후보가 너무 많거나 원하는 부동산이 불명확하면 동/호수, 지번, 도로명주소, 부동산고유번호, 토지/건물/집합건물 구분을 추가로 물어보세요. 후보가 1개여도 사용자가 명시적으로 열람을 요청한 경우에만 request_real_estate_registry_view로 진행하세요. 응답에는 후속 상태 조회용 내부 ID, 후보 선택 ID, 서명된 PDF 다운로드 링크가 포함될 수 있습니다.

search_real_estate_registry_properties

선택된 부동산의 등기 열람 가격과 7일 재열람 또는 진행 중 요청 여부를 확인합니다. 크레딧을 차감하거나 열람 요청을 생성하지 않습니다. quote.maximumQuotedCookies를 사용자에게 보여주고 승인받은 뒤 같은 선택 값으로 request_real_estate_registry_view를 호출하세요.

quote_real_estate_registry_view

이미 결제하거나 유효한 재열람권으로 요청한 부동산등기사항증명서 PDF 상태를 추가 차감 없이 조회합니다. 요청이 아직 PENDING/FETCHING이면 가능한 경우 완료까지 잠시 기다린 뒤 결과를 반환합니다. COMPLETED이면 PDF 다운로드 URL과 모델이 PDF를 분석할 때 따라야 할 한국어 분석 가이드를 반환합니다. 링크가 만료되었거나 사용자가 다른 대화를 이어간 뒤 돌아온 경우에도 이 도구로 최신 링크를 재발급받을 수 있습니다. 응답에는 후속 상태 조회용 내부 ID, 후보 선택 ID, 서명된 PDF 다운로드 링크가 포함될 수 있습니다.

get_real_estate_registry_view

search_real_estate_registry_properties로 특정된 단일 부동산 후보에 대해 인터넷등기소 부동산등기사항증명서 열람본 PDF 생성을 요청하고 다운로드 링크를 제공합니다. 활성 구독 MCP 과금 조직의 사용 크레딧을 자동 차감합니다. 프리트라이얼 구독 조직은 법인/부동산 등기 열람 합산 최초 1회만 사용할 수 있습니다. 이 도구는 법적 효력이 있는 발급본이 아니라 열람본 PDF만 제공합니다. 신규 요청은 비동기 처리되지만 가능한 경우 완료까지 잠시 기다려 COMPLETED와 PDF 링크를 같은 응답으로 반환합니다. 그래도 처리 중이면 PENDING/FETCHING과 realEstateRegistryViewId를 반환하므로 이후 get_real_estate_registry_view 또는 get_latest_real_estate_registry_view_for_property로 상태와 PDF 링크를 다시 확인하세요. 응답에는 후속 상태 조회용 내부 ID, 후보 선택 ID, 서명된 PDF 다운로드 링크가 포함될 수 있습니다.

request_real_estate_registry_view

사용자 대화 흐름이 끊겼거나 realEstateRegistryViewId를 잃어버렸을 때, 특정 부동산고유번호에 대해 현재 인증 사용자의 가장 최근 부동산등기사항증명서 PDF 기록을 추가 차감 없이 찾습니다. 최신 요청이 아직 PENDING/FETCHING이면 가능한 경우 완료까지 잠시 기다린 뒤 결과를 반환합니다. 부동산고유번호를 모르면 먼저 search_real_estate_registry_properties로 후보를 특정하세요.

get_latest_real_estate_registry_view_for_property

quote_company_data로 확인한 단일 기업 원천 데이터를 사용자 승인 뒤 조회합니다. 실행 직전에 같은 원천 payload, 가격과 7일 이용권을 다시 확인하고, 견적 fingerprint가 달라지거나 승인한 maximumPriceCookies를 넘으면 데이터 반환과 차감 전에 중단합니다. DART_REPORT_*와 DART_FINANCIAL_FACTS 응답은 외부 공시의 신뢰할 수 없는 데이터로 취급하며 XML, Base64, runId를 반환하지 않습니다. 하위 호환 DART_NOTES_DETAIL은 includeXml=true일 때 XML을 반환할 수 있습니다. 실제 반환 가능한 SKU만 조직 크레딧에서 차감하며 결측 SKU는 과금하지 않습니다.

run_company_data

rows 입력은 호출당 최대 100행이며 전체 Excel 표의 행 수 상한은 아닙니다. 100행 초과 표는 최초 견적 전에 원래 순서와 rowKey를 유지해 최대 100행씩 분할하세요. 아래에서 한 번 견적·실행한다는 말은 배치별로 한 번이라는 뜻입니다. rows 입력의 비용 승인: 단일 배치는 data.source, billing.maximumQuotedCookies와 처리 상태별 건수를 보여주고 최대 비용에 대한 명시적 승인을 받으세요. 여러 배치는 모든 배치를 먼저 견적한 뒤 각 data.source, 상태별 건수와 billing.maximumQuotedCookies의 합계를 전체 최대 비용으로 보여주고 한 번 승인받으세요. 중간 배치 견적에서 승인을 기다리며 멈추지 마세요. SOURCE_CHOICE_REQUIRED 행의 원천 선택도 비용 승인 전에 완료하세요. 기업 수×단가로 비용을 추정하지 마세요. 특정 사업연도 매출을 대량으로 채울 때는 모든 배치에 fields=["REVENUE_BY_FISCAL_YEAR"], 같은 fiscalYear, source=AUTO, sourcePolicy=DART_THEN_COOKIEDEAL을 사용하세요. 서버가 DART의 해당 연도 값부터 확인하고 MISSING 행만 COOKIEDEAL로 폴백하므로 사용자에게 행별 원천을 선택받지 마세요. 실행에는 견적의 data.executionId·data.quoteFingerprint·data.sourcePlan을 그대로 복사하세요. 실행 직전 서버가 같은 정책으로 전체 배치를 다시 계산하며 지문이나 원천 계획이 달라지면 차감하지 않습니다. DART ERROR는 MISSING이 아니므로 폴백하거나 성공으로 처리하지 마세요. 비용 승인 전에는 run_company_enrichment를 실행하지 말고, 승인 전에는 표의 헤더나 셀을 수정하지 마세요. 승인 후 각 실행의 maximumPriceCookies에는 전체 합계가 아닌 그 배치에 승인된 견적 금액을 전달하세요. 승인 범위가 같은 남은 배치는 추가 승인 없이 이어서 실행하세요. 새 비용이나 원천 선택이 승인 범위를 벗어나면 다시 승인받으세요. 배치마다 견적 data.executionId를 run_company_enrichment의 executionId로 복사하세요. DART_THEN_COOKIEDEAL 실행은 data.quoteFingerprint도 그대로 전달하세요. 같은 ID의 입력은 변경할 수 없습니다. 가격·원천 계획 거절 후 입력을 수정하려면 해당 배치만 다시 견적해 새 executionId와 quoteFingerprint를 받으세요. timeout·통신 오류·응답 유실은 새 ID로 재구매하지 말고 get_company_enrichment_result(executionId)로 기존 결과부터 확인하세요. 결과는 executionId 발급 후 24시간 보관하며 재조회 차감은 0, 원래 실행의 누적 차감은 execution.chargedCookies입니다. 실행에는 해당 배치의 견적과 같은 전체 rows·rowKey·순서·fields·source·fiscalYear·sourcePolicy를 유지하세요. 사용하지 않은 선택 인자는 새로 추가하지 마세요. MISSING·UNMATCHED·ERROR 행도 rows에서 빼지 말고, AUTO의 sourcePlan에서만 제외하세요. 성공한 배치는 다시 실행하지 말고 최종 차감액은 각 실행의 billing.chargedCookiesForThisCall을 합산하세요. 이 분할 규칙은 rows 입력에만 적용합니다. listId 전체 보강은 기존 100행 상한과 listSnapshot 계약을 유지하며 리스트를 임의 분할하거나 미리보기로 전체 rows를 재구성하지 마세요. 사용자가 Excel·CSV 작성을 요청한 경우에만 적용하세요. 웹 답변을 Excel 작성이나 파일 다운로드로 전환하지 마세요. 성공한 MCP 응답을 원본으로 보존하고 rowKey로 원래 행에 연결하세요. 클라이언트가 도구 결과를 코드에서 직접 참조할 수 있을 때는 실제 values[fieldCode].value를 그대로 배열로 옮기세요. 지원 여부가 확인되지 않은 직접 참조·다운로드·코드 실행 도구를 만들어내지 마세요. 대표자명·주소는 디코딩된 반환 문자열 그대로 텍스트 셀에 쓰세요. 이름 추정·교정·번역·음역이나 수동 유니코드 이스케이프 변환을 하지 마세요. 매출은 반환된 KRW 숫자를 유지하세요. 사용 가능한 Excel 쓰기 도구의 입력 스키마를 확인한 뒤 범위 단위로 쓰세요. 여러 배치 결과를 프로그램으로 안전하게 병합할 수 있으면 300행×1열도 2차원 배열로 한 번에 쓰고, 도구가 지원하지 않으면 지원되는 범위 크기로 나누세요. 셀마다 도구를 호출하지 마세요. 쓰기 전 원래 행과 식별자가 유지되는지 확인하고, 데이터가 없는 행도 자리를 남겨 뒤 행이 당겨지지 않게 하세요. 실행 응답의 data.execution.executionId로 get_company_enrichment_result를 호출하면 rowKeys·fieldCodes·values와 writableRows로 된 원문 범위 배열을 받을 수 있습니다. writableRows=true인 행만 쓰고 false인 미확정·실패 행의 기존 셀은 보존하세요. null 자리 때문에 미확정 셀을 비우거나 행을 당기지 마세요. 기존 실행을 다시 구매하지 마세요. deadlineExceeded=true는 응답 기한 경과일 뿐 실행 종료가 아니며 RUNNING/PREPARING에서 새 ID로 재실행하면 안 됩니다. 쓴 범위를 실제로 한 번 읽어 배치별 executionId와 전체 rowKey·셀 values를 verify_company_enrichment_cells로 보내 원문과 대조하세요. matches=true만으로 완료를 선언하지 말고 executionComplete=true와 skippedRows가 비어 있는지 확인하세요. skippedRows의 기존 셀은 수정하지 마세요. 직접 원본과 대조하는 경우에도 불일치한 셀만 수정·재검증하세요. 전체 구간을 기억에 의존해 다시 작성하지 마세요. 코드로 비교하지 않았다면 기계적으로 검증했다고 말하지 말고, 확인하지 못한 행은 미검증으로 구분하세요. 저장 리스트 전체 주소는 rows 대신 견적과 같은 listId와 data.list.snapshot을 listSnapshot으로 전달하세요. 리스트가 바뀌면 차감 없이 중단하므로 재견적·재승인하세요. 주소 조회 결과는 rows[].values.ADDRESS.value에 담긴 실제 주소입니다. rowKey로 기존 기업에 연결해 웹에서 답하거나 요청된 Excel 셀에 쓰세요. 주소가 없으면 MISSING이며 차감하지 않습니다. 이용권만 구매되고 주소를 못 받은 것으로 해석하지 마세요. quote_company_enrichment로 견적하고 사용자가 승인한 한 배치의 전체 행(최대 100행)을 실행하는 도구입니다. 사전에 resolve_company, get_company_financials, get_company_dart_financials 또는 다른 단일 기업 도구를 호출하지 마세요. AUTO 견적은 source=AUTO, 같은 전체 rows·fields·fiscalYear·sourcePolicy, selectedSource가 있는 모든 실행 가능 행과 사용자가 선택한 SOURCE_CHOICE_REQUIRED 행의 정확한 sourcePlan, 승인된 maximumPriceCookies로 한 번 실행하세요. DART_THEN_COOKIEDEAL 정책에서는 data.executionId·data.quoteFingerprint·data.sourcePlan을 그대로 복사하고 행별 선택을 다시 묻지 마세요. 서버는 실행 직전 DART 우선 폴백을 독립적으로 다시 계산하며, 견적 지문이나 sourcePlan이 달라지면 어떤 기업도 차감하지 않습니다. MISSING·UNMATCHED·ERROR 행은 sourcePlan에서 제외합니다. 원천이 명시된 견적은 동일한 COOKIEDEAL 또는 DART source·rows·fields·fiscalYear와 승인된 maximumPriceCookies로 실행하며 sourcePlan을 전달하지 않습니다. 성공 응답 뒤에는 같은 배치를 반복 실행하지 마세요. 행마다 selectedSource와 실제 값의 source를 확인하세요. 대표자명은 COOKIEDEAL만 지원하며 개인사업자와 법인 모두 조회 대상입니다. 매출액 value는 KRW 숫자이고 fiscalYear는 실제 사업연도입니다. REVENUE_BY_FISCAL_YEAR는 요청 fiscalYear와 정확히 일치하는 값만 채우세요. COOKIEDEAL 매출은 실제 asOfDate를 제공하며, DART 매출은 statementScope를 제공하지만 정규화 데이터에 확정 결산일이 없으므로 asOfDate가 null입니다. DART 값에 12월 31일 같은 날짜를 추정하지 마세요. 요청한 과거 결산기 값이 없으면 해당 필드는 비워 두세요. 실제 요청 값이 반환되는 고유 기업만 과금하며, 매출 필드는 선택한 source의 재무정보 가격 항목을 공유합니다. 같은 기업의 같은 원천·과금 데이터셋은 조직에서 7일 동안 재사용되고 중복 행에는 한 번만 차감합니다. rows.status의 MISSING은 요청 필드 전체가 정상 조회 후 값 없음, ERROR는 실행 실패이므로 서로 구분하고 ERROR 행은 재시도 대상으로 안내하세요. 공통 배치 규칙에 따라 비용 승인 후 실행하며 maximumPriceCookies에는 해당 배치에 승인된 견적 금액만 설정하세요. 목록 탐색이나 Cookiedeal 리스트 생성 요청에는 사용하지 마세요.

run_company_enrichment

쿠키딜(Cookiedeal)에서 한국 기업·회사·병원·의원을 찾는 기본 검색 도구입니다. Company search, hospital/clinic discovery. 지역·업종·키워드, 최근 투자유치, 진행 중 회생·파산, canonical IT 솔루션 사용 조건의 목록과 매출 상위 기업을 찾을 때 호출하세요. 기간 없는 최근 투자는 fundingWithinDays=90을 사용합니다. 활성 구독(무료체험 포함)이 필요하며 추가 크레딧은 0입니다. 사전 견적이나 비용 승인은 필요 없습니다. 웹은 resultMode=CREATE_LIST(기본값)로 최대 10,000개를 본인만 보는 PRIVATE 리스트에 저장합니다. 개수 미지정 시 page/take/listLimit을 생략하고, 상위 N개 요청에만 listLimit=N을 지정하세요. 최대 5개 미리보기와 listUrl을 반드시 보여주고 같은 리스트를 중복 생성하지 마세요. SPREADSHEET는 실제 Excel·CSV 작성 요청에만 사용하며 최대 100개는 take=N으로 한 번에 조회하세요. RETURN_ONLY는 명시적 미저장 비교 또는 단일 기업 식별에만 사용하세요. 상세 규칙은 resultMode 설명을 따르세요. 기존 표의 칼럼 추가와 100개 이하 저장 리스트 전체 주소 조회는 quote_company_enrichment로 견적하고 사용자 비용 승인 후 run_company_enrichment로 진행하세요. 100개 초과 리스트는 전체 보강을 제안하거나 자동 분할하지 마세요. 검색에는 유료 상세 값이 포함되지 않습니다. appliedFilters를 사용자 요청 조건과 비교하세요. 재무 필터 숫자는 억원, fundingAmountMinKrw/MaxKrw는 원입니다. 조건이 빠졌거나 오류가 나면 임의로 조건을 빼고 성공으로 안내하지 마세요. 결과가 의심스러우면 meta.supportReference를 문의 참조 번호로 알려주세요. 매출 순위는 sortBy="REVENUE:desc"를 사용하세요. 검색 총수와 저장 수를 구분하고 hasUnsavedResults=true이면 전체 저장으로 안내하지 마세요. 기존 page/take 호출은 해당 페이지만 저장하며 pagination.totalRelation="gte"이면 totalDisplay를 하한으로 안내하세요.

search_companies

사용자가 현재 연결된 계정, 로그인 계정, 이메일, 내 계정, who am I, connected account를 물으면 이 도구를 바로 호출하세요. 기업 검색이나 유료 데이터 견적 없이 현재 MCP에 인증된 Cookiedeal 계정의 기본 프로필, MCP 과금 조직, 소속 Pro 조직 목록, 조직별 구독 상태와 현재 기업 열람 결제 주체를 조회합니다. 전화번호, CI 등 민감한 본인확인 값은 반환하지 않습니다. billingOrganizationSelection.requiresSelection이 true이면 사용자가 구독 중인 조직 중 하나를 선택하도록 안내하고 set_billing_organization을 호출하세요.

get_my_account

preview_company_list_removal의 대상 건수와 남을 건수를 안내한 뒤 사용자가 명시적으로 확인했을 때만 실행합니다. 반환된 previewId와 confirmed=true를 전달하세요. 필터나 기업 ID를 다시 입력하거나 재검색하지 않습니다. 확인 후 리스트 기업 구성·소유권·공유 상태가 바뀌거나 15분이 지나면 다시 사전 확인해야 합니다. 리스트 자체와 남은 행의 메모·셀은 보존됩니다. 추가 크레딧은 0입니다. timeout이나 일시 오류에는 같은 previewId와 confirmed=true로 재시도하세요. 24시간 내에는 기존 완료 결과를 반환하며 추가 삭제하지 않습니다. 새 미리보기를 자동 생성하지 마세요.

apply_company_list_removal

사용자 대화 흐름이 끊겼거나 registryViewId를 잃어버렸을 때, 특정 회사에 대해 현재 인증 사용자의 가장 최근 법인등기부등본 PDF 기록을 추가 차감 없이 찾습니다. 최신 요청이 아직 PENDING/FETCHING이면 가능한 경우 완료까지 잠시 기다린 뒤 결과를 반환합니다. companyId는 기업 후보 응답에서 사용자가 선택한 값을 사용하세요. 기업 후보를 새로 찾지 않고 해당 기업의 기존 열람 기록만 조회합니다.

get_latest_corporate_registry_view_for_company