narajangteo-pro
naramarket-pro-MCP
这是一个集成了 6 种韩国国家综合电子采购网 (Nara Market) 公共采购 API 的 MCP 服务器。通过与 Claude Desktop 等 MCP 客户端连接,可以使用自然语言进行招标公告搜索、市场分析、投标适宜性评估等操作。
主要功能
6 种公共采购 API 联动
整合了国家综合电子采购网的主要公共 API,支持查询多种数据。
招标公告: 按关键词、机构、日期搜索公告
中标信息: 查询中标企业及金额
合同信息: 确认实际合同签署明细
合同流程综合公开: 追踪从预先规格到合同签署的全过程
采购请求: 查询发标前阶段的数据
综合购物中心品目: 搜索单价合同注册品目
通用 API 客户端 (api/client.py) 处理以下功能:
响应格式标准化
请求超时自动重试(最多 2 次)
内存缓存(默认 5 分钟)
8 种 MCP 工具配置
为了在 LLM 环境中高效使用,将其配置为功能单元工具。
工具名称 | 说明 |
| 招标 / 中标 / 合同 / 请求 / 购物中心综合搜索 |
| 查询详细信息 |
| 追踪采购进度阶段 |
| 基于关键词的市场趋势分析 |
| 特定企业采购活动分析 |
| 基于企业信息的投标适宜性分析 |
| 注册关注关键词及确认新公告 |
| 保存 / 加载公司资料 |
自然语言输入处理
实现了将用户日常用语自动转换为 API 参数的功能。
时间表达 — 最近 7 天 / 过去 3 个月 / 今年
金额表达 — 5 亿 / 1.5 亿 / 3 千万韩元
业务分类同义词 — 服务 → 劳务 / 建设 → 工程
状态存储
基于 SQLite 存储用户设置数据。存储项包括关注列表 (Watchlist) 和公司资料,默认存储位置如下。
~/.narajangteo-pro/state.dbRelated MCP server: narajangteo-searcher
快速开始
1. 获取 API 密钥
在 公共数据门户 (data.go.kr) 申请使用以下服务后,在“我的页面” → “开发账号”中复制 ServiceKey 的 Decoding 值。
韩国采购厅_国家综合电子采购网招标公告信息服务
韩国采购厅_国家综合电子采购网中标信息服务
韩国采购厅_国家综合电子采购网合同信息服务
韩国采购厅_国家综合电子采购网合同流程综合公开服务
2. 安装
# uvx (권장 — Python 설치 없이 실행)
uvx narajangteo-pro
# npx
npx narajangteo-pro
# pip
pip install narajangteo-pro
narajangteo-pro3. 连接 Claude Desktop
修改以下路径的配置文件。
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"narajangteo-pro": {
"command": "uvx",
"args": ["narajangteo-pro@latest"],
"env": {
"NARA_API_KEY": "발급받은_디코딩_서비스키"
}
}
}
}重启 Claude Desktop 后即可使用。
“帮我分析一下最近 1 个月 AI 聊天机器人领域的市场情况”
“显示公告编号 20260415123 从预先规格到合同签署的全过程”
“根据我们公司的资料,评估一下是否适合投标这个公告”
架构
┌─────────────────────────────────────┐
│ Claude Desktop / Cursor / VS Code │
└──────────────────┬──────────────────┘
│ MCP (stdio | HTTP)
┌──────────────────▼──────────────────┐
│ narajangteo-pro │
│ ┌────────┐ ┌──────────┐ ┌──────┐ │
│ │ Tools │→ │Analytics │→ │ DB │ │
│ └───┬────┘ └────┬─────┘ └──────┘ │
│ └────────────┘ │
│ ┌──────────┐ │
│ │API Client│ │
│ └────┬─────┘ │
└──────────────┼──────────────────────┘
│
┌─────────▼──────────┐
│ 공공데이터포털 │
│ 나라장터 API 6종 │
└────────────────────┘许可证
MIT
Available Tools
8 toolsanalyze_competitorA
특정 기업의 조달시장 활동 분석.
낙찰 건수/금액, 주력 분야, 평균 낙찰가율, 거래 발주기관 패턴을 분석.
Args: company_name: 기업명 (정확하지 않아도 부분 일치) period_months: 분석 기간 business_type: 업무구분 또는 'all'
Inputs: company_name (required), period_months, business_type. Returns: object
analyze_marketA
특정 분야 시장 동향 분석.
낙찰 데이터를 집계하여 월별 추이, 평균 낙찰가율, 상위 발주기관/낙찰업체, 추정 시장 규모를 반환.
Args: keyword: 분석 대상 키워드 (예: 'AI 챗봇', '클라우드') period_months: 분석 기간 — 기본 12개월 business_type: 업무구분 또는 'all' (4개 합산)
Inputs: keyword (required), period_months, business_type. Returns: object
get_procurement_detailA
입찰공고/낙찰/계약/조달요청/쇼핑몰품목 상세 정보 조회.
Args: domain: 'bid'(입찰공고), 'award'(낙찰), 'contract'(계약), 'request'(조달요청), 'shopping'(종합쇼핑몰 품목) notice_no: 식별 번호 - bid/award: 입찰공고번호 - contract: 확정계약번호 - request: 조달요청번호 - shopping: 품목식별번호 business_type: 업무구분 (shopping은 무시) notice_ord: 공고차수 (보통 '00')
Inputs: domain (required), notice_no (required), business_type, notice_ord. Returns: object
manage_company_profileA
회사 프로필 관리 — 적합도 평가에 재사용.
actions: - 'save': 저장 (profile_id, name 필수). 같은 ID면 업데이트. - 'load': 조회 (profile_id 필수) - 'list': 모든 프로필 목록 - 'delete': 삭제 (profile_id 필수)
revenue는 자연어 표현 가능: '50억', '100억원' 등.
Inputs: action (required), profile_id, name, licenses, +4 more. Returns: object
manage_watchlistB
관심 키워드 모니터링.
actions: - 'add': 새 키워드 등록 (keyword 필수) - 'remove': 등록 해제 (watch_id 필수) - 'list': 등록된 키워드 목록 - 'check_new': 등록한 키워드의 신규 공고 (마지막 확인 이후)
Inputs: action (required), keyword, business_type, institution, +1 more. Returns: object
score_bid_fitA
입찰 적합도 평가 — 0-100 점수 + 권고.
회사 프로필(보유 면허, 매출, 실적)과 공고 요구사항을 매칭해 적합도를 산출.
Args: bid_notice_no: 입찰공고번호 business_type: 업무구분 profile_id: 저장된 회사 프로필 ID (manage_company_profile로 미리 저장) inline_profile: 즉석 프로필 dict (저장 없이 일회성 평가) {"licenses": [...], "certifications": [...], "revenue": int, "prior_contracts": [...]} notice_ord: 공고차수
Inputs: bid_notice_no (required), business_type, profile_id, inline_profile, +1 more. Returns: object
search_procurementA
나라장터 통합 검색 도구.
하나의 도구로 5개 영역을 모두 검색한다.
Args: domain: 검색 영역 - 'bid': 입찰공고 - 'award': 낙찰결과 - 'contract': 체결된 계약 - 'request': 조달요청 (발주의 가장 이른 단계 — 영업 선행지표) - 'shopping': 종합쇼핑몰 품목 (단가계약 등록 품목) business_type: 업무구분 — '물품', '용역', '공사', '외자' (자연어 표현 자동 매핑) 'shopping' 도메인은 이 파라미터를 무시. keyword: 공고명/품목명 키워드 institution: 발주기관/계약기관명 (shopping에선 공급업체명으로 사용) period: 자연어 기간 — '최근 7일', '지난 3개월', '올해' 등 (date_from/to보다 우선) date_from: 시작일 YYYYMMDD date_to: 종료일 YYYYMMDD limit: 최대 결과 수 (1-100)
Returns: {"items": [...], "total_count": int, "page_no": int}
Inputs: domain, business_type, keyword, institution, +4 more. Returns: object
trace_procurement_lifecycleA
⭐ 조달 전 과정 추적 — 사전규격 → 공고 → 낙찰 → 계약을 한 번에.
이 도구가 narajangteo-pro의 시그니처 기능. 식별자 하나만 알면 조달 라이프사이클 전체를 추적해 타임라인으로 반환한다.
Args: id_value: 식별 번호 business_type: 업무구분 id_type: 식별자 종류 - 'bid_notice': 입찰공고번호 (가장 흔함) - 'spec': 사전규격등록번호 - 'plan': 발주계획번호 - 'request': 조달요청번호
Inputs: id_value (required), business_type, id_type. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: analysis per company or market, detail retrieval, profile/watchlist management, fit scoring, search, and lifecycle tracing. No two tools overlap significantly.
All tool names follow a consistent verb_noun pattern in snake_case, e.g., analyze_competitor, manage_watchlist. No mixing of camelCase or other conventions.
8 tools is ideal for this domain, covering search, detail, analysis, management, scoring, and tracing without being too few or too many.
Covers core procurement activities well, but lacks a direct tool for comparing bids or exporting reports. The analysis tools provide aggregated data, mitigating minor gaps.
Maintenance
Related MCP Connectors
Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…
나라장터 입찰공고·사전규격·낙찰정보 검색. Korean public procurement bids via KONEPS open API.
Korea Government Procurement MCP — KONEPS (나라장터 / g2b) open bids and procurement vendors, via BOIM…
Korean statutes, precedents, local business-district stats and public procurement for AI agents.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceEnables AI assistants to query and analyze Korean public procurement data from the Korea Public Procurement Service (G2B/Nuri) via 14 services and 156 operations, including bid announcements, contracts, prices, and statistics.171-
- AlicenseAqualityCmaintenanceEnables users to search and analyze Korean public procurement IT bid announcements, including full bid opening results, through natural language conversation with Claude.81MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching Korean procurement notices from the public data portal, with support for integrated search across categories, flexible date ranges, and attachment extraction.MIT

io.github.opendataofficial
AlicenseAqualityCmaintenanceEnables querying Korean procurement corporate profiles and qualifications using business registration numbers through natural language, leveraging the public data API from data.go.kr.252 npmMIT