get_bestsellers

Retrieve bestseller book lists from Aladin, filtered by category or specific week. Input year, month, and week to access historical rankings or use default settings for current results.

Instructions

알라딘 도서 베스트셀러 목록을 조회합니다. 카테고리별로 검색할 수 있으며, 특정 주간의 베스트셀러를 조회할 수 있습니다. 특정 주간을 조회할 때는 연도, 월, 주를 모두 입력해주세요.

Input Schema

Name	Required	Description
`categoryId`	No	카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용
`maxResults`	No	최대 결과 개수
`month`	No	조회할 월 (1-12) - 생략하면 현재 주간
`start`	No	검색 시작 번호
`week`	No	조회할 주 (1-5) - 생략하면 현재 주간
`year`	No	조회할 연도 (예: 2025) - 생략하면 현재 주간

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "categoryId": {
      "description": "카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용",
      "type": "string"
    },
    "maxResults": {
      "default": 10,
      "description": "최대 결과 개수",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "month": {
      "description": "조회할 월 (1-12) - 생략하면 현재 주간",
      "maximum": 12,
      "minimum": 1,
      "type": "number"
    },
    "start": {
      "default": 1,
      "description": "검색 시작 번호",
      "minimum": 1,
      "type": "number"
    },
    "week": {
      "description": "조회할 주 (1-5) - 생략하면 현재 주간",
      "maximum": 5,
      "minimum": 1,
      "type": "number"
    },
    "year": {
      "description": "조회할 연도 (예: 2025) - 생략하면 현재 주간",
      "maximum": 2030,
      "minimum": 2000,
      "type": "number"
    }
  },
  "type": "object"
}

Aladin Book Search MCP Server

get_bestsellers

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Aladin Book Search MCP Server

Related Tools

MCP directory API