# Bid Radar

나라장터(G2B)와 국방전자조달(D2B) 입찰정보를 Claude에서 바로 조회하는 MCP 서버입니다.
공공데이터포털에서 발급받은 **본인 인증키**로 동작하고, API 원자료만 출처와 함께 보여줍니다.

| | 조회 대상 | 필요한 공공데이터포털 API(활용신청) |
|---|---|---|
| **G2B Bid Radar** | 조달청 나라장터 | 입찰공고정보 · 낙찰정보 · 사전규격정보 · 사용자정보 서비스 |
| **D2B Bid Radar** | 방위사업청 국방전자조달 — 시설(공사·용역) | 군수품조달정보 조달계획 · 입찰공고 · 입찰결과 · 계약정보 (_GW) |

두 서버는 따로 설치합니다. 나라장터만 보면 G2B, 군 시설사업까지 보면 둘 다 설치하세요. 같은 인증키 하나로 둘 다 쓸 수 있고, 활용승인된 API만으로도 동작합니다(승인 안 된 API를 쓰는 도구는 그 사실을 알려줍니다).

## 주요 기능

**G2B Bid Radar**

| 도구 | 하는 일 |
|---|---|
| `g2b_search_bids` | 입찰공고 검색 — 공고명·기관·업종·지역·금액·기간 |
| `g2b_bid_detail` | 공고 1건 종합카드 — 금액·일정·기초금액·면허제한·참가지역·첨부파일 |
| `g2b_bid_changes` | 공고 변경이력(변경 전/후 값) |
| `g2b_bid_result` | 개찰결과 — 낙찰업체·낙찰률·예정가격·개찰순위표·유찰 사유 |
| `g2b_search_awards` | 낙찰 목록 검색 |
| `g2b_search_prespecs` | 사전규격 검색 |
| `g2b_company_profile` | 조달업체 조회 — 기본정보·등록업종·부정당제재 이력 |
| `g2b_check_setup` | 인증키·활용승인 상태 점검 |

**D2B Bid Radar**

| 도구 | 하는 일 |
|---|---|
| `d2b_search_bids` | 시설 경쟁입찰공고·공개수의협상 검색 |
| `d2b_bid_detail` | 공고 1건 상세 — 공사개요·금액·사정률·면허/지역 제한·일정 |
| `d2b_plans` | 조달계획(발주 예정 사업) 조회 |
| `d2b_search_results` | 입찰결과 검색 |
| `d2b_bid_result` | 낙찰업체·참가업체 순위표·복수예비가격 |
| `d2b_contracts` | 계약정보 검색 — 계약업체·금액·기간 |
| `d2b_project` | 공사번호 하나로 계획 → 공고 → 결과 → 계약 연혁 |
| `d2b_check_setup` | 인증키·활용승인 상태 점검 |

## 설치

### 0. 인증키 받기

1. [공공데이터포털](https://www.data.go.kr)에 로그인합니다.
2. 위 표의 API를 검색해 각각 **활용신청**합니다.
3. 마이페이지의 인증키 정보에서 **일반 인증키(Decoding)** 를 복사합니다.

### Claude 데스크톱 — 파일로 설치 (가장 쉬움)

1. [Releases](https://github.com/Jaem-Shin/bid-radar/releases)에서 `g2b-bid-radar-x.x.x.mcpb` / `d2b-bid-radar-x.x.x.mcpb`를 받습니다.
2. Claude 데스크톱 → **설정 → 확장 프로그램 → 고급 설정 → 확장 프로그램 설치…** 에서 받은 파일을 고릅니다.
3. 인증키(필수)와 회사 사업자번호(선택)를 넣고 켭니다.

새 버전은 자동으로 받아져 Claude를 다시 시작하면 적용됩니다. 새로 설치할 때만 위 과정을 거치면 됩니다.

### Claude Code

```bash
claude mcp add -s user -e DATA_GO_KR_SERVICE_KEY=인증키 --transport stdio g2b-bid-radar -- npx -y github:Jaem-Shin/bid-radar g2b
claude mcp add -s user -e DATA_GO_KR_SERVICE_KEY=인증키 --transport stdio d2b-bid-radar -- npx -y github:Jaem-Shin/bid-radar d2b
```

### 그 밖의 MCP 클라이언트 (Cursor, Windsurf, Claude 데스크톱 설정 파일 등)

```json
{
  "mcpServers": {
    "g2b-bid-radar": {
      "command": "npx",
      "args": ["-y", "github:Jaem-Shin/bid-radar", "g2b"],
      "env": { "DATA_GO_KR_SERVICE_KEY": "인증키", "MY_BIZNO": "" }
    },
    "d2b-bid-radar": {
      "command": "npx",
      "args": ["-y", "github:Jaem-Shin/bid-radar", "d2b"],
      "env": { "DATA_GO_KR_SERVICE_KEY": "인증키", "MY_BIZNO": "" }
    }
  }
}
```

npx 방식은 Node.js 18 이상과 Git이 필요합니다. `MY_BIZNO`(회사 사업자번호, 선택)를 넣으면 결과에서 우리 회사가 ★로 표시됩니다.

## 사용법

설치 후 "G2B 설정 점검해줘" / "D2B 설정 점검해줘"로 연결을 확인하고, 평소 말로 물어보면 됩니다.

- "이번 달 국방시설본부 설계용역 공고 찾아줘"
- "이 공고 상세랑 변경이력 보여줘"
- "이 공고 개찰 결과 알려줘"
- "다음 분기 D2B 조달계획에 감리 용역 있어?"
- "이 공사번호 계획부터 계약까지 이어서 보여줘"

결과 표시 원칙

- 모든 값은 API 원자료입니다. 원자료로 계산한 값에는 **(계산)** 이 붙습니다.
- 자료가 없으면 추측하지 않고 **[NOT_FOUND]**, 출처끼리 값이 다르면 **⚠ 불일치** 로 표시합니다.
- 참가 가능 여부는 판단하지 않습니다. 반드시 공고 원문으로 확인하세요.
- 업체 대표자명·전화번호는 표시하지 않습니다.

## 업데이트 내역

| 버전 | 날짜 | 내용 |
|---|---|---|
| 0.0.2 | 2026-10-15 | npx 설치 지원(Claude Code·기타 MCP 클라이언트), 인증키 안내 문구 정리 |
| 0.0.1 | 2026-10-15 | 첫 공개 — G2B 8개·D2B 9개 도구, 자동 업데이트 |

0.0.x는 실제 응답으로 검증 중인 단계입니다. 특히 D2B는 공공데이터포털 명세 기준으로 만들어 일부 조회 조건이 바뀔 수 있습니다.

## 라이선스

[MIT](LICENSE) · 데이터 출처: 공공데이터포털(조달청, 방위사업청) · 조달청·방위사업청과 관계없는 개인 프로젝트입니다.