BizBell 공고 API

창업지원(K-Startup)·기업입찰(나라장터)·기업지원(기업마당)·R&D(IRIS·과기정통부) 공고를 하나의 스키마로 검색하고, 즐겨찾기와 키워드 알림을 관리합니다. 구글 계정으로 로그인하면 무료로 쓸 수 있습니다.

bizbell.site 공고 페이지는 검색엔진·AI 서비스의 색인과 인용을 환영합니다. 공고 페이지·피드를 대량으로 또는 반복적·체계적으로 수집하거나 데이터셋으로 만드는 것은 허용하지 않으며, 공고 데이터는 이 API 로 제공합니다(이용약관 제8조·제8장).

시작하기

에이전트(Claude Code·Codex·Cursor 등)에 붙이려면 세 줄이면 됩니다.

npx skills add https://bizbell.site                 # Agent Skill 설치
npx -y bizbell@latest login       # 구글 로그인 → API 키 저장
npx -y bizbell@latest search "AI 바우처" -c support --json

REST 로 직접 부를 때는 키를 헤더에 넣습니다.

curl -H "Authorization: Bearer $BIZBELL_API_KEY" \
  "https://bizbell.site/api/v1/notices?q=AI&category=support,startup&deadline_within=14&limit=5"

인증과 키

키는 설정 → API 키 또는 npx -y bizbell@latest login(브라우저에서 코드 승인)으로 받습니다. 형식은 bb_live_… 이고, 만들 때 한 번만 보입니다.

Authorization: Bearer <키> 또는 X-API-Key: <키> 헤더로 보냅니다. URL 쿼리로는 받지 않습니다. CLI·MCP 는 BIZBELL_API_KEY 환경 변수도 읽습니다.

notices:read — 공고 검색·상세·분야·출처
favorites:write — 즐겨찾기 목록·추가·삭제
alerts:write — 키워드 알림·매칭·메일 설정

에이전트에는 필요한 권한만 고른 키를 주세요. API 키로는 새 키를 만들 수 없습니다.

엔드포인트

기준 URL은 https://bizbell.site/api/v1 입니다. 반복 값은 쉼표로 잇습니다(category=bid,startup).

get/notices

공고 검색·목록

기본은 모집중(status=open, 상시 포함), 최신 게시순. 반복 값은 쉼표로 잇거나 같은 이름을 반복한다. total 은 첫 페이지에만 오는 추정 건수다.

권한: notices:read

q: 검색어(제목). 동의어를 자동으로 넓힌다
category: 분야, 쉼표 구분(startup,bid,support,rnd). 생략하면 전체
source: 원천 소스 id, 쉼표 구분(kstartup,nara,bizinfo,iris,msit …). GET /sources 참고
status: open(기본, 상시 포함) | upcoming | closed | all. updated_since 를 주면 기본이 all
region: 지역, 쉼표 구분(서울,경기 …). 전국 공고는 항상 포함하고 rnd 에는 적용하지 않는다
organization: 소관·수행 기관 부분 일치
deadline_within: 오늘부터 N일 안에 마감(KST)
deadline_after: N일 뒤 이후에 마감
always_open: 상시 모집 여부
budget_min: 최소 금액(원). bid·rnd 만 값이 있다
budget_max: 최대 금액(원)
published_since: ISO 8601. 이 시각 이후 게시
updated_since: ISO 8601. 이 시각 이후 바뀐 공고(증분 동기화). 마감·비활성(취소) 공고도 오며(기본 status=all, sort=updated_desc) 한 번의 동기화는 모든 페이지가 같은 meta.as_of 를 돌려준다. 끝까지 받은 뒤 그 as_of 를 다음 updated_since 로 쓴다
sort: 정렬. updated_since 를 주면 기본이 updated_desc
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor
fields: 응답 필드 선택, 쉼표 구분(예: id,title,deadline_at). attribution·source_url 은 지정과 관계없이 항상 포함

get/notices/{id}

공고 상세

권한: notices:read

id: 공고 id(예: nara:R26BK01752060)
fields: 응답 필드 선택(attribution·source_url 은 항상 포함)

get/notices/{id}/history

