APICK Skills
Search, quote and run reviewed Skills; points are charged only when a validated result returns
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- LOWget_skill에서
- LOWget_skill_run에서
- LOWcancel_skill_run에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"skills": {
"url": "https://apick.app/mcp/skills"
}
}
}원격 엔드포인트
https://apick.app/mcp/skillsstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢search_skills(query, category, sort, cursor, limit)
하려는 작업에 맞는 Skill 을 검색합니다. 이름·요약·분류와 기본 금액·예상 금액(포인트), 사용 건수 구간·좋아요 수·평점을 돌려줍니다. sort 로 추천·인기·많이 쓴 순서를 고를 수 있습니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"query": {
"description": "찾으려는 작업을 나타내는 검색어",
"type": "string",
"maxLength": 60
},
"category": {
"description": "분류",
"type": "string",
"enum": [
"data",
"ai",
"dev",
"document",
"marketing",
"finance",
"productivity",
"video",
"etc"
]
},
"sort": {
"description": "순서. recommended 추천, popular 인기, used 많이 사용, likes 좋아요순, rating 평점순, new 최신, mine 내가 자주 쓴, liked 내가 좋아요한. 생략하면 등록 순",
"type": "string",
"enum": [
"recommended",
"popular",
"used",
"likes",
"rating",
"new",
"mine",
"liked"
]
},
"cursor": {
"description": "다음 페이지 커서",
"type": "string",
"maxLength": 20
},
"limit": {
"description": "한 번에 받을 개수(최대 20)",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_skill(skill_id)
Skill 의 입력·출력 형식, 기본 금액과 예상 금액, 처리 상한, 예제를 확인합니다. 실행 전에 입력 형식을 맞추는 데 씁니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"skill_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "search_skills 결과의 skill_id"
}
},
"required": [
"skill_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quote_skill(skill_id, version, input)
실행 전 예상 금액 조회. 입력을 검사하고 이 입력으로 실행했을 때의 예상 금액(estimated_points)과 최대 금액(max_points)을 알려 줍니다. 실행하지 않으며 과금되지 않습니다. 결과는 5분 동안 유효합니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"skill_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "search_skills 결과의 skill_id"
},
"version": {
"description": "버전. 생략하면 현재 게시 버전",
"type": "string",
"maxLength": 16
},
"input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Skill 의 input_schema 에 맞는 입력 객체"
}
},
"required": [
"skill_id",
"input"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢run_skill(skill_id, input, idempotency_key, version, quote_id, ...)
Skill 을 실행합니다. 결과가 검증되어 반환될 때만 차감되고, 실패·시간초과·취소는 차감되지 않습니다. 차감 금액은 기본 금액에 실제 AI 사용 비용을 더한 값이며 billing.charged_points 로 알려 줍니다. 같은 idempotency_key 로 다시 보내면 새로 실행하지 않고 같은 실행을 돌려줍니다. 20초 안에 끝나지 않으면 run_id 만 돌려주므로 get_skill_run 으로 확인합니다. [실제 사용한 만큼 포인트 차감]
입력 스키마
{
"type": "object",
"properties": {
"skill_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "search_skills 결과의 skill_id"
},
"input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Skill 의 input_schema 에 맞는 입력 객체"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "이 실행을 구분하는 고유 값. 재시도할 때 같은 값을 씁니다"
},
"version": {
"description": "버전. 생략하면 현재 게시 버전",
"type": "string",
"maxLength": 16
},
"quote_id": {
"description": "quote_skill 이 돌려준 번호",
"type": "string",
"maxLength": 40
},
"max_cost_points": {
"description": "최대 금액이 이 값보다 높으면 실행하지 않습니다. 실제 차감액은 이 값을 넘지 않습니다",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"wait_seconds": {
"description": "결과를 기다릴 시간(초). 기본 20",
"type": "integer",
"minimum": 0,
"maximum": 20
}
},
"required": [
"skill_id",
"input",
"idempotency_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_skill_run(run_id)
실행 상태와 과금 상태를 확인합니다. 성공한 실행은 결과를 함께 돌려줍니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "run_skill 이 돌려준 run_id"
}
},
"required": [
"run_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cancel_skill_run(run_id)
아직 끝나지 않은 실행을 취소합니다. 취소된 실행은 과금되지 않습니다. 이미 끝난 실행은 취소할 수 없습니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "run_skill 이 돌려준 run_id"
}
},
"required": [
"run_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거