APICK Convert

APICK MCP — 224 Korean Data, AI, Image & Video Tools

자동차등록원부 등본은 REST 결과(/rest/get_vehicle_register_doc)에서 원본 PDF와 문서내용을 제공합니다. 전용 MCP 도구는 없습니다. For the vehicle register PDF and structured text, use the REST API or the apick-api SDK.

Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.

대한민국 사업자조회 · 신분증 진위확인 · OCR · 택배 배송조회 · 파일변환 · 웹조회 · LLM을 MCP Tool로.

[npm] [npm downloads] [MCP Registry] [License: MIT]

apick.app — Official site 공식 사이트

Integration guide 연동 가이드 · Full tool catalog 전체 Tool 목록 · API list API 목록

What is this? / 이게 뭔가요?

EN — APICK is a Korean data and AI API platform. This MCP server exposes 224 tools for Korean business data, identity verification, OCR, parcel tracking, image and video generation, file conversion, web intelligence, and LLM calls.

KO — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 Tool 224개로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 인증키 하나로 제공합니다.

The server is hosted by APICK. Nothing to install, build, or keep running. 서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.

https://apick.app/mcp/all

Quick start / 빠른 시작

1. Get an API key / 인증키 발급

Sign up at apick.app and copy your license key from the dashboard. New accounts get 1,000 free points. apick.app 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 1,000포인트 무료.