나라장터 정정 차수 이력·낙찰

권한: notices:read

id: nara:{공고번호}

get/categories

분야별 모집중 건수·마지막 수집 시각

권한: notices:read

get/sources

소스 레지스트리

권한: notices:read

get/meta/regions

지역 이름 목록

권한: notices:read

get/me

내 플랜·사용량·키

모든 키로 부를 수 있고 쿼터에 세지 않는다.

권한: 모든 키

get/favorites

즐겨찾기 목록

권한: favorites:write

status: active(기본) | expired | all
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor

post/favorites

즐겨찾기 추가(이미 있으면 기존 항목, 200)

권한: favorites:write

patch/favorites/{id}

메모 수정

권한: favorites:write

id: 즐겨찾기 id

delete/favorites/{id}

즐겨찾기 삭제

권한: favorites:write

id: 즐겨찾기 id

get/alerts

키워드 알림 목록

권한: alerts:write

post/alerts

키워드 알림 만들기

권한: alerts:write

patch/alerts/{id}

알림 수정(category 제외)

권한: alerts:write

id: 알림 id

delete/alerts/{id}

알림 삭제

권한: alerts:write

id: 알림 id

post/alerts/{id}/test

최근 N일 매칭 미리보기(메일 발송 없음, 최대 50건)

권한: alerts:write

id: 알림 id
days: 1~30, 기본 7

get/alerts/matches

모든 활성 알림의 신규 매칭(폴링)

since 이후 BizBell 에 새로 보인 공고 중 알림에 맞는 것. since 기본은 24시간 전, 최대 30일 전. 다음 폴링의 since 에는 meta.as_of 를 쓰고, 같은 공고가 다시 올 수 있으니 id 로 중복을 거른다. 후보가 너무 많아 일부만 살폈으면 meta.truncated=true 다(since 를 좁혀 다시 요청).

권한: alerts:write

since: ISO 8601 날짜나 시각
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor

get/alerts/settings

일일 메일 설정

권한: alerts:write

patch/alerts/settings

일일 메일 설정 수정

권한: alerts:write

공고 필드

id 는 {source}:{원천 id}(예: nara:R26BK01752060)입니다. 시간은 UTC ISO 8601, 날짜만 아는 원천은 deadline_date(KST)로 줍니다. 담당자·연락처·사업자번호 같은 개인정보는 제공하지 않습니다.

id: {source}:{원천 id}
category: startup | bid | support | rnd
source
title: 원문 제목(변경하지 않음)
organization: 소관·공고 기관
executing_org: 수행·수요 기관
regions: 시도 약칭 또는 전국. 비어 있으면 알 수 없음
status: 마감일·접수 시작일로 계산
published_at
first_seen_at: BizBell 이 처음 수집한 시각
apply_start_at
deadline_at: 마감 시각(UTC). 시각을 모르는 원천은 null
deadline_date: 마감일(KST, YYYY-MM-DD)
deadline_text: 예산 소진 시까지 등 원문
always_open
budget_krw
summary: 원천 요약 원문
tags
source_url: 원문 공고 URL. fields 와 관계없이 항상 온다
apply_url
bizbell_url: BizBell 상세 페이지
attachments
extra: 분야별 추가 정보(bid_no, bid_order, bid_type …)
attribution: 출처. fields 와 관계없이 항상 온다
is_active
updated_at

페이지·증분 동기화

목록은 {data, next_cursor, total?, meta}, 한 건은 {data, meta} 입니다. 다음 페이지는 next_cursor 를 cursor 로 넘깁니다(next_cursor 가 null 이면 끝). 공고 검색의 total 은 첫 페이지에만 오는 추정 건수입니다.

전체를 받아 둔 뒤에는 updated_since 에 직전 동기화의 meta.as_of 를 넣어 바뀐 공고만 받으세요. 한 번의 동기화는 모든 페이지가 같은 as_of 를 돌려주니 마지막 페이지까지 받은 뒤 그 값을 저장하면 됩니다. 이때 status 기본값은 all, sort 기본값은 updated_desc 라 마감된 공고와 취소·철회된 공고(is_active: false)도 함께 옵니다.

