MarketPilot

지금 이 연결의 신원과 권한, 쓸 수 있는 툴 전체를 돌려줘요. 회사 데이터를 다루는 작업을 시작하기 전에 한 번 부르면, 서버에 새로 추가된 기능까지 재접속 없이 알 수 있어요. "뭘 할 수 있어?", "권한이 어떻게 돼?" 같은 질문에도 이걸 쓰세요. 어떤 툴이 안 보이면 unavailableGroups 의 reason 에 이유가 적혀 있어요.

Takes no parameters.

주문 가능한 마케팅 상품 목록(상품 ID·이름·분류·단가·최소/최대 수량)을 조회합니다. aiOrderable=false 인 상품은 결제 링크로 주문할 수 없고 웹사이트나 상담(submit_inquiry)으로 안내해야 합니다. 로그인(키) 없이도 쓸 수 있어요.

Takes no parameters.

상품 1개의 상세(단가·수량 제약)와 집행에 필요한 입력 항목(formFields)을 조회합니다. 결제 링크를 만들기 전에 수량 제약을 확인하세요.

네이버 플레이스를 업체명·키워드로 검색합니다. 사용자의 매장을 특정해 placeId·업체명·주소를 얻는 용도입니다.

카드로 결제할 수 있는 결제 링크를 만듭니다. 상품 ID 와 수량만 넣으면 금액은 서버가 계산해요(단가를 직접 넣을 수 없어요). 응답의 checkoutUrl 을 사용자에게 그대로 보여주세요. 링크를 열면 품목·금액을 확인하고 카드·간편결제로 바로 결제할 수 있고, 회원가입은 필요 없어요. 링크를 만드는 것만으로는 돈이 나가지 않아요(결제는 사용자가 링크에서 직접). 만들기 전에 반드시 상품·수량·예상 금액을 사용자에게 확인받고, 이름(또는 상호)은 사용자에게 직접 물어보세요.

결제 링크의 상태(결제 대기·결제 완료·만료)와 결제 후 만들어진 주문의 진행 상황을 확인합니다. 사용자가 "결제했어요"라고 하면 이 툴로 확인하고, setupUrl 이 있으면 집행 정보(매장 주소 등) 입력을 안내하세요.

상담·견적 문의를 접수합니다. 담당자가 영업일 1일 이내에 이메일로 회신해요. aiOrderable=false 인 상품(문의형·복잡한 견적), 원하는 게 카탈로그에 없을 때, 또는 사용자가 사람과 이야기하고 싶어할 때 사용하세요. 이름·이메일은 반드시 사용자에게 직접 물어보고 넣으세요 — 임의로 지어내면 안 돼요.

[회원가입 1단계] 사용자의 휴대폰으로 인증번호 문자를 보냅니다. 사용자가 가입을 원한다고 분명히 말했을 때만 호출하세요. 문자를 받은 사용자에게 번호를 물어본 뒤 signup 으로 넘기세요. 결제 링크(create_checkout)는 가입 없이도 쓸 수 있어요.

