aladin-book-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALADIN_TTB_KEY | Yes | Your Aladin OpenAPI TTB Key (required for all operations) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aladin_book_statusA | 인증키 상태 점검 및 알라딘 Open API 실제 왕복 1회 연결 상태를 점검합니다. |
| aladin_book_searchB | 알라딘 Open API로 도서를 검색합니다. Args:
query: 검색어 (도서명, 저자명, 출판사, 키워드 등)
query_type: 검색 대상 필드 ('Keyword', 'Title', 'Author', 'Publisher')
search_target: 검색 카테고리 ('Book', 'Foreign', 'Music', 'DVD', 'Used', 'eBook', 'All')
start: 시작 페이지 번호 (1 |
| aladin_book_lookupA | ISBN13 또는 상품ID로 특정 도서의 원서명, 목차, 쪽수, 판형, 부제, 중고가, 전자책 상세 정보를 조회합니다. Args: item_id: 13자리 ISBN, 10자리 ISBN, 또는 알라딘 ItemId item_id_type: 식별자 타입 ('ISBN13', 'ISBN', 'ItemId' - 미지정시 길이로 자동 감지) opt_result: 부가 정보 요청 플래그 (기본: 'ebookList,usedList,subInfo,packing') |
| aladin_book_listA | 알라딘 베스트셀러, 신간, 추천도서 등 큐레이션 리스트를 조회합니다. Args:
query_type: 리스트 종류 ('Bestseller', 'ItemNewAll', 'ItemNewSpecial', 'ItemEditorChoice', 'BlogBest')
search_target: 대상 카테고리 ('Book', 'Foreign', 'Music', 'DVD', 'Used', 'eBook', 'All')
start: 시작 페이지 번호 (1 |
| aladin_book_collectA | 다중 검색어로 도서를 대량 수집하고, 중복 제거 후 xlsx, csv, json, sqlite 파일로 저장합니다. Args: terms: 수집할 검색어 목록 (예: ['인공지능', '머신러닝']) max_items_per_term: 검색어당 최대 수집 건수 (기본 30) query_type: 검색 필드 ('Keyword', 'Title', 'Author', 'Publisher') search_target: 검색 대상 ('Book', 'eBook', 'All' 등) sort: 정렬 순서 ('Accuracy', 'PublishTime', 'SalesPoint') opt_lookup: True 설정 시 각 도서별 목차/원서명/쪽수 상세 정보(ItemLookUp)까지 추가 조회 export_dir: 파일 저장 폴더 경로 (미지정 시 파일 저장 안 함) export_formats: 저장 포맷 리스트 (['xlsx', 'csv', 'json', 'sqlite'] 중 선택) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a distinct purpose: status check, search, item lookup, curated lists, and bulk collection. Search and collect overlap somewhat since collect is built on search, but their inputs and outputs clearly separate them.
All tools share the consistent `aladin_book_` prefix and mostly use verb-like suffixes: search, lookup, list, collect. The exception is `aladin_book_status`, which uses a noun rather than a verb, slightly breaking the pattern.
Five tools is a well-scoped count for a book API server. Each tool maps to a distinct operation type and the set avoids unnecessary bloat.
The server covers core book domain workflows: searching, retrieving detailed item info, browsing curated lists, and bulk collecting with export. Minor gaps exist, such as no dedicated category browsing or review retrieval, but the main use cases are well covered.