get_blogger_best
Retrieve bestselling book lists from Aladin Bloggers by category, focusing on domestic titles. Customize results with maxResults and start parameters for targeted searches.
Instructions
알라딘 블로거 베스트셀러 목록을 조회합니다. 국내도서만 조회 가능하며, 카테고리별로 검색할 수 있습니다.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| categoryId | No | 카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용 | |
| maxResults | No | 최대 결과 개수 | |
| start | No | 검색 시작 번호 |
Implementation Reference
- src/index.ts:615-668 (handler)Handler function implementing the logic for 'get_blogger_best' tool: calls Aladin API with QueryType='BlogBest', processes book items into standardized format, handles category filtering, and returns formatted results or error.async ({ maxResults, start, categoryId }) => { try { const params: any = { QueryType: 'BlogBest', MaxResults: maxResults, start: start, SearchTarget: 'Book', Cover: 'Big' }; if (categoryId) { params.CategoryId = categoryId; } const result = await callAladinApi('ItemList.aspx', params); const books: BookSearchResult[] = result.item?.map((item: any) => ({ title: item.title || '', author: item.author || '', publisher: item.publisher || '', pubDate: item.pubDate || '', isbn: item.isbn || '', isbn13: item.isbn13 || '', cover: item.cover || '', categoryName: item.categoryName || '', description: item.description || '', priceStandard: item.priceStandard || 0, priceSales: item.priceSales || 0, link: item.link || '', pages: item.subInfo?.itemPage || undefined, pricePerPage: (item.priceStandard > 0 && item.subInfo?.itemPage > 0) ? parseFloat((item.priceStandard / item.subInfo.itemPage).toFixed(2)) : undefined })) || []; const categoryText = categoryId ? ` (카테고리: ${categoryId})` : ''; return { content: [{ type: 'text', text: `📝 블로거 베스트셀러${categoryText} (국내도서만)\n\n검색된 도서 수: ${books.length}권\n\n${JSON.stringify(books, null, 2)}` }] }; } catch (error) { logger.error(`블로거 베스트셀러 조회 중 오류 발생: ${error}`); return { content: [{ type: 'text', text: `블로거 베스트셀러 조회 중 오류가 발생했습니다: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } }
- src/index.ts:606-613 (schema)Tool schema definition including title, description, and Zod input schema for parameters: maxResults, start, categoryId.{ title: '블로거 베스트셀러', description: '알라딘 블로거 베스트셀러 목록을 조회합니다. 국내도서만 조회 가능하며, 카테고리별로 검색할 수 있습니다.', inputSchema: { maxResults: z.number().min(1).max(100).default(10).describe('최대 결과 개수'), start: z.number().min(1).default(1).describe('검색 시작 번호'), categoryId: z.string().optional().describe('카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용') }
- src/index.ts:604-669 (registration)Registration of the 'get_blogger_best' tool on the MCP server using server.registerTool, including schema and inline handler.server.registerTool( 'get_blogger_best', { title: '블로거 베스트셀러', description: '알라딘 블로거 베스트셀러 목록을 조회합니다. 국내도서만 조회 가능하며, 카테고리별로 검색할 수 있습니다.', inputSchema: { maxResults: z.number().min(1).max(100).default(10).describe('최대 결과 개수'), start: z.number().min(1).default(1).describe('검색 시작 번호'), categoryId: z.string().optional().describe('카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용') } }, async ({ maxResults, start, categoryId }) => { try { const params: any = { QueryType: 'BlogBest', MaxResults: maxResults, start: start, SearchTarget: 'Book', Cover: 'Big' }; if (categoryId) { params.CategoryId = categoryId; } const result = await callAladinApi('ItemList.aspx', params); const books: BookSearchResult[] = result.item?.map((item: any) => ({ title: item.title || '', author: item.author || '', publisher: item.publisher || '', pubDate: item.pubDate || '', isbn: item.isbn || '', isbn13: item.isbn13 || '', cover: item.cover || '', categoryName: item.categoryName || '', description: item.description || '', priceStandard: item.priceStandard || 0, priceSales: item.priceSales || 0, link: item.link || '', pages: item.subInfo?.itemPage || undefined, pricePerPage: (item.priceStandard > 0 && item.subInfo?.itemPage > 0) ? parseFloat((item.priceStandard / item.subInfo.itemPage).toFixed(2)) : undefined })) || []; const categoryText = categoryId ? ` (카테고리: ${categoryId})` : ''; return { content: [{ type: 'text', text: `📝 블로거 베스트셀러${categoryText} (국내도서만)\n\n검색된 도서 수: ${books.length}권\n\n${JSON.stringify(books, null, 2)}` }] }; } catch (error) { logger.error(`블로거 베스트셀러 조회 중 오류 발생: ${error}`); return { content: [{ type: 'text', text: `블로거 베스트셀러 조회 중 오류가 발생했습니다: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } );
- src/index.ts:147-168 (helper)Shared helper function used by get_blogger_best to make API calls to Aladin's ItemList.aspx with BlogBest query type.async function callAladinApi(endpoint: string, params: Record<string, any>): Promise<any> { if (!ALADIN_TTB_KEY || ALADIN_TTB_KEY.length === 0) { throw new Error('알라딘 API 키가 설정되지 않았습니다. ALADIN_TTB_KEY 환경변수를 올바르게 설정해주세요.'); } const baseParams = { ttbkey: ALADIN_TTB_KEY, output: 'js', version: '20131101' }; const finalParams = { ...baseParams, ...params }; const url = `${ALADIN_BASE_URL}/${endpoint}`; try { const response = await axios.get(url, { params: finalParams }); return response.data; } catch (error) { logger.error(`알라딘 API 호출 오류: ${error}`); throw error; } }
- src/index.ts:122-137 (schema)TypeScript interface defining the structure of book search results used in the tool's response processing.interface BookSearchResult { title: string; author: string; publisher: string; pubDate: string; isbn: string; isbn13: string; cover: string; categoryName: string; description: string; priceStandard: number; priceSales: number; link: string; pages?: number; // 페이지 수 추가 pricePerPage?: number; // 쪽단가 추가 }