키워드 알림 피드(GET /alerts/matches)도 같습니다. 다음 폴링의 since 에 meta.as_of 를 넣고, 같은 공고가 다시 올 수 있으니 id 로 중복을 거르세요.

에러

형식은 {"error":{"code","message","hint","docs_url"}} 입니다. 429 에는 Retry-After 헤더가 붙습니다.

unauthorized: 401; API 키가 없거나 올바르지 않거나 폐기됨. hint 의 login 명령으로 다시 받으세요.
insufficient_scope: 403; 키에 필요한 권한(스코프)이 없음. required_scope 를 확인하세요.
not_found: 404; 공고·즐겨찾기·알림이 없음(남의 항목도 같은 404).
invalid_parameter: 422; 파라미터·본문 값이 잘못됨. message 에 고칠 점이 있습니다.
rate_limited: 429; 분당 한도 초과. Retry-After(초) 뒤에 다시 요청하세요.
quota_exceeded: 429; 이번 달 호출 한도 소진. reset_at(다음 달 1일 00:00 KST)에 초기화됩니다.
limit_exceeded: 429; 키·알림·즐겨찾기 개수 한도. 쓰지 않는 항목을 지우세요.
internal: 500; 서버 오류. 잠시 뒤 다시 시도하세요.
unavailable: 503; 일시적으로 키를 처리할 수 없음. 잠시 뒤 다시 시도하세요.

한도

Free(구글 로그인): 월 3,000회 · 분당 30회 · 키 3개 · 알림 5개 · 즐겨찾기 500개. 한도는 키가 아니라 계정 단위입니다. 더 필요하면 문의해 주세요.

응답 헤더 X-RateLimit-Limit/Remaining/Reset, X-Quota-Limit/Remaining/Reset, X-Request-Id 로 남은 양을 알 수 있고, GET /me 는 쿼터에 세지 않습니다. 월 쿼터는 매월 1일 00:00(KST)에 초기화됩니다.

출처 표기 의무

공고 목록·상세·알림 매칭 응답의 각 공고와 즐겨찾기의 notice, 입찰 이력 응답에는 attribution(출처 문구·라이선스)과 source_url(원문 링크)이 붙습니다. fields 로 필드를 골라도 이 두 필드는 항상 옵니다. 공고를 사용자에게 보여 줄 때는 각 공고 가까이에 attribution.text 를 표시하고 원문 링크를 함께 제공해야 합니다. 기업마당(공공누리 제3유형) 공고의 제목·요약은 바꾸거나 번역하지 말고 그대로 인용하세요.

공고 문장에 담당자의 휴대전화 번호나 이메일 주소가 있으면 가려서 제공합니다(예: 010-****-****, h***@agency.go.kr). 기관 대표·사무실 전화번호는 그대로 둡니다. 가리기 전 원문은 source_url 에서 확인할 수 있습니다.

자격·마감·제출 서류는 바뀔 수 있으니 source_url 원문으로 확인하도록 안내하세요. BizBell 데이터의 대량 재배포·재판매는 금지됩니다. 자세한 조건은 이용약관 API 절을 보세요.

MCP

원격 MCP 서버(Streamable HTTP)를 Bearer 키로 붙입니다.

{
  "mcpServers": {
    "bizbell": {
      "type": "http",
      "url": "https://bizbell.site/api/mcp",
      "headers": { "Authorization": "Bearer ${BIZBELL_API_KEY}" }
    }
  }
}

로컬(stdio)로 쓰려면 npx -y bizbell@latest mcp 를 실행합니다. 도구는 search_notices, get_notice, list_favorites, add_favorite, remove_favorite, list_alerts, create_alert, get_alert_matches 이고, 도구 호출 1회가 API 호출 1회로 셉니다.

공지

하위 호환을 깨뜨리는 변경·호출 한도 축소(30일 전), 엔드포인트·API 종료(90일 전), 정기 점검(3일 전), 이용조건 개정은 여기에 게시하고, 같은 내용을 모든 응답의 meta.announcements 와 설정 → API 키 화면에 함께 싣습니다(이용약관 제13조의2·제25조).

현재 공지가 없습니다.