tools/list works without a key — a client can connect and discover all 224 tools before you sign up. Only tools/call validates the key and allowed IP. tools/list는 인증 없이 동작합니다. 가입 전에도 클라이언트가 연결해 224개 Tool을 확인할 수 있고, 키와 허용 IP는 tools/call부터 검증합니다.

Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as /32. Changes apply immediately with no separate synchronization. 마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(/32 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.

2. Connect / 연결

claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"

{  "mcpServers": {    "apick": {      "type": "http",      "url": "https://apick.app/mcp/all",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

{  "mcpServers": {    "apick": {      "url": "https://apick.app/mcp/all",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

{  "mcpServers": {    "apick": {      "serverUrl": "https://apick.app/mcp/all",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

{  "servers": {    "apick": {      "type": "http",      "url": "https://apick.app/mcp/all",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

{  "mcpServers": {    "apick": {      "command": "npx",      "args": ["-y", "apick-mcp", "--server", "all"],      "env": { "APICK_API_KEY": "YOUR_KEY" }    }  }}

Tool wait time / 도구 대기 시간 — Most tools finish within two minutes, but some (speech-to-text, long chats, image generation, registry document issuance) take several minutes. If your client's MCP tool timeout is short, the call is cut off before the result arrives. Set it to at least 120 seconds, or 660 seconds (11 minutes) if you use those tools. In Claude Code, add "timeout": 660000 (milliseconds) to the server entry or set MCP_TOOL_TIMEOUT=660000. For other clients, see their MCP settings. Do not resend the same request while waiting; raise the timeout and retry once.

대부분의 Tool은 2분 안에 끝나지만 음성 받아쓰기·긴 대화·그림 생성·등기 발급처럼 몇 분이 걸리는 Tool도 있습니다. 클라이언트의 MCP 도구 대기 시간이 짧으면 결과가 오기 전에 호출이 끊기므로 최소 120초, 이런 Tool을 쓴다면 660초(11분) 이상으로 두세요. Claude Code는 서버 설정 항목에 "timeout": 660000(밀리초)을 넣거나 MCP_TOOL_TIMEOUT=660000으로 늘립니다. 다른 도구는 각 도구의 MCP 설정 안내를 확인하세요. 기다리는 동안 같은 요청을 거듭 보내지 말고, 대기 시간을 늘린 뒤 한 번만 다시 보내세요.

3. Ask / 물어보기

사업자번호 439-87-00761 정상 사업자인지 확인하고 회사 정보 정리해줘Check whether Korean business number 439-87-00761 is active and summarize the company

The agent picks biz_detail, calls it, and reads back the result. AI가 알맞은 Tool(biz_detail)을 골라 호출하고 결과를 정리해 줍니다.

Servers / 서버 목록

Connect to all for everything, or to one server to keep the tool list short and the agent's choices focused. 전부 쓰려면 all, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아져 AI가 더 정확히 고릅니다.

Every tool / 전체 Tool

→ TOOLS.md — the current 224-tool inventory and detailed examples for common tools. → TOOLS.md — 현재 224개 목록과 주요 도구의 파라미터·타입·호출 예시를 정리했습니다.

Find the right tool / 알맞은 Tool 찾기 — find_tools

EN — The all server has 224 tools. find_tools recommends the best-matching APICK tools for a task described in natural language (Korean or English). It returns each tool's name, title, description and a relevance label (high, medium, low). It is free, works without an API key, and is available on the all server only; domain servers are small enough to choose from tools/list directly.

KO — all 서버에는 Tool이 224개 있습니다. find_tools는 자연어(한국어·영어)로 설명한 작업에 가장 알맞은 에이픽 Tool을 추천하고, Tool 이름·제목·설명과 관련도(high·medium·low)를 돌려줍니다. 무료이며 인증키 없이 호출할 수 있고, all 서버에서만 제공합니다. 분야별 서버는 Tool 수가 적어 tools/list만으로 고를 수 있습니다.

curl -X POST "https://apick.app/mcp/all" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_tools","arguments":{"task":"사업자등록번호로 폐업 여부 확인","limit":3}}}'

Response structuredContent / 응답 structuredContent:

{"task":"사업자등록번호로 폐업 여부 확인","tools":[{"name":"biz_detail","title":"사업자 정보 조회","description":"Look up general status information of a Korean business ...","relevance":"high"}]}

If nothing fits, tools is empty and a message asks you to describe the task more specifically. Call the recommended tool with your API key as usual. 맞는 Tool이 없으면 tools가 빈 배열이고 작업을 더 구체적으로 적어 달라는 message가 포함됩니다. 추천받은 Tool은 평소처럼 인증키로 호출하세요.

Use cases / 주요 활용 사례

1. B2B onboarding & KYB — 거래처 실사 자동화

"거래처 사업자번호 목록 검증하고, 폐업이나 휴업 있으면 표로 정리해줘" "Validate this list of Korean business numbers and flag any that are closed or suspended"

biz_detail → venture_biz_info → check_email_valid · check_phone_valid

Pull registry status, representative, industry code and address for each business number, cross-check the contact email and phone, and get one table back. Replaces manual one-by-one lookups. 사업자번호마다 사업자 상태·대표자·업종·주소를 끌어오고 담당자 이메일·전화 유효성까지 교차검증해 표 하나로 받습니다.

2. Identity verification pipeline — 비대면 신원확인

"이 신분증 이미지 진위확인하고 주민번호 뒷자리 마스킹한 사본 만들어줘" "Verify this ID document image and produce a copy with the registration number masked"

identi_card_image1 → ocr_identi1 → identity_document_id_card

Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본. 정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.

identity_document_residence_card는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다. identity_document_residence_card masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.

3. Logistics & CS automation — 배송 문의 자동응답

"운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘" "Where is tracking number 123456789012? Draft a customer notice if it's delayed"

parcel_tracking_auto → text_polish

Auto-detects the carrier from the number alone across 33 Korean carriers (CJ대한통운, 한진, 롯데, 우체국, 로젠, 쿠팡로지스틱스 …), then drafts the customer message. 운송장 번호만으로 33개 택배사를 자동 판별해 조회하고, 고객 안내문 초안까지 씁니다.

4. Document processing — 문서 파이프라인

"이 PDF들 하나로 합치고 워터마크 넣은 다음 DOCX로도 뽑아줘" "Merge these PDFs, add a watermark, and also give me a DOCX"

pdf_merge → draw_watermark_pdf → pdf_to_docx

Also: html_to_pdf for invoices and reports, json_to_excel for data exports, and stt for speech recognition. 견적서·리포트는 html_to_pdf, 데이터 내보내기는 json_to_excel, 음성 인식은 stt를 사용합니다.

5. Domain & fraud investigation — 도메인·사기 조사

"이 사이트 IP, 위치, WHOIS 조사하고 우리 사이트랑 얼마나 비슷한지 봐줘" "Investigate this site's IP, location and WHOIS, and compare it to ours"

nslookup → location → whois → ip_history → url_similarity → url_screenshot

Built for phishing and copycat-site investigation: resolve the host, trace its IP history, score how closely it clones your page, and capture a screenshot as evidence. 피싱·모방 사이트 조사용입니다. 호스트를 확인하고 IP 이력을 추적한 뒤, 우리 페이지와의 유사도를 점수화하고 증거용 스크린샷까지 남깁니다.

6. Content safety & media — 콘텐츠 검수

"업로드된 이미지 중 유해한 거 걸러내고 사람 얼굴은 블러 처리해줘" "Filter unsafe uploads and blur any faces"

nsfw_detection → face_detection → face_blur

7. Payout & account verification — 정산 계좌 검증

"정산 대상 계좌 예금주가 등록된 이름과 같은지 확인해줘" "Check that the payout account holder matches the registered name"

bank_code → account_realname → transfer_1won

account_realname reads the holder name; transfer_1won proves ownership by depositing 1 KRW with a code in the memo. account_realname은 예금주명을 읽고, transfer_1won은 적요에 인증코드를 담아 1원을 입금해 실소유를 증명합니다.

8. AI video generation — AI 영상 생성

"제품 사진으로 4초짜리 짧은 홍보 영상 만들어줘" "Turn this product photo into a short 4-second promo video"

veo_jobs_create → veo_jobs_status

Video generation (seedance_jobs_create, veo_jobs_create, kling_jobs_create) is asynchronous — submit a job, poll status, then download once it's completed via the status result's result_url. Billed per second (duration × per-second points), refunded in full on failure or timeout. 영상 생성(seedance_jobs_create, veo_jobs_create, kling_jobs_create)은 비동기입니다 — 접수 후 상태를 조회하다가 completed가 되면 상태 결과의 result_url로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.

Seedance 참조 소재 모드는 지원 버전에서 참조 이미지·영상·오디오(MP3·WAV) URL을 함께 받을 수 있습니다.

How it works / 동작 방식

간편인증 데이터 조회 / Simple-auth data lookups

Business 또는 All 서버에서 접수 Tool을 호출하고, 사용자가 휴대폰에서 승인한 뒤 같은 상품의 결과 Tool에 transactionId를 전달합니다. 접수는 알림 발송·과금을 동반하므로 사용자 확인 후 실행하며 승인 대기 중 자동으로 재접수하지 않습니다.

Call the request tool on Business or All, ask the user to approve on their phone, then pass transactionId to the matching result tool. Request calls send a notification and incur a charge; obtain confirmation and do not repeatedly submit while waiting.

공통 입력은 SDK와 같은 name, birthDate(YYYYMMDD), phone, authProvider입니다. 상품별 기간 옵션과 응답 상태·오류는 Tool 계약을 확인하세요. 최초 결과 반환 시 조회 범위에 따라 과금하며, 대기 중 조회와 유효기간 내 재조회는 무료입니다.

Common inputs match the SDK: name, birthDate, phone, and authProvider. The first result delivery is billed by query scope; waiting polls and repeat reads within the result lifetime are free. See the tool contract for options and response fields.

증빙서류 묶음: 승인 한 번으로 증명 여러 장을 발급합니다. 공통 입력에 더해 year·use_purpose·submit_to·delivery가 필요하고, 사업자 묶음은 business_no와 대표자 확인(agreed: true 또는 이전 응답의 bind_id)이 필요합니다. 결과는 증명마다 섹션이 따로 오며, 대화형 사용은 format: "json"으로 PDF 원본 없이 받는 것을 권장합니다. 최초 결과는 소득 묶음 84P, 사업자 묶음 126P입니다. 자세한 입력은 발급 입력을 확인하세요.

Certificate bundles: one approval issues several certificates. Besides the common inputs they need year, use_purpose, submit_to and delivery; the business bundle also needs business_no and representative consent (agreed: true or a previous bind_id). Each certificate has its own result section; use format: "json" in chat clients to skip the PDF payload. First result: 84P (income) and 126P (business).

통합 조회 묶음: 승인 한 번으로 여러 조회를 처리합니다. req_nps_bundle은 국민연금 3종을 항상 함께 조회하고, req_hometax_bundle·req_hometax_biz_bundle은 products로 고른 조회만 실행합니다. 과금은 고른 상품 단가의 합(국민연금은 묶음 126P)이고 모두 실패하면 과금되지 않습니다. 사업자 묶음은 business_no와 대표자 확인(agreed: true 또는 이전 응답의 bind_id)이 필요합니다. 고를 수 있는 키는 TOOLS.md에 있습니다.

Lookup bundles: one approval runs several lookups. req_nps_bundle always runs the three pension lookups; req_hometax_bundle and req_hometax_biz_bundle run only the products named in products. Billing is the sum of the selected products (126P fixed for the pension bundle) and nothing is charged when every lookup fails. The business bundle also needs business_no and representative consent (agreed: true or a previous bind_id).

PCCC 비교: 승인 흐름은 같지만 req_pccc는 birthday·provider, get_pccc는 tx_id를 사용하며 결과 재조회도 과금됩니다. 간편인증 데이터 조회 11개 상품의 입력 이름이나 무료 재조회 정책을 PCCC에 적용하지 마세요.

PCCC comparison: The approval flow is the same, but PCCC retains birthday/provider and tx_id, and charges for repeated result reads. Its contract is unchanged.

Tools with side effects / 부작용이 있는 Tool

162 of 224 tools are read-only. The other 62 change state, charge points, cancel work, or consume a result and carry readOnlyHint: false so your client can require approval: 224개 중 162개는 조회입니다. 나머지 62개는 과금·취소·결과 생성 등 상태를 바꾸므로 readOnlyHint: false가 붙습니다.

현재 목소리는 tts_gemini_voices 또는 tts_openai_voices로 조회합니다.

TTS 입력은 정규화 사용 시 최대 2,000자, 끄면 8,000자입니다. 완성된 MP3와 ASS 자막은 서로 독립된 1회용 원본이므로, 결과를 저장할 준비가 된 뒤 tts_jobs_result와 tts_jobs_subtitles를 각각 한 번만 호출하세요.

정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. normalize_text: false(SDK normalizeText: false)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + 실제 AI 사용료입니다. 정규화 실패는 제작을 중단하며, 서버의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.

Normalization is on by default and adds a skill charge. Set normalize_text: false (SDK normalizeText: false) to skip execution and billing. The skill price is its base fee (seller amount and base commission) plus the actual AI usage fee. Normalization failure stops synthesis; final server/provider failures refund normalization as well. ASS preserves the original spelling.

Try it with curl / curl로 바로 확인

# Tool list — no key needed / 인증 불필요curl -X POST "https://apick.app/mcp/business" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
# Business lookup / 사업자 조회curl -X POST "https://apick.app/mcp/business" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -H "Authorization: Bearer YOUR_KEY" \  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"biz_detail","arguments":{"biz_no":"4398700761"}}}'

More in examples/. 더 많은 예시는 examples/.

stdio bridge options / 브릿지 옵션

npx -y apick-mcp --server business     # one server / 특정 서버만npx -y apick-mcp --help

Pricing / 요금

Prepaid points, charged per call, at the same rate as the APICK REST API. No subscription, no per-seat fee. Failed calls are not charged. Each tool's live price is appended to its description in tools/list, so the agent sees the cost before it decides to call. Free tools include bank_code, info, llm_models and find_tools.

포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료도 좌석당 요금도 없습니다. 실패한 호출은 과금되지 않습니다. 각 Tool의 현재 단가는 tools/list 설명에 자동으로 붙어 AI가 호출 전에 비용을 보고 판단합니다. bank_code·info·llm_models·find_tools는 무료입니다.

Current rates 단가표 → https://apick.app/dev_guide/mcp

Links / 링크

Keywords / 검색 키워드

Korean business registry API · 사업자등록번호 조회 API · business registration number lookup · 휴폐업 조회 · 법인등록번호 · 벤처기업 조회 · Korean ID verification · 신분증 진위확인 API · 주민등록증 진위확인 · 운전면허증 진위확인 · 여권 진위확인 · 외국인등록증 · 실명확인 · 주민번호 마스킹 · 개인정보 비식별화 · Korean OCR API · 신분증 OCR · 문자인식 · parcel tracking API Korea · 택배 배송조회 API · 운송장 조회 · CJ대한통운 한진 롯데택배 우체국 로젠 · 계좌 실명조회 · 예금주 조회 · 1원 인증 API · 개인통관고유부호 · PCCC · 부동산 실거래가 API · 침수차 조회 · 폐차 조회 · 도로명주소 검색 API · 공휴일 API · WHOIS API · DNS lookup · IP 위치조회 · 웹페이지 스크린샷 API · 구글 검색 API · 구글 이미지 검색 · 구글 렌즈 · 유튜브 데이터 · PDF 변환 API · PDF to DOCX · HTML to PDF · 엑셀 변환 · 워터마크 API · STT 음성인식 API · 얼굴 인식 API · 얼굴 블러 · 유해이미지 판별 · NSFW detection · 이미지 유사도 · 워드클라우드 · LLM API

Hashtags

#MCP #ModelContextProtocol #MCPServer #MCPTools #AIAgent #ClaudeMCP #ClaudeCode #ClaudeDesktop #Cursor #Cline #Windsurf #VSCode #APICK #에이픽 #OpenAPI #RESTAPI #KoreaAPI #한국API #사업자조회 #사업자등록번호조회 #휴폐업조회 #신분증진위확인 #실명확인 #본인인증 #개인정보마스킹 #OCR #문자인식 #택배조회 #배송조회 #운송장조회 #계좌실명조회 #1원인증 #통관고유부호 #부동산실거래가 #도로명주소 #공휴일API #WHOIS #DNS #IP조회 #웹페이지조회 #구글검색API #스크린샷API #PDF변환 #DOCX변환 #엑셀변환 #워터마크 #STT #음성인식 #얼굴인식 #얼굴블러 #유해이미지 #NSFW #이미지유사도 #LLM #KYC #KYB #핀테크 #이커머스 #물류자동화 #업무자동화

Privacy Policy / 개인정보처리방침

https://apick.app/personal_policy · Terms 이용약관: https://apick.app/terms

EN — This repository ships documentation and a stdio bridge. The bridge stores nothing and transmits nothing beyond the JSON-RPC messages your MCP client sends, forwarded to https://apick.app/mcp/{server} over HTTPS with your license key in the Authorization header. It writes no logs and never prints your key.

What APICK collects when you call a tool — the request parameters needed to fulfil it, the account the key belongs to, and a billing record (which tool, cost, timestamp) — plus retention periods, third-party sharing and contact details, is covered in the policy above. Tools that take a file fetch it from the https URL you supply; the file is processed and not retained. Do not send personal data you are not authorized to process.

KO — 이 저장소는 문서와 stdio 브릿지로 구성됩니다. 브릿지는 아무것도 저장하지 않으며, MCP 클라이언트가 보낸 JSON-RPC 메시지를 HTTPS로 https://apick.app/mcp/{server} 에 전달하는 것 외의 통신을 하지 않습니다. 로그를 남기지 않고 인증키를 출력하지 않습니다.

Tool 호출 시 에이픽이 수집하는 항목(처리에 필요한 요청 파라미터, 인증키에 연결된 계정, 과금 기록)과 보관기간·제3자 제공·문의처는 위 방침에 정리되어 있습니다. 파일을 받는 Tool은 사용자가 준 https URL에서 파일을 내려받아 처리하며 보관하지 않습니다. 처리 권한이 없는 개인정보는 전송하지 마세요.

License / 라이선스

MIT — see LICENSE. Covers this repository (documentation and the stdio bridge). Use of the APICK service is governed by the APICK terms.

MIT — LICENSE 참고. 이 저장소(문서와 stdio 브릿지)에 적용됩니다. 에이픽 서비스 이용은 에이픽 이용약관을 따릅니다.

TTS 폐기 기능 / Retired TTS features

Legacy quality, retry and candidate-audio tools are no longer supported. 기존 품질 검수·발화 재개·후보 음원 도구는 지원하지 않습니다.

Video model versions

Omitting version preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set version and tier explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include version.

Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the Seedance, Veo and Kling version tables. Unsupported combinations are rejected before submission.

영상 모델 버전 선택

version을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 version으로 확인할 수 있습니다.

등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 audio=false, 오디오 필수 모델은 audio=true만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.

스킬 실행 견적과 파일 / Skill estimates and files

스킬 상세·견적의 execution_info에는 가격·소요시간 범위와 도구 호출 횟수 예상이 있습니다. 입력에 따라 달라지며 보장값이 아닙니다. quote_skill의 최대 예약액을 확인한 후 실행하세요. 성공 결과의 artifacts에는 파일 ID·형식·크기·SHA-256이 있습니다. 인증이 필요한 다운로드는 apick-api의 getSkillArtifact(runId, fileId)로 처리할 수 있습니다. 결과 만료 시 파일도 만료됩니다.

execution_info provides estimated price/duration ranges and tool call counts, not guarantees. Check the maximum reservation in quote_skill before execution. Successful results may include artifacts with file IDs, MIME types, byte sizes, and SHA-256 digests. Use getSkillArtifact(runId, fileId) in apick-api for authenticated downloads. Files expire with the run result. Tool counts and bridge behavior are unchanged.

서브에이전트 / Subagent

설치형 apick-agent 상품은 apick-subagent 스킬 패키지와 전용 REST·MCP를 사용합니다. 설치비·도입비·구독료 없이 성공한 작업만 사용량대로 정산(AI 사용 작업 기본 5P), 승인된 동일 결과 캐시 1P, 충전 잔액 외 상품 한도 없음. 연동 가이드.

The installed apick-agent product uses the apick-subagent skill package and dedicated REST/MCP interfaces. No installation, setup or subscription fee. Successful work is billed by actual usage (5-point base fee for AI jobs); approved identical cache reuse costs 1 point, with no product quota beyond prepaid balance. Integration guide.

npx -y apick-mcp --server subagent# Local workspace collection / 로컬 파일 수집npm install -g apick-subagentapick-subagent install

Set APICK_API_KEY in the environment. 원격 MCP는 업로드된 자료를 처리합니다. The remote MCP processes uploaded content; the installed bridge collects local files.

Gemini·ChatGPT TTS

tts_jobs_create와 tts_gemini_create는 Gemini(기본 Kore), tts_openai_create는 ChatGPT(기본 alloy)를 사용합니다. tts_gemini_voices, tts_openai_voices, tts_options, tts_quote로 목소리·옵션·요금을 조회합니다.

Use tts_jobs_create or tts_gemini_create for Gemini (default Kore), and tts_openai_create for ChatGPT (default alloy). Query voices, options and estimates with the corresponding tools. Legacy APICK voices and automatic fallback have retired.

style, emotion, tone, accent, pace(0.5–2), pitch(-12–12), volume_gain_db(-12–12)는 최상위·화자·발화에 지정할 수 있습니다. speakers는 화자 이름별 설정이고 multi_speaker: true는 Gemini 최대 2명, ChatGPT 최대 8명입니다. 엔진에 따라 표현 효과가 달라지며 정확한 속도 배율·반음·dB 적용을 보장하지 않습니다. 특히 ChatGPT는 수치의 방향을 낭독 지시로 전달합니다.

Style, emotion, tone, accent, pace, pitch and volume options can be set per request, speaker or utterance. Gemini supports up to two native speakers; ChatGPT supports up to eight speakers across utterances. Numeric acoustic adjustments are not guaranteed: ChatGPT receives directional instructions rather than precise rate, semitone or decibel controls.

정규화는 기본 켜짐이며 추가 스킬 요금이 합산됩니다. normalize_text: false(SDK 문자열 호출은 normalizeText: false)로 끌 수 있습니다. 정규화 입력은 발화 사이 줄바꿈을 포함해 최대 2,000자, 정규화 없이 최대 8,000자입니다. 견적은 tts_quote, 현재 목소리는 엔진별 목록, 옵션은 tts_options로 조회합니다.

Normalization is enabled by default and costs extra. Disable it with normalize_text: false (normalizeText: false for the string SDK helper). Input limits are 2,000 characters including utterance separators with normalization, or 8,000 without it. Query a quote, engine-specific voices and supported options before submitting.

실제 사용량에 정규화 요금을 더해 정산합니다. 엔진별 요금이 다르며, 예상 금액은 tts_quote로 미리 확인할 수 있습니다.

AI usage is charged by actual usage, plus normalization. Rates differ by engine; check the estimate with tts_quote first.

두 엔진은 같은 작업 조회·취소·MP3·원문 ASS 계약을 사용합니다. billing의 예약·해제·확정·환불을 확인하세요. MP3는 24kHz 모노 48kbps, 결과는 완료 후 24시간 보관합니다. MP3와 ASS는 각각 완료된 다운로드 1회만 허용하며 전송 중단은 재시도할 수 있습니다. 접수 응답 유실 시 같은 입력과 멱등 키를 재사용하세요. 서버 최종 실패는 정규화까지 환불하며, 연결 종료는 작업 취소가 아닙니다. 취소 시 이미 수행된 작업분을 정산합니다.

Both engines share job status, cancellation, MP3 and original-text ASS downloads. Check reserved, released, captured and refunded amounts in billing. MP3 is 24 kHz mono at 48 kbps. Files are kept for 24 hours; each permits one completed download, and interrupted transfers can be retried. Reuse the same input and idempotency key after a lost response. Final server/provider failures refund synthesis and normalization; disconnecting does not cancel work. Explicit cancellation settles work already performed.

차량 자유문 검색 / Vehicle free-text search

차명에 등급·연식·좌석을 함께 넣을 수 있습니다(파나메라 gts 4인승 19년식, PANAMERA GTS 19년). 입력한 연식·등급을 우선하며 좌석 수는 실제 제원과 일치해야 합니다. 근접 연식을 선택하면 반환 연식과 안내를 확인하세요. 지정 등급을 찾지 못하거나 확신이 낮으면 제원 없이 무료 후보만 반환하며, 유사 차량이 전혀 없으면 없음 오류로 응답하고 과금하지 않습니다. 별도 연식·등급과 문장 조건이 충돌하면 입력 오류입니다.

Put the model, trim, year and seat count in model (for example, PANAMERA GTS 19년). Matching prioritizes the supplied year and trim, and the seat count must match the specification. Check the returned year and notice when a nearby year is selected. Unmatched trims and low-confidence matches return suggestions without specifications or charges; no similar vehicle returns a no-result error without charging. Conflicting explicit and free-text constraints are rejected.

도구 / Tool: vehicle_model_info, arguments: { "model": "PANAMERA GTS 19년" }.

리퀘오 이전 / Move to REQEO

스킬 판매·실행은 리퀘오 REQEO로 이전했습니다. 원격 MCP 주소는 https://reqeo.com/mcp/skills입니다. 리퀘오 계정에서 발급한 인증키로 연결하세요. 두 서비스의 계정과 포인트는 별개이며 에이픽 인증키는 전달하지 않습니다. --server skills는 이전 안내와 함께 종료합니다. 일반 API·TTS·설치형 에이전트는 계속 지원합니다.

Skill sales and execution have moved to REQEO. Connect directly to https://reqeo.com/mcp/skills with a key from your REQEO account. Accounts and points are separate; APICK credentials are not forwarded. --server skills exits with a migration notice. General APIs, TTS and the installed agent remain supported.

문서함·AI 작성 / Documents

document_create · document_list · document_get · document_update · document_delete · document_ai_write · document_quote · document_download

저장·조회는 무료, AI 작성은 성공당 20P, DOCX 최초 다운로드는 100P입니다. 같은 문서에서 구매한 내용은 14일 보관기간 안에 무료로 다시 받습니다. 수정 또는 다운로드하면 보관기간이 연장됩니다. 요청 ID와 버전으로 재시도·수정 충돌을 처리합니다.

Storage and reads are free. AI writing costs 20P per successful request; initial DOCX download costs 100P. Purchased content of the same document is free to download again during its 14-day retention. Actual edits and successful downloads extend retention. See document tools for request fields and retry rules.

문서 고도화 / Document workflows

document_templates, document_template, document_workflow_quote/start/get/answer/apply/cancel, document_verify/finalize, 첨부 관리, PDF·ZIP 출력을 지원합니다. 기존 문서 도구 8개는 유지합니다. 전체 입력과 요금은 문서 도구를 확인하세요.

Core profiles, edition selection, persistent writing workflows, attachment review, version-bound verification, PDF and ZIP are supported. The original eight document tools remain compatible. See TOOLS.md for exact tool names, parameters and pricing.