[회원가입 2단계] 인증번호를 확인하고 계정을 만듭니다. 아이디·비밀번호·이름은 사용자에게 직접 받으세요(임의로 짓지 마세요). 약관 동의는 사람의 의사표시예요 — 사용자에게 이용약관(https://www.marketpilot.it/terms)과 개인정보처리방침(https://www.marketpilot.it/privacy)을 안내하고 동의한다는 답을 받은 경우에만 true 로 넣으세요. 앞서 만든 결제 링크가 있으면 checkoutToken 을 같이 넣어 그 주문을 새 계정에 연결하세요.

[주문 1단계] 견적을 요청합니다. 총액·포인트 잔액·부족분과 15분 유효한 quoteToken을 돌려줍니다. 돈이 나가지 않는 안전한 호출입니다.

[주문 2단계] 견적을 확정해 실제 주문을 생성합니다. 포인트가 즉시 차감되므로, 반드시 사용자에게 상품·수량·금액을 확인받은 뒤 confirm:true로 호출하세요.

내 주문 내역을 조회합니다. status로 필터할 수 있어요 (paid=결제완료, in_progress=진행중, completed=완료, refunded=환불, stopped=중단).

주문 1건의 진행 상황을 조회합니다. status/statusLabel(결제완료→진행중→완료), phaseLabel(상품별 세부 단계), progress(수량 진행률·결과물 링크·단계 — 제공 상품만), recentLogs(진행 로그 최신순)를 반환해요. "내 주문 어떻게 돼가?" 같은 질문에 이 툴을 쓰고, progress가 null이면 statusLabel과 recentLogs로 안내하세요.

포인트 잔액을 조회합니다. 1P = 1원이며 주문 결제는 포인트로 이뤄집니다.

Takes no parameters.

포인트 충전을 신청합니다. 응답의 transfer(무통장 입금 계좌·입금자명·금액)를 사용자에게 안내하세요. 실제 이체는 사용자가 직접 해야 하며, 입금자명·금액이 일치하면 몇 분 내 자동 충전됩니다.

내 포인트 충전 신청 내역을 조회합니다.

충전 신청 1건의 상태를 확인합니다. 입금 후 status가 CONFIRMED(충전 완료)로 바뀌었는지 확인하는 용도입니다.

입금 대기(PENDING) 상태의 충전 신청을 취소합니다.

내 사업 프로필에 맞는 정부지원사업 추천 목록을 조회합니다 (접수중 공고만, 매칭 점수순). 점수 해석: 60=자격 제한 없어 누구나 지원 가능, 60~100=검증된 자격 조건이 많을수록 높음. 자격 미달 공고는 이미 제외돼 있어요. 사업이 여러 개면 profileId 로 사업별 추천을 따로 보세요 (생략 시 대표 사업). "우리 회사가 받을 수 있는 지원금 뭐 있어?" 같은 질문에 이 툴을 쓰세요. isContest 가 true(programTypeLabel "공모전")인 공고는 공모전·경진대회예요. 소개할 때 공모전이라고 밝혀 주세요.

정부지원사업 공고를 키워드·카테고리로 검색합니다 (매일 K-Startup 등에서 자동 수집된 공고 DB). 프로필이 있으면 결과에 matchScore가 함께 붙어요. 특정 사업명을 찾거나 전체를 둘러볼 때 사용하세요. isContest 가 true(programTypeLabel "공모전")인 공고는 공모전·경진대회예요. 소개할 때 공모전이라고 밝혀 주세요.

지원사업 공고 1건의 상세를 조회합니다 — 지원 내용·자격 요건·신청 URL(applyUrl)·내 매칭 점수와 조건별 판정. 사용자가 신청하고 싶어 하면 applyUrl(정부 원문 신청 페이지)로 안내하세요. 신청 자체는 사용자가 직접 해야 해요. isContest 가 true(programTypeLabel "공모전")인 공고는 공모전·경진대회예요. 소개할 때 공모전이라고 밝혀 주세요.

내 사업 프로필에 맞는 나라장터 입찰공고 추천 목록을 조회합니다 (입찰중 공고만, 매칭 점수순). 점수: 60=참가 자격 제한 없음(누구나), 60~100=업종·지역·업종등록·금액대·자격이 검증될수록 높음. 자격 미달 공고는 제외돼 있어요. "우리 회사가 들어갈 수 있는 입찰 뭐 있어?", "나라장터 용역 공고 찾아줘" 같은 질문에 쓰세요.

나라장터 입찰공고를 키워드·업무구분·지역·주제 태그로 검색합니다 (조달청 오픈API로 매일 자동 수집된 공고 DB). 프로필이 있으면 결과에 matchScore 가 함께 붙어요.

입찰공고 1건의 상세를 조회합니다: 추정가격·마감·개찰·계약방법·지역/업종 제한·참가자격등록 마감·내 매칭 점수와 조건별 판정. 사용자가 참여하려면 sourceUrl(나라장터 공고 원문)로 안내하세요. 입찰 참여 자체는 사용자가 나라장터에서 직접 해야 해요.