BizBell 공고 API

시작하기

에이전트(Claude Code·Codex·Cursor 등)에 붙이려면 세 줄이면 됩니다.

npx skills add https://bizbell.site                 # Agent Skill 설치
npx -y bizbell@latest login       # 구글 로그인 → API 키 저장
npx -y bizbell@latest search "AI 바우처" -c support --json

REST 로 직접 부를 때는 키를 헤더에 넣습니다.

curl -H "Authorization: Bearer $BIZBELL_API_KEY" \
  "https://bizbell.site/api/v1/notices?q=AI&category=support,startup&deadline_within=14&limit=5"

인증과 키

키는 설정 → API 키 또는 npx -y bizbell@latest login(브라우저에서 코드 승인)으로 받습니다. 형식은 bb_live_… 이고, 만들 때 한 번만 보입니다.

Authorization: Bearer <키> 또는 X-API-Key: <키> 헤더로 보냅니다. URL 쿼리로는 받지 않습니다. CLI·MCP 는 BIZBELL_API_KEY 환경 변수도 읽습니다.

notices:read — 공고 검색·상세·분야·출처
favorites:write — 즐겨찾기 목록·추가·삭제
alerts:write — 키워드 알림·매칭·메일 설정

에이전트에는 필요한 권한만 고른 키를 주세요. API 키로는 새 키를 만들 수 없습니다.

엔드포인트

기준 URL은 https://bizbell.site/api/v1 입니다. 반복 값은 쉼표로 잇습니다(category=bid,startup).

get/notices

공고 검색·목록

기본은 모집중(status=open, 상시 포함), 최신 게시순. 반복 값은 쉼표로 잇거나 같은 이름을 반복한다. total 은 첫 페이지에만 오는 추정 건수다.

권한: notices:read

q: 검색어(제목). 동의어를 자동으로 넓힌다
category: 분야, 쉼표 구분(startup,bid,support,rnd). 생략하면 전체
source: 원천 소스 id, 쉼표 구분(kstartup,nara,bizinfo,iris,msit …). GET /sources 참고
status: open(기본, 상시 포함) | upcoming | closed | all. updated_since 를 주면 기본이 all
region: 지역, 쉼표 구분(서울,경기 …). 전국 공고는 항상 포함하고 rnd 에는 적용하지 않는다
organization: 소관·수행 기관 부분 일치
deadline_within: 오늘부터 N일 안에 마감(KST)
deadline_after: N일 뒤 이후에 마감
always_open: 상시 모집 여부
budget_min: 최소 금액(원). bid·rnd 만 값이 있다
budget_max: 최대 금액(원)
published_since: ISO 8601. 이 시각 이후 게시
updated_since: ISO 8601. 이 시각 이후 바뀐 공고(증분 동기화). 마감·비활성(취소) 공고도 오며(기본 status=all, sort=updated_desc) 한 번의 동기화는 모든 페이지가 같은 meta.as_of 를 돌려준다. 끝까지 받은 뒤 그 as_of 를 다음 updated_since 로 쓴다
sort: 정렬. updated_since 를 주면 기본이 updated_desc
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor
fields: 응답 필드 선택, 쉼표 구분(예: id,title,deadline_at). attribution·source_url 은 지정과 관계없이 항상 포함

get/notices/{id}

공고 상세

권한: notices:read

id: 공고 id(예: nara:R26BK01752060)
fields: 응답 필드 선택(attribution·source_url 은 항상 포함)

get/notices/{id}/history

나라장터 정정 차수 이력·낙찰

권한: notices:read

id: nara:{공고번호}

get/categories

분야별 모집중 건수·마지막 수집 시각

권한: notices:read

get/sources

소스 레지스트리

권한: notices:read

get/meta/regions

지역 이름 목록

권한: notices:read

get/me

내 플랜·사용량·키

모든 키로 부를 수 있고 쿼터에 세지 않는다.

권한: 모든 키

get/favorites

즐겨찾기 목록

권한: favorites:write

status: active(기본) | expired | all
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor

post/favorites

즐겨찾기 추가(이미 있으면 기존 항목, 200)

권한: favorites:write

patch/favorites/{id}

