나라장터 입찰 MCP

io.github.donghyeon01由 GitHub 帳號 donghyeon01 發布v0.1.0更新於 Oct 24, 2026

나라장터 입찰공고·사전규격·낙찰정보 검색. Korean public procurement bids via KONEPS open API.

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

遠端 MCP 伺服器,用來查詢韓國國家電子採購系統(나라장터/KONEPS)的招標公告、事前規格與得標歷史,並可選用電子郵件提醒。

可以做什麼
依關鍵字、期間、業務類型、地區與預估價格查詢招標公告,回傳公告編號、截止時間與原文連結。查詢公告詳情:資格條件、時程、基礎金額與預估價格、契約方式、附件連結與變更紀錄。查詢正式公告前公布的事前規格,便於提早發掘機會。依機關、關鍵字與業務類型彙整歷史得標結果,包括得標率分布與常見得標廠商。管理提醒條件,每日比對新公告並寄送電子郵件。
適用情境
適合讓助理查詢韓國公共招標、確認某則公告的參與資格與截止時間,或追蹤得標趨勢與符合條件的新公告,而不必手動瀏覽採購入口網站。
執行需求
遠端 Streamable HTTP 端點;免費工具不需安裝或 API 金鑰。Pro 工具與較高額度需要授權金鑰,透過 Authorization Bearer 標頭傳送。需要能連線至該端點的網路。
安裝前請注意
免費工具依 IP 限制每日 30 次呼叫;Pro 功能需要付費授權金鑰,該金鑰屬機密,應妥善保管。提醒條件會儲存電子郵件地址,並觸發每日寄信。資料來自公共採購開放 API,每小時蒐集一次,最新公告可能尚未收錄。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 나라장터 입찰 MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.donghyeon01%2Fkr-public-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "io-github-donghyeon01-kr-public-yhjd": {
      "type": "http",
      "url": "https://kr-public-mcp.songdonghyeon01.workers.dev/mcp"
    }
  }
}

README

kr-public-mcp — 나라장터 입찰공고 MCP 서버

[MCP] [Cloudflare Workers] [TypeScript] [License: MIT]

Claude·ChatGPT·Cursor에서 나라장터(조달청) 입찰공고를 검색하고 상세를 조회하는 원격 MCP 서버. 설치·인증키 없이 URL만 붙이면 동작한다 (Streamable HTTP).

  • 엔드포인트: https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
  • 데이터: 조달청 나라장터 공공데이터포털 오픈API (입찰공고·사전규격·낙찰정보)
  • 모든 응답에 출처와 나라장터 원문 링크를 포함한다

도구

도구등급설명
search_bids무료입찰공고 검색 — 키워드·기간·업무구분(공사/용역/물품/외자)·지역·추정가 범위
get_bid_detail무료공고 상세 — 자격요건(면허·참가지역), 일정, 기초금액·추정가, 첨부 링크, 변경 이력
search_pre_specsPro사전규격 검색 — 본공고 전 단계 조기 발굴
analyze_historyPro낙찰 이력 집계 — 낙찰률 분포·다빈도 업체·평균 참가수
watch_bidsPro알림 조건 저장 → 매일 08:00 KST 이메일 매칭 + 마감 임박 알림

무료 도구는 IP 기준 일 30회. Pro는 라이선스 키(크몽 이용권)로 한도 해제 + Pro 도구 개방.

연결

bash
# Claude Codeclaude mcp add --transport http narajangteo https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
jsonc
// 일반 MCP 클라이언트 설정{  "mcpServers": {    "narajangteo": {      "url": "https://kr-public-mcp.songdonghyeon01.workers.dev/mcp",    },  },}

Pro 키 사용 시 헤더: Authorization: Bearer <라이선스 키>.

사용 예시

text
사용자: 이번 주 마감하는 서울 지역 용역 입찰공고 찾아줘→ search_bids(keyword="", region="서울", category="용역", deadline="...") 호출→ 공고명·마감일·추정가·나라장터 원문 링크 목록 응답
사용자: 0012345678 공고의 참가자격 알려줘→ get_bid_detail(bidNo="0012345678") 호출→ 면허·지역 제한, 입찰 일정, 기초금액, 첨부 링크 응답

아키텍처

Cloudflare Workers (stateless createMcpHandler) + D1 + KV + Cron. 수집(Cron → 조달청 API → D1)과 조회(MCP → D1)를 분리해 API 호출 수를 사용자 수와 무관하게 유지 (서버비 ≈ 0 설계). 공무원 성명·연락처는 응답에서 제거하고 저장하지 않는다.

개발

bash
npm installnpm run db:migrate:local && npm run devnpm run typecheck

셋업·배포·운영 규칙: AGENTS.md 참조.

라이선스

MIT. 데이터 출처: 조달청 나라장터 (공공데이터포털 오픈API).

來源:README.md,提交 5b86cc7

工具

5

search_bids

나라장터 입찰공고를 검색한다. 공고명·기관 키워드, 기간, 업무구분(공사/용역/물품/외자), 지역, 추정가격 범위로 필터링. 수집된 공고만 검색된다(수집은 매시간). 반환: 공고번호, 공고명, 수요기관, 추정가격, 입찰마감일시, D-day, 원문 링크.

輸入參數limitregionkeywordto_datecategoryfrom_datemax_pricemin_price

get_bid_detail

입찰공고 상세 조회. 자격요건(면허·참가가능지역), 일정(공고·개찰·마감), 기초금액·추정가격, 계약방법, 첨부파일 링크, 변경 이력을 반환한다. search_bids 결과의 공고번호를 넣으면 된다.

輸入參數bid_no必填bid_seq

search_pre_specs

나라장터 사전규격(발주 전 규격 공개)을 검색한다. 본공고 전 단계라 조기 발굴에 유용하다. 반환: 사전규격등록번호, 품명, 수요기관, 배정예산, 의견 마감일, 연결된 본공고 번호. Pro 전용.

輸入參數agencykeywordto_datecategoryfrom_date

analyze_history

과거 낙찰 결과를 기관·키워드·업무구분으로 집계한다. 낙찰률 분포(최소·평균·최대), 다빈도 낙찰업체, 평균 참가업체 수, 최근 낙찰 목록을 반환한다. Pro 전용.

輸入參數agencymonthskeywordcategory

watch_bids

입찰 알림 조건을 관리한다. add로 조건+이메일 저장, list로 조건 확인, remove로 삭제, matches로 최근 매칭 공고 조회. 저장된 조건은 매일 08:00 KST에 신규 공고와 매칭해 이메일로 보낸다. Pro 전용.

輸入參數emaillabelaction必填regionkeywordcategorywatch_idmax_pricemin_price

版本歷史

1
  1. v0.1.0最新Sep 23, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分