์คํฌ ๊ตฌ๋งค ์ ์ฑ๋ฅํ์ ์ํ ๋ฐฉ์์ ํ์ธํ์ธ์. ํ๋ณธ ์ยทํ๊ฐ์ผยท๊ธฐ๊ณ ๊ฒ์ฌ์ ๋ชจ๋ธ ์ ์๋ฅผ ๊ตฌ๋ถํ๋ฉฐ, ๋ฏธ๊ฒ์ฆ ํญ๋ชฉ์ ์์น๋ฅผ ํ์ํ์ง ์์ต๋๋ค. ๊ณต๊ฐ JSON๋ ์ ๊ณตํ๋ฉฐ ๋ณ๋์ ์ ๋ฃ ๋๊ตฌ ํธ์ถ์ด ํ์ํ์ง ์์ต๋๋ค.
Before choosing a Skill, review its measured performance and test methods. Sample sizes, dates, machine checks and model scores are reported separately; untested values are not scored. A public JSON report is available without a paid tool call.
What is this? / ์ด๊ฒ ๋ญ๊ฐ์?
EN โ APICK is a Korean data and AI API platform. This MCP server exposes 119 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 119๊ฐ๋ก ์ฌ์
์ ์กฐํ, ์ ๋ถ์ฆ ์ง์ํ์ธ, ํ๋ฐฐ ๋ฐฐ์ก์กฐํ, 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 119 tools before you sign up. Only tools/call validates the key and allowed IP.
tools/list๋ ์ธ์ฆ ์์ด ๋์ํฉ๋๋ค. ๊ฐ์
์ ์๋ ํด๋ผ์ด์ธํธ๊ฐ ์ฐ๊ฒฐํด 119๊ฐ 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 / ์ฐ๊ฒฐ
| Client | How / ๋ฐฉ๋ฒ |
|---|
| Claude Code |
claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"
Restart Claude Code so the tools load. ํด์ด ๋ก๋๋๋๋ก ์ฌ์์ํ์ธ์.
|
Claude Desktop
claude_desktop_config.json |
{
"mcpServers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
|
Cursor
~/.cursor/mcp.json |
{
"mcpServers": {
"apick": {
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
|
Windsurf
~/.codeium/windsurf/mcp_config.json |
{
"mcpServers": {
"apick": {
"serverUrl": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
|
VS Code
.vscode/mcp.json |
{
"servers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
|
Cline / any client without remote MCP support ์๊ฒฉ MCP ๋ฏธ์ง์ ํด๋ผ์ด์ธํธ |
{
"mcpServers": {
"apick": {
"command": "npx",
"args": ["-y", "apick-mcp", "--server", "all"],
"env": { "APICK_API_KEY": "YOUR_KEY" }
}
}
}
Zero-dependency stdio bridge, Node 18+. ์์กด์ฑ 0๊ฐ stdio ๋ธ๋ฆฟ์ง.
|
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๊ฐ ๋ ์ ํํ ๊ณ ๋ฆ
๋๋ค.
| Server ์๋ฒ | Endpoint | Tools | Coverage ๋ฒ์ |
|---|
| All ํตํฉ | https://apick.app/mcp/all | 119 | ์๋ ์ ๋ถ + find_tools |
| Business ์ฌ์
์ยท์ปค๋จธ์ค | https://apick.app/mcp/business | 30 | ์ฌ์
์ยท๋ฒ์ธ ์กฐํ, ํ๋ฐฐ ๋ฐฐ์ก์กฐํ, ๋ถ๋์ฐ ์ค๊ฑฐ๋๊ฐ, ์ฐจ๋ ์ด๋ ฅ, ์ ํจ์ฑ ๊ฒ์ฌ |
| Identity ์ ๋ถ์ฆ | https://apick.app/mcp/identity | 16 | ์ฃผ๋ฏผ๋ฑ๋ก์ฆยท์ด์ ๋ฉดํ์ฆยท์ฌ๊ถยท์ธ๊ตญ์ธ๋ฑ๋ก์ฆ ์ง์ํ์ธ, ์ค๋ช
ํ์ธ, ๊ฐ์ธ์ ๋ณด ๋ง์คํน |
| Convert ํ์ผ๋ณํ | https://apick.app/mcp/convert | 25 | PDFยทDOCXยท์์
๋ณํ, STT, ๋น๋๊ธฐ TTS, ์ํฐ๋งํฌ |
| Web ์นยท๊ฒ์ | https://apick.app/mcp/web | 17 | ๋๋ฉ์ธยทIPยทWHOIS, ์นํ์ด์ง ์์ง, ๊ตฌ๊ธ ๊ฒ์, ์ ํ๋ธ |
| Vision ์ด๋ฏธ์งยท์์ | https://apick.app/mcp/vision | 6 | ์ผ๊ตด ๊ฒ์ถ, ์ด๋ฏธ์ง ์ ์ฌ๋, ์ ํด์ด๋ฏธ์ง ํ๋ณ, ์์ ์ถ์ถ |
| OCR ๋ฌธ์์ธ์ | https://apick.app/mcp/ocr | 6 | ์ด๋ฏธ์ง ํ
์คํธ ์ถ์ถ, ์ ๋ถ์ฆ ํญ๋ชฉ ์ถ์ถ |
| AI ยท LLM | https://apick.app/mcp/ai | 15 | LLM ์ฑ, ํ
์คํธ ์์ฝยท๊ต์ , ์ด๋ฏธ์ง ์์ฑยทํธ์งยท๋๋ ์์
, ๋น๋๊ธฐ ์์ ์์ฑ |
| Finance ๊ธ์ต | https://apick.app/mcp/finance | 3 | ๊ณ์ข ์๊ธ์ฃผ ์กฐํ, 1์ ์ธ์ฆ |
| Skills | https://apick.app/mcp/skills | 6 | ๊ฒ์๋ Skill ๊ฒ์ยท๊ฒฌ์ ยท์คํ. all๊ณผ ๋ณ๋ ์๋ฒ / reviewed Skills, separate from all |
โ TOOLS.md โ the current 119-tool inventory and detailed examples for common tools.
โ TOOLS.md โ ํ์ฌ 119๊ฐ ๋ชฉ๋ก๊ณผ ์ฃผ์ ๋๊ตฌ์ ํ๋ผ๋ฏธํฐยทํ์
ยทํธ์ถ ์์๋ฅผ ์ ๋ฆฌํ์ต๋๋ค.
Tool names at a glance / Tool ์ด๋ฆ ํ๋์ ๋ณด๊ธฐ
Business biz_detail venture_biz_info land_rt_price req_pccc get_pccc get_car_flooding get_car_scrap parcel_tracking parcel_tracking_auto check_email_valid check_phone_valid check_spam_number holiday_info search_juso info app_reviews req_cash_receipt_deduction get_cash_receipt_deduction req_tax_return_history get_tax_return_history req_employment get_employment req_personal_income get_personal_income req_nps_join_history get_nps_join_history req_driving_license get_driving_license req_health_checkup get_health_checkup
Identity identi_card1 identi_card2 identi_card3 identi_card4 identi_card5 identi_card_image1 identi_card_image2 identi_card_image3 identi_card_image4 identi_card_image5 name_rrn_auth hide_rrn identity_document_residence_card identity_document_passport identity_document_id_card identity_document_driver_license
OCR ocr ocr_identi1 ocr_identi2 ocr_identi3 ocr_identi4 ocr_identi5
Finance transfer_1won account_realname bank_code
Web nslookup reverse_ip location ip_history whois url_html url_screenshot url_similarity google_search google_image_search google_lens_search crawl_youtube download_youtube_video youtube_metadata youtube_thumbnail youtube_subtitle_list youtube_subtitle
Convert stt tts_jobs_create tts_gemini_create tts_gemini_voices tts_openai_create tts_openai_voices tts_options tts_quote tts_jobs_status tts_jobs_cancel tts_jobs_result tts_jobs_subtitles voice_change face_blur pdf_to_docx pdf_to_image pdf_merge html_to_pdf docx_to_pdf json_to_excel base64_to_image set_watermark get_watermark draw_watermark_pdf draw_watermark_image
Vision nsfw_detection image_similarity video_to_mp3 extract_video_thumbnail word_cloud face_detection
AI llm_models llm_chat text_summary text_polish image_generate image_edit image_batch_create image_batch_status image_batch_result seedance_jobs_create seedance_jobs_status veo_jobs_create veo_jobs_status kling_jobs_create kling_jobs_status
All only ํตํฉ ์๋ฒ ์ ์ฉ find_tools
EN โ The all server has 119 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์ด 119๊ฐ ์์ต๋๋ค. find_tools๋ ์์ฐ์ด(ํ๊ตญ์ดยท์์ด)๋ก ์ค๋ช
ํ ์์
์ ๊ฐ์ฅ ์๋ง์ ์์ดํฝ Tool์ ์ถ์ฒํ๊ณ , Tool ์ด๋ฆยท์ ๋ชฉยท์ค๋ช
๊ณผ ๊ด๋ จ๋(highยทmediumยทlow)๋ฅผ ๋๋ ค์ค๋๋ค. ๋ฌด๋ฃ์ด๋ฉฐ ์ธ์ฆํค ์์ด ํธ์ถํ ์ ์๊ณ , all ์๋ฒ์์๋ง ์ ๊ณตํฉ๋๋ค. ๋ถ์ผ๋ณ ์๋ฒ๋ Tool ์๊ฐ ์ ์ด tools/list๋ง์ผ๋ก ๊ณ ๋ฅผ ์ ์์ต๋๋ค.
| Parameter | Type | Required | Description ์ค๋ช
|
|---|
task | string | required ํ์ | Task to perform, 2โ500 characters ยท ํ๋ ค๋ ์์
์ค๋ช
(2~500์) |
limit | integer | optional ์ ํ | Number of tools to return, 1โ10 (default 5) ยท ๋๋ ค๋ฐ์ Tool ์ (1~10, ๊ธฐ๋ณธ 5) |
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 ๊ตญ์ธ์ฒญ/๊ณต์ ์ 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 / ๋์ ๋ฐฉ์
| EN | KO |
|---|
| Transport | Streamable HTTP โ one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | ์๋ฒ๋น ๋จ์ผ ์๋ํฌ์ธํธ, HTTPS POST๋ก JSON-RPC 2.0, ์ธ์
์์ด ์์ฒญ ๋จ์ |
| Protocol | MCP 2026-07-28, auto-compatible with earlier client versions | MCP 2026-07-28 ๊ธฐ๋ณธ, ์ด์ ๊ท๊ฒฉ ํด๋ผ์ด์ธํธ ์๋ ํธํ |
| Discovery | tools/list returns every tool with JSON Schema, description and live price โ no key needed | tools/list๊ฐ ์คํค๋งยท์ค๋ช
ยท์ค์๊ฐ ๋จ๊ฐ๋ฅผ ๋ฐํ, ์ธ์ฆ ๋ถํ์ |
| Annotations | Every tool declares title, readOnlyHint, openWorldHint. 29 of 119 are not read-only | ์ Tool์ด titleยทreadOnlyHintยทopenWorldHint ์ ์ธ. 119๊ฐ ์ค ์ํ ๋ณ๊ฒฝ Tool์ 29๊ฐ |
| Results | Text (JSON) + structuredContent. Images as image content; files up to 8MB as base64 | ํ
์คํธ(JSON)์ structuredContent ๋์ ๋ฐํ. ์ด๋ฏธ์ง๋ ์ด๋ฏธ์ง ์ฝํ
์ธ , 8MB ์ดํ ํ์ผ์ base64 |
| File input | File-taking tools accept a public https URL (image_url, pdf_url, โฆ) โ APICK downloads and processes it | ํ์ผ Tool์ ๊ณต๊ฐ https URL์ ๋ฐ์ต๋๋ค. ์์ดํฝ ์๋ฒ๊ฐ ๋ด๋ ค๋ฐ์ ์ฒ๋ฆฌํฉ๋๋ค |
| Errors | Delivered via isError; identity masking also preserves structuredContent.error_code | isError๋ก ์ ๋ฌ๋๋ฉฐ ์ ๋ถ์ฆ ๋ง์คํน์ structuredContent.error_code๋ ๋ณด์กดํฉ๋๋ค |
| Auth | Authorization: Bearer <key>; X-API-Key also accepted | Authorization: Bearer ์ธ์ฆํค, X-API-Key๋ ์ง์ |
๊ฐํธ์ธ์ฆ ๋ฐ์ดํฐ ์กฐํ / 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 ๋ฉ์๋ | MCP Tool |
|---|
| ์ฌ์งยท๋ณดํ๋ฃ ํ์ธ | requestEmployment / getEmployment | req_employment / get_employment |
| ๊ธ์ต์๋(์ด์ยท๋ฐฐ๋น) ์กฐํ | requestPersonalIncome / getPersonalIncome | req_personal_income / get_personal_income |
| ๊ตญ๋ฏผ์ฐ๊ธ ๊ฐ์
๋ด์ญ | requestNpsJoinHistory / getNpsJoinHistory | req_nps_join_history / get_nps_join_history |
| ์ด์ ๋ฉดํ ์กฐํ | requestDrivingLicense / getDrivingLicense | req_driving_license / get_driving_license |
| ๊ตญ๊ฐ ๊ฑด๊ฐ๊ฒ์ง ๊ฒฐ๊ณผ | requestHealthCheckup / getHealthCheckup | req_health_checkup / get_health_checkup |
| ํ๊ธ์์์ฆ ์๋๊ณต์ ๋ด์ญ | requestCashReceiptDeduction / getCashReceiptDeduction | req_cash_receipt_deduction / get_cash_receipt_deduction |
| ๊ตญ์ธ ์ ๊ณ ๋ด์ญ ์กฐํ | requestTaxReturnHistory / getTaxReturnHistory | req_tax_return_history / get_tax_return_history |
๊ณตํต ์
๋ ฅ์ 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.
PCCC ๋น๊ต: ์น์ธ ํ๋ฆ์ ๊ฐ์ง๋ง req_pccc๋ birthdayยทprovider, get_pccc๋ tx_id๋ฅผ ์ฌ์ฉํ๋ฉฐ ๊ฒฐ๊ณผ ์ฌ์กฐํ๋ ๊ณผ๊ธ๋ฉ๋๋ค. ๊ฐํธ์ธ์ฆ ๋ฐ์ดํฐ ์กฐํ 7๊ฐ ์ํ์ ์
๋ ฅ ์ด๋ฆ์ด๋ ๋ฌด๋ฃ ์ฌ์กฐํ ์ ์ฑ
์ 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.
90 of 119 tools are read-only. The other 29 change state, charge points, cancel work, or consume a result and carry readOnlyHint: false so your client can require approval:
119๊ฐ ์ค 90๊ฐ๋ ์กฐํ์
๋๋ค. ๋๋จธ์ง 29๊ฐ๋ ๊ณผ๊ธยท์ทจ์ยท๊ฒฐ๊ณผ ์์ฑ ๋ฑ ์ํ๋ฅผ ๋ฐ๊พธ๋ฏ๋ก readOnlyHint: false๊ฐ ๋ถ์ต๋๋ค.
| Tool | What it does / ํ๋ ์ผ |
|---|
req_employment | Requests phone approval and charges acceptance ยท ์ฌ์งยท๋ณดํ๋ฃ ํ์ธ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_employment | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_personal_income | Requests phone approval and charges acceptance ยท ๊ธ์ต์๋(์ด์ยท๋ฐฐ๋น) ์กฐํ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_personal_income | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_nps_join_history | Requests phone approval and charges acceptance ยท ๊ตญ๋ฏผ์ฐ๊ธ ๊ฐ์
๋ด์ญ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_nps_join_history | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_driving_license | Requests phone approval and charges acceptance ยท ์ด์ ๋ฉดํ ์กฐํ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_driving_license | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_health_checkup | Requests phone approval and charges acceptance ยท ๊ตญ๊ฐ ๊ฑด๊ฐ๊ฒ์ง ๊ฒฐ๊ณผ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_health_checkup | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_cash_receipt_deduction | Requests phone approval and charges acceptance ยท ํ๊ธ์์์ฆ ์๋๊ณต์ ๋ด์ญ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_cash_receipt_deduction | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
req_tax_return_history | Requests phone approval and charges acceptance ยท ๊ตญ์ธ ์ ๊ณ ๋ด์ญ ์กฐํ ์ธ์ฆ ์์ฒญยท์ ์ ๊ณผ๊ธ |
get_tax_return_history | Collects and bills the first result; repeat reads are free ยท ๊ฒฐ๊ณผ ์์งยท์ต์ด ๋ฐํ ๊ณผ๊ธ, ์ฌ์กฐํ ๋ฌด๋ฃ |
image_generate / image_edit / image_batch_create | Creates images and charges points ยท ์ด๋ฏธ์ง ์์ฑยทํธ์งยท์์
์ ์ ๊ณผ๊ธ |
transfer_1won | Deposits 1 KRW into a bank account ยท ์ค์ ๋ก 1์์ ์
๊ธํฉ๋๋ค |
req_pccc | Sends a simple-authentication request to the person's phone ยท ๋ณธ์ธ ํด๋ํฐ์ผ๋ก ๊ฐํธ์ธ์ฆ ์์ฒญ์ ๋ฐ์กํฉ๋๋ค |
get_pccc | Reads the approval result by tx_id and charges once per result ยท tx_id ๋ก ์น์ธ ๊ฒฐ๊ณผ๋ฅผ ์กฐํํ๊ณ ๊ฒฐ๊ณผ 1๊ฑด๋ง๋ค ๊ณผ๊ธํฉ๋๋ค |
tts_jobs_create / tts_gemini_create / tts_openai_create | Reserves the maximum, then settles actual usage ยท ์ํ ์์ฝ ํ ์ค์ ์๊ธ ํ์ |
tts_jobs_cancel | Requests cancellation of a waiting or processing job; already performed paid work is settled ยท ๋๊ธฐยท์์ฑ ์ค ์ทจ์๋ฅผ ์์ฒญํ๋ฉฐ ์ด๋ฏธ ์ํํ ์ ๋ฃ ์ฒ๋ฆฌ๋ถ๋ง ์ ์ฐํฉ๋๋ค |
tts_jobs_result | Permanently consumes the one-time result ยท 1ํ์ฉ ๊ฒฐ๊ณผ ์๋ณธ์ ์๊ตฌ ์๋ชจํฉ๋๋ค |
tts_jobs_subtitles | Permanently consumes the one-time ASS subtitles ยท 1ํ์ฉ ASS ์๋ง ์๋ณธ์ ์๊ตฌ ์๋ชจํฉ๋๋ค |
seedance_jobs_create | Submits and charges an async Seedance video job ยท Seedance ์์ ์์
์ ์ ์ํ๊ณ ๊ณผ๊ธํฉ๋๋ค |
veo_jobs_create | Submits and charges an async Veo video job ยท Veo ์์ ์์
์ ์ ์ํ๊ณ ๊ณผ๊ธํฉ๋๋ค |
kling_jobs_create | Submits and charges an async Kling video job ยท Kling ์์ ์์
์ ์ ์ํ๊ณ ๊ณผ๊ธํฉ๋๋ค |
ํ์ฌ ๋ชฉ์๋ฆฌ๋ 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 ์๊ฐ ร ํ์จ ร 1.4์
๋๋ค. ์ ๊ทํ ์คํจ๋ ์ ์์ ์ค๋จํ๋ฉฐ, ์๋ฒยท๊ณต๊ธ์์ ์ต์ข
์ ์ ์คํจ๋ ์ ๊ทํ๊น์ง ์ ์ก ํ๋ถํฉ๋๋ค. 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 actual AI cost ร the pinned exchange rate ร 1.4. Normalization failure stops synthesis; final server/provider failures refund normalization as well. ASS preserves the original spelling.
Try it with curl / curl๋ก ๋ฐ๋ก ํ์ธ
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":{}}'
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
npx -y apick-mcp --help
| Variable ํ๊ฒฝ๋ณ์ | Default | Meaning ์ค๋ช
|
|---|
APICK_API_KEY | โ | License key. Optional for discovery, required for calls ยท ์ธ์ฆํค. ํ์์ ์์ด๋ ๋๊ณ ํธ์ถ์ ํ์ |
APICK_MCP_SERVER | all | Same as --server ยท --server์ ๋์ผ |
APICK_MCP_URL | https://apick.app/mcp | Base URL override ยท ๊ธฐ๋ณธ URL ๋ณ๊ฒฝ |
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
#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.5, 2.0(StandardยทFastยทMini), 1.5, 1.0 | ๋ฒ์ ๋ณ ์ง์ํ |
| Veo | 3.1 (Standard, Fast, Lite) | ๋ฒ์ ๋ณ ์ง์ํ |
| Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | ๋ฒ์ ๋ณ ์ง์ํ |
๋ฑ๊ธยทํด์๋ยท๊ธธ์ดยท์ค๋์คยทํ์ผ ๊ฐ์์ ์ด๋น ํฌ์ธํธ๋ ์ ํ ์กฐํฉ๋ณ๋ก ๋ค๋ฆ
๋๋ค. 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๋ฅผ ์ฌ์ฉํฉ๋๋ค. ์๊ฐ +40%, ์น์ธ๋ ๋์ผ ๊ฒฐ๊ณผ ์บ์ ๋ฌด๋ฃ, ์ถฉ์ ์์ก ์ธ ์ํ ํ๋ ์์. ์ฐ๋ ๊ฐ์ด๋.
The installed apick-agent product uses the apick-subagent skill package and dedicated REST/MCP interfaces. Confirmed cost plus 40%; approved identical cache reuse is free, with no product quota beyond prepaid balance. Integration guide.
npx -y apick-mcp --server subagent
npm install -g apick-subagent
apick-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.
์ค์ AI ์๊ฐ ร ๊ณ ์ ๋ ํ์จ ร 1.4์ ์ ๊ทํ ์๊ธ์ ๋ํด ์ ์ฐํฉ๋๋ค. Gemini ํ๋ก๋ชจ์
์
๋ ฅ/์ถ๋ ฅ ๋จ๊ฐ๋ 2026-12-31๊น์ง ๋ฐฑ๋ง ํ ํฐ๋น $0.50/$6.00์ด๋ฉฐ 2027-01-01 00:00 UTC๋ถํฐ $1.00/$12.00์
๋๋ค. ์ฝ $0.54/์๊ฐ์ ์ฐธ๊ณ ๊ฐ์ด๋ฉฐ ์๊ฐ ๋จ์ ์ฒญ๊ตฌ๊ฐ ์๋๋๋ค. ์์ง๋ณ ์๊ธ์ด ๋ค๋ฆ
๋๋ค.
AI usage is charged at verified cost ร the pinned exchange rate ร 1.4, plus normalization. Gemini promotional input/output rates are $0.50/$6.00 per million tokens through 2026-12-31, then $1.00/$12.00 from 2027-01-01 00:00 UTC. The approximate hourly figure is informational; billing uses actual usage and differs by engine.
๋ ์์ง์ ๊ฐ์ ์์
์กฐํยท์ทจ์ยท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.