메모 수정

권한: favorites:write

id: 즐겨찾기 id

delete/favorites/{id}

즐겨찾기 삭제

권한: favorites:write

id: 즐겨찾기 id

get/alerts

키워드 알림 목록

권한: alerts:write

post/alerts

키워드 알림 만들기

권한: alerts:write

patch/alerts/{id}

알림 수정(category 제외)

권한: alerts:write

id: 알림 id

delete/alerts/{id}

알림 삭제

권한: alerts:write

id: 알림 id

post/alerts/{id}/test

최근 N일 매칭 미리보기(메일 발송 없음, 최대 50건)

권한: alerts:write

id: 알림 id
days: 1~30, 기본 7

get/alerts/matches

모든 활성 알림의 신규 매칭(폴링)

권한: alerts:write

since: ISO 8601 날짜나 시각
limit: 한 번에 받을 개수(1~50, 기본 20)
cursor: 이전 응답의 next_cursor

get/alerts/settings

일일 메일 설정

권한: alerts:write

patch/alerts/settings

일일 메일 설정 수정

권한: alerts:write

공고 필드

id: {source}:{원천 id}
category: startup | bid | support | rnd
source
title: 원문 제목(변경하지 않음)
organization: 소관·공고 기관
executing_org: 수행·수요 기관
regions: 시도 약칭 또는 전국. 비어 있으면 알 수 없음
status: 마감일·접수 시작일로 계산
published_at
first_seen_at: BizBell 이 처음 수집한 시각
apply_start_at
deadline_at: 마감 시각(UTC). 시각을 모르는 원천은 null
deadline_date: 마감일(KST, YYYY-MM-DD)
deadline_text: 예산 소진 시까지 등 원문
always_open
budget_krw
summary: 원천 요약 원문
tags
source_url: 원문 공고 URL. fields 와 관계없이 항상 온다
apply_url
bizbell_url: BizBell 상세 페이지
attachments
extra: 분야별 추가 정보(bid_no, bid_order, bid_type …)
attribution: 출처. fields 와 관계없이 항상 온다
is_active
updated_at

페이지·증분 동기화

키워드 알림 피드(GET /alerts/matches)도 같습니다. 다음 폴링의 since 에 meta.as_of 를 넣고, 같은 공고가 다시 올 수 있으니 id 로 중복을 거르세요.

에러

형식은 {"error":{"code","message","hint","docs_url"}} 입니다. 429 에는 Retry-After 헤더가 붙습니다.

unauthorized: 401; API 키가 없거나 올바르지 않거나 폐기됨. hint 의 login 명령으로 다시 받으세요.
insufficient_scope: 403; 키에 필요한 권한(스코프)이 없음. required_scope 를 확인하세요.
not_found: 404; 공고·즐겨찾기·알림이 없음(남의 항목도 같은 404).
invalid_parameter: 422; 파라미터·본문 값이 잘못됨. message 에 고칠 점이 있습니다.
rate_limited: 429; 분당 한도 초과. Retry-After(초) 뒤에 다시 요청하세요.
quota_exceeded: 429; 이번 달 호출 한도 소진. reset_at(다음 달 1일 00:00 KST)에 초기화됩니다.
limit_exceeded: 429; 키·알림·즐겨찾기 개수 한도. 쓰지 않는 항목을 지우세요.
internal: 500; 서버 오류. 잠시 뒤 다시 시도하세요.
unavailable: 503; 일시적으로 키를 처리할 수 없음. 잠시 뒤 다시 시도하세요.

한도

Free(구글 로그인): 월 3,000회 · 분당 30회 · 키 3개 · 알림 5개 · 즐겨찾기 500개. 한도는 키가 아니라 계정 단위입니다. 더 필요하면 문의해 주세요.

출처 표기 의무

MCP

원격 MCP 서버(Streamable HTTP)를 Bearer 키로 붙입니다.

{
  "mcpServers": {
    "bizbell": {
      "type": "http",
      "url": "https://bizbell.site/api/mcp",
      "headers": { "Authorization": "Bearer ${BIZBELL_API_KEY}" }
    }
  }
}

공지

현재 공지가 없습니다.