kstartup-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

창업진흥원 K-Startup 조회

创业振兴院K-Startup查询

What this skill does

What this skill does

공공데이터포털의 창업진흥원_K-Startup(사업소개,사업공고,콘텐츠 등)_조회서비스 (
kisedKstartupService01
, dataset
15125364
)를
k-skill-proxy
경유로 호출해 다음 4개 endpoint를 조회한다.
  • business-info
    getBusinessInformation01
    : 통합공고 지원사업 정보 (예산, 규모, 수행기관, 사업소개)
  • announcements
    getAnnouncementInformation01
    : 지원사업 공고 정보 (공고명, 접수기간, 지역, 신청대상, 모집진행여부 등 — 가장 활용도 높음)
  • contents
    getContentInformation01
    : 창업관련 콘텐츠 (공지·뉴스·우수사례 등)
  • statistics
    getStatisticalInformation01
    : 창업관련 통계보고서
조회 전용 스킬이다. 사업 신청·지원금 청구·콘텐츠 게시 같은 쓰기 동작은 다루지 않는다.
公共数据门户网站的创业振兴院_K-Startup(事业介绍、事业公告、内容等)_查询服务 (
kisedKstartupService01
, dataset
15125364
),将通过
k-skill-proxy
调用以下4个端点进行查询:
  • business-info
    getBusinessInformation01
    : 整合公告支援事业信息(预算、规模、执行机构、事业介绍)
  • announcements
    getAnnouncementInformation01
    : 支援事业公告信息(公告名称、申请期限、地区、申请对象、招募进行状态等 — 使用率最高
  • contents
    getContentInformation01
    : 创业相关内容(公告·新闻·优秀案例等)
  • statistics
    getStatisticalInformation01
    : 创业相关统计报告
本技能仅用于查询。不处理事业申请、补助金申领、内容发布等写入操作。

When to use

When to use

  • "이번 달 마감 예정인 청년 창업지원 공고 찾아줘"
  • "서울 소재 모집 진행 중인 1인 창조기업 지원사업 알려줘"
  • "K-Startup에서 사업화 단계 통합공고 사업 목록 뽑아줘"
  • "창업진흥원 최신 통계보고서 5건 보여줘"
  • "帮我找本月即将截止的青年创业支援公告"
  • "告诉我首尔正在招募的个人创意企业支援事业"
  • "帮我提取K-Startup中事业化阶段整合公告的事业列表"
  • "给我看创业振兴院最新的5份统计报告"

When not to use

When not to use

  • 사업 신청·결제·자동 지원·계좌 연계 같은 쓰기 동작 (지원 화면은 사용자가 K-Startup 웹에서 직접 진행한다)
  • K-Startup 외부 사이트(중기부, 창조경제혁신센터, 지자체 단독 공고) 조회 — 통합공고에 등록된 일부만 K-Startup API로 노출된다
  • 마감일·모집 상태를 분 단위로 추적해야 하는 작업 — 데이터 갱신은 공식 서비스설계서 기준 일 1회다 (공공데이터포털 dataset 메타데이터에는 "실시간"으로 표기되지만 두 표면이 일치하지 않는다)
  • 事业申请、结算、自动支援、账户关联等写入操作(支援流程需用户直接在K-Startup网页进行)
  • 查询K-Startup外部网站(中小企业部、创意经济革新中心、地方政府单独公告)——仅整合公告中注册的部分内容会通过K-Startup API开放
  • 需要以分钟为单位跟踪截止日期、招募状态的工作——根据官方服务设计标准,数据更新为每日1次(公共数据门户网站数据集元数据标注为“实时”,但两者不一致)

Prerequisites

Prerequisites

  • 인터넷 연결
  • python3
    (stdlib only)
  • 설치된 스킬 안의
    scripts/run_kstartup.py
  • hosted/self-host
    k-skill-proxy
    /v1/kstartup/*
    라우트 접근 가능 (4개)
  • 网络连接
  • python3
    (仅使用标准库)
  • 已安装技能包内的
    scripts/run_kstartup.py
  • 可访问托管/自托管
    k-skill-proxy
    /v1/kstartup/*
    路由(共4个)

Credential requirements

Credential requirements

  • 사용자 측 필수 시크릿 없음.
  • KSKILL_PROXY_BASE_URL
    — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted
    https://k-skill-proxy.nomadamas.org
    .
  • KSKILL_KSTARTUP_API_KEY
    --direct
    로 K-Startup을 직접 호출할 때만 필요. 공공데이터포털에서
    창업진흥원_K-Startup(사업소개,사업공고, 콘텐츠 등)_조회서비스
    (
    15125364
    ) 활용신청이 본인 계정으로 승인돼 있어야 한다(자동승인, 무료).
  • 프록시 운영자는
    DATA_GO_KR_API_KEY
    환경변수에 같은 조건의 키를 두고 활용신청을 추가해 둔다.
  • 用户无需提供必要密钥。
  • KSKILL_PROXY_BASE_URL
    — 仅在使用自托管/独立代理时设置。留空则使用默认托管地址
    https://k-skill-proxy.nomadamas.org
  • KSKILL_KSTARTUP_API_KEY
    — 仅在使用
    --direct
    直接调用K-Startup时需要。需在公共数据门户网站以个人账号完成创业振兴院_K-Startup(事业介绍、事业公告、内容等)_查询服务 (
    15125364
    )的使用申请(自动审批,免费)。
  • 代理运营者需在
    DATA_GO_KR_API_KEY
    环境变量中配置符合上述条件的密钥,并完成使用申请。

Credential resolution order (
--direct
전용)

Credential resolution order (
--direct
专用)

  1. 이미 환경변수에 있으면 그대로 사용한다.
  2. 에이전트 vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)에서 꺼내 환경변수로 주입.
  3. ~/.config/k-skill/secrets.env
    (plain dotenv, 권한
    0600
    ).
  4. 아무것도 없으면 사용자에게 묻고 2 또는 3에 저장.
일반 조회 helper는 proxy URL만 읽고, K-Startup 인증키는 프록시 서버에서만 주입한다.
--direct
호출에서만
KSKILL_KSTARTUP_API_KEY
를 읽는다.
  1. 若环境变量中已存在,则直接使用。
  2. 从Agent密钥库(1Password CLI、Bitwarden CLI、macOS Keychain等)读取并注入环境变量。
  3. 读取
    ~/.config/k-skill/secrets.env
    (纯dotenv格式,权限需设为
    0600
    )。
  4. 若以上均无,则询问用户并保存至上述第2或第3项。
普通查询工具仅读取代理URL,K-Startup认证密钥仅由代理服务器注入。仅在
--direct
调用时会读取
KSKILL_KSTARTUP_API_KEY

Inputs

Inputs

서브커맨드:
business-info
,
announcements
,
contents
,
statistics
.
공통 옵션:
  • --page N
    (기본 1, ≥ 1)
  • --per-page N
    (기본 10, 1–100)
  • --text
    사람용 요약 /
    --json
    구조화 결과(기본)
  • --dry-run
    인증키 없이 요청 URL/파라미터만 출력
  • --timeout N
    HTTP 타임아웃 초 (기본 30)
  • --proxy-base-url URL
    기본 hosted proxy 대신 self-host/alternate proxy
  • --direct
    proxy 우회,
    KSKILL_KSTARTUP_API_KEY
    로 직접 호출
서브커맨드별 필터:
  • business-info
    • --biz-yr 2024
      (사업 연도, 4자리)
    • --biz-category-cd cmrczn_Tab3
      (사업 구분 코드)
    • --supt-biz-titl-nm "1인 창조기업"
      (사업 명)
  • announcements
    • --biz-pbanc-nm "키워드"
      (지원 사업 공고 명)
    • --supt-regin 서울특별시
      (지역명. K-Startup upstream이 이 필터를 서버 측에서 적용하지 않는 사례가 있다 — 응답을 받은 뒤 client에서
      supt_regin
      으로 한 번 더 거른다)
    • --supt-biz-clsfc 사업화
      (지원 분야)
    • --pbanc-rcpt-bgng-dt 20240101
      /
      --pbanc-rcpt-end-dt 20241231
      (공고 접수 시작/종료, YYYYMMDD)
    • --aply-trgt 일반인,예비창업자
      (신청 대상)
    • --biz-enyy 예비창업자,1년미만
      (창업 기간)
    • --biz-trgt-age "만 20세 이상 ~ 만 39세 이하"
      (대상 연령)
    • --rcrt-prgs-yn Y|N
      (모집진행여부)
    • --intg-pbanc-yn Y|N
      (통합 공고 여부)
  • contents
    • --clss-cd notice_matr
      (콘텐츠 구분 코드: notice_matr 등)
    • --titl-nm "공모전"
      (제목 키워드)
  • statistics
    • --titl-nm "창업기업 실태조사"
      (통계 자료 명)
    • --file-nm "PDF"
      (파일 명/내용 키워드)
子命令:
business-info
,
announcements
,
contents
,
statistics
.
通用选项:
  • --page N
    (默认1,≥1)
  • --per-page N
    (默认10,范围1–100)
  • --text
    面向用户的摘要输出 /
    --json
    结构化结果(默认)
  • --dry-run
    无认证密钥,仅输出请求URL/参数
  • --timeout N
    HTTP超时秒数(默认30)
  • --proxy-base-url URL
    替代默认托管代理,使用自托管/其他代理
  • --direct
    绕过代理,使用
    KSKILL_KSTARTUP_API_KEY
    直接调用
子命令专属筛选条件:
  • business-info
    • --biz-yr 2024
      (事业年份,4位数字)
    • --biz-category-cd cmrczn_Tab3
      (事业分类代码)
    • --supt-biz-titl-nm "个人创意企业"
      (事业名称)
  • announcements
    • --biz-pbanc-nm "关键词"
      (支援事业公告名称)
    • --supt-regin 首尔特别市
      (地区名称。存在K-Startup上游未在服务器端应用该筛选条件的情况 — 需在客户端收到响应后,再次通过
      supt_regin
      字段过滤)
    • --supt-biz-clsfc 事业化
      (支援领域)
    • --pbanc-rcpt-bgng-dt 20240101
      /
      --pbanc-rcpt-end-dt 20241231
      (公告申请开始/结束日期,格式YYYYMMDD)
    • --aply-trgt 普通民众,预备创业者
      (申请对象)
    • --biz-enyy 预备创业者,创业未满1年
      (创业时长)
    • --biz-trgt-age "年满20岁 ~ 年满39岁"
      (目标年龄)
    • --rcrt-prgs-yn Y|N
      (招募进行状态)
    • --intg-pbanc-yn Y|N
      (整合公告状态)
  • contents
    • --clss-cd notice_matr
      (内容分类代码:如notice_matr)
    • --titl-nm "竞赛"
      (标题关键词)
  • statistics
    • --titl-nm "创业企业实态调查"
      (统计资料名称)
    • --file-nm "PDF"
      (文件名称/内容关键词)

Workflow

Workflow

1. Ensure proxy access is available

1. Ensure proxy access is available

일반 조회는 기본 hosted
k-skill-proxy
를 사용하므로 사용자 K-Startup 키가 필요 없다. self-host를 쓰면
KSKILL_PROXY_BASE_URL
을 설정한다.
--direct
가 필요할 때만
KSKILL_KSTARTUP_API_KEY
를 credential resolution order에 따라 확보한다.
普通查询默认使用托管
k-skill-proxy
,无需用户提供K-Startup密钥。若使用自托管代理,需设置
KSKILL_PROXY_BASE_URL
。仅在需要
--direct
调用时,才按凭证解析顺序获取
KSKILL_KSTARTUP_API_KEY

2. Pick the right operation

2. Pick the right operation

  • 마감 임박/지역 필터/대상별 공고 추천 →
    announcements
  • 사업의 전반적 소개·예산 규모 →
    business-info
  • 정책 공지·우수사례 →
    contents
  • 보고서/통계 데이터 →
    statistics
  • 临近截止/地区筛选/按对象推荐公告 →
    announcements
  • 事业整体介绍·预算规模 →
    business-info
  • 政策公告·优秀案例 →
    contents
  • 报告/统计数据 →
    statistics

3. Fetch a small bounded slice first

3. Fetch a small bounded slice first

--per-page 10
정도로 먼저 한 페이지를 받아 응답 스키마를 확인한 뒤, 필터를 좁히거나 페이지를 넘긴다.
bash
python3 scripts/run_kstartup.py announcements \
  --supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text
先以
--per-page 10
左右的参数获取第一页数据,确认响应结构后,再缩小筛选范围或翻页。
bash
python3 scripts/run_kstartup.py announcements \
  --supt-regin 首尔特别市 --rcrt-prgs-yn Y --per-page 5 --text

4. Filter on the client side for richer questions

4. Filter on the client side for richer questions

API는 단순 필드 매칭만 지원하고, 그중
supt_regin
같은 일부 필터는 upstream이 서버 측에서 적용하지 않는 사례가 관측된다.
--supt-regin 서울특별시
로 호출해도 타 지역 공고가 섞여 돌아오는 경우가 있어서,
supt_regin
·
aply_trgt
·
biz_enyy
필드는 helper가 받은 응답을 client에서 한 번 더 거른다.
  • 응답
    supt_regin
    은 upstream이 축약형(
    서울
    ,
    경기
    ,
    충북
    )으로 돌려준다. helper는 사용자가
    --supt-regin 서울특별시
    같은 표준 광역지자체명을 줘도 17개 광역시·도(+
    전국
    ) 매핑 테이블로 자동 정규화해 매치한다.
  • client filter가 적용되면 응답 JSON에
    client_filter: {fields, upstream_returned, after_filter}
    블록이 함께 붙는다.
    upstream_returned
    는 같지만
    after_filter
    가 작으면 첫 페이지로는 부족하니
    --page
    를 늘려 추가 페이지를 받는다.
  • 쉼표로 여러 값을 주면 AND 매치다 (
    --aply-trgt 예비창업자,1년미만
    → 두 토큰 모두 row에 있어야 통과).
  • pbanc_rcpt_end_dt
    YYYYMMDD
    문자열이라 KST 기준으로 직접 비교한다. "이번 주 마감", "30대 대상", "특정 키워드 포함" 같은 복합 조건은 helper가 안 거르므로 응답 JSON에서 agent가 직접 처리한다.
API仅支持简单字段匹配,且已观测到部分字段(如
supt_regin
)上游未在服务器端应用筛选的情况
。即使通过
--supt-regin 首尔特别市
调用,仍可能返回其他地区的公告,因此工具会在客户端对
supt_regin
·
aply_trgt
·
biz_enyy
字段进行二次过滤。
  • 上游返回的
    supt_regin
    为缩写形式(如
    首尔
    京畿
    忠北
    )。工具会自动将用户输入的标准广域地方政府名称(如
    首尔特别市
    )通过17个广域市·道(+
    全国
    )映射表进行规范化匹配。
  • 客户端过滤后,响应JSON会附加
    client_filter: {fields, upstream_returned, after_filter}
    块。若
    upstream_returned
    数量与
    after_filter
    数量差距较大,说明第一页数据不足,需增加
    --page
    参数获取更多页面。
  • 用逗号分隔多个值时为AND匹配(如
    --aply-trgt 预备创业者,创业未满1年
    → 数据行需同时包含两个条件)。
  • pbanc_rcpt_end_dt
    YYYYMMDD
    字符串,需按KST时区直接比较。“本周截止”、“30岁以上对象”、“包含特定关键词”等复合条件,工具不会处理,需由Agent直接从响应JSON中处理。

5. Cite the source

5. Cite the source

응답을 요약할 때는 endpoint 이름, 호출 page/perPage, 응답의
pbanc_sn
또는
detl_pg_url
을 함께 적는다. 상세는 https://www.k-startup.go.kr 의 해당 URL로 안내한다.
总结响应时,需同时注明端点名称、调用的page/perPage参数、响应中的
pbanc_sn
detl_pg_url
。详情引导至https://www.k-startup.go.kr的对应URL。

CLI examples

CLI examples

bash
undefined
bash
undefined

서울 모집 중 공고 5건

首尔正在招募的5条公告

python3 scripts/run_kstartup.py announcements
--supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text
python3 scripts/run_kstartup.py announcements
--supt-regin 首尔特别市 --rcrt-prgs-yn Y --per-page 5 --text

2024년 사업화 분야 통합공고

2024年事业化领域整合公告

python3 scripts/run_kstartup.py business-info
--biz-yr 2024 --biz-category-cd cmrczn_Tab3 --json
python3 scripts/run_kstartup.py business-info
--biz-yr 2024 --biz-category-cd cmrczn_Tab3 --json

정책·공지 최신 콘텐츠

政策·公告最新内容

python3 scripts/run_kstartup.py contents
--clss-cd notice_matr --per-page 10 --text
python3 scripts/run_kstartup.py contents
--clss-cd notice_matr --per-page 10 --text

창업기업 실태조사 통계보고서

创业企业实态调查统计报告

python3 scripts/run_kstartup.py statistics
--titl-nm "창업기업 실태조사" --per-page 5 --json
python3 scripts/run_kstartup.py statistics
--titl-nm "创业企业实态调查" --per-page 5 --json

인증키 없이 dry-run 으로 요청 점검

无认证密钥,通过dry-run检查请求

python3 scripts/run_kstartup.py announcements
--supt-regin 부산광역시 --dry-run
undefined
python3 scripts/run_kstartup.py announcements
--supt-regin 釜山广域市 --dry-run
undefined

Direct proxy examples

Direct proxy examples

bash
curl -fsS "$KSKILL_PROXY_BASE_URL/v1/kstartup/announcements?supt_regin=$(python3 -c 'import urllib.parse;print(urllib.parse.quote(\"서울특별시\"))')&rcrt_prgs_yn=Y&perPage=5"
bash
curl -fsS "$KSKILL_PROXY_BASE_URL/v1/kstartup/announcements?supt_regin=$(python3 -c 'import urllib.parse;print(urllib.parse.quote(\"首尔特别市\"))')&rcrt_prgs_yn=Y&perPage=5"

Failure modes

Failure modes

  • 400 bad_request
    : 잘못된 날짜(
    YYYYMMDD
    아님), 잘못된
    Y/N
    , perPage 범위 초과, 시작일 > 종료일 → 메시지대로 입력 보정.
  • 503 upstream_not_configured
    : 프록시 서버에
    DATA_GO_KR_API_KEY
    가 없거나 해당 데이터셋 활용신청이 미승인.
  • 502 upstream_error
    : data.go.kr 응답이
    resultCode != "00"
    또는
    errMsg
    /
    SERVICE_KEY_IS_NOT_REGISTERED_ERROR
    등 인증/한도 오류.
    • data.go.kr 에러 코드: 10(잘못된 파라미터), 20(접근거부), 22(요청제한 초과), 30(미등록 키), 31(만료), 32(미등록 IP).
  • 502 upstream_invalid_response
    : data.go.kr이 JSON 대신 HTML/XML 본문을 보낸 경우(점검·차단 등).
    upstream_body
    앞 500자가 함께 반환된다.
  • data
    배열: 필터에 일치하는 공고/콘텐츠 없음. 키워드/지역/대상 범위를 완화한다.
  • 일 갱신 1회(서비스설계서 기준): 같은 날 같은 공고의 마감일·상태가 갱신되지 않을 수 있으므로, 마감/접수 상태는 응답의
    detl_pg_url
    페이지에서 최종 확인한다.
  • 400 bad_request
    : 日期格式错误(非
    YYYYMMDD
    )、
    Y/N
    值错误、perPage超出范围、开始日期>结束日期 → 根据提示修正输入。
  • 503 upstream_not_configured
    : 代理服务器未配置
    DATA_GO_KR_API_KEY
    ,或该数据集使用申请未获批。
  • 502 upstream_error
    : data.go.kr返回
    resultCode != "00"
    ,或出现
    errMsg
    /
    SERVICE_KEY_IS_NOT_REGISTERED_ERROR
    等认证/限额错误。
    • data.go.kr错误代码:10(参数错误)、20(访问拒绝)、22(请求超限)、30(未注册密钥)、31(密钥过期)、32(未注册IP)。
  • 502 upstream_invalid_response
    : data.go.kr返回HTML/XML而非JSON内容(如系统维护、访问拦截等)。会同时返回
    upstream_body
    的前500个字符。
  • data
    数组:没有匹配筛选条件的公告/内容。放宽关键词、地区或对象范围。
  • 每日更新1次(服务设计标准):同一天内同一公告的截止日期、状态可能不会更新,因此截止/申请状态需在响应的
    detl_pg_url
    页面中最终确认。

Done when

Done when

  • 사용자가 찾는 endpoint (
    business-info
    /
    announcements
    /
    contents
    /
    statistics
    )를 골랐다.
  • 작은 슬라이스로 첫 페이지를 받아 응답 스키마/필드를 확인했다.
  • 필터를 좁히거나 클라이언트에서 후처리해 답변에 필요한 핵심 행만 남겼다.
  • 결과에 출처(endpoint, page/perPage,
    detl_pg_url
    또는
    pbanc_sn
    )를 명시했다.
  • 用户已选定要查询的端点(
    business-info
    /
    announcements
    /
    contents
    /
    statistics
    )。
  • 已获取小范围的第一页数据,确认了响应结构/字段。
  • 已缩小筛选范围或在客户端进行后处理,仅保留回答所需的核心数据行。
  • 结果中已注明来源(端点、page/perPage、
    detl_pg_url
    pbanc_sn
    )。

Maintainer review notes

Maintainer review notes

K-Startup 인증키 없이도 다음 검증이 가능하다.
  • ./scripts/validate-skills.sh
  • python3 -m py_compile kstartup-search/scripts/run_kstartup.py kstartup-search/tests/test_run_kstartup.py
  • python3 kstartup-search/scripts/run_kstartup.py --help
  • python3 kstartup-search/scripts/run_kstartup.py announcements --supt-regin 서울특별시 --dry-run
  • PYTHONPATH=kstartup-search/scripts python3 -m unittest discover -s kstartup-search/tests -p 'test_*.py' -v
  • node --test packages/k-skill-proxy/test/server.test.js
    (K-Startup 라우트 5개 신규 케이스 포함)
  • npm run ci
라이브 스모크는 hosted proxy 환경에
DATA_GO_KR_API_KEY
가 설정되고
15125364
활용신청이 승인된 뒤에 수행한다.
无需K-Startup认证密钥即可进行以下验证:
  • ./scripts/validate-skills.sh
  • python3 -m py_compile kstartup-search/scripts/run_kstartup.py kstartup-search/tests/test_run_kstartup.py
  • python3 kstartup-search/scripts/run_kstartup.py --help
  • python3 kstartup-search/scripts/run_kstartup.py announcements --supt-regin 首尔特别市 --dry-run
  • PYTHONPATH=kstartup-search/scripts python3 -m unittest discover -s kstartup-search/tests -p 'test_*.py' -v
  • node --test packages/k-skill-proxy/test/server.test.js
    (包含K-Startup路由5个新增用例)
  • npm run ci
线上冒烟测试需在托管代理环境中配置好
DATA_GO_KR_API_KEY
15125364
数据集使用申请获批后进行。

Safety notes

Safety notes

  • 조회 전용 스킬. 사업 신청·계좌 연결·결제 자동화는 하지 않는다.
  • 응답에 K-Startup 사이트 URL이 있으면 그대로 안내하고, 실제 신청은 사용자가 브라우저에서 직접 진행한다.
  • 인증키는 프록시 서버에서만 다루며,
    --dry-run
    시에도 helper는
    <DRY-RUN>
    로 대체한다.
  • 本技能仅用于查询。不进行事业申请、账户关联、结算自动化等操作。
  • 若响应中包含K-Startup网站URL,直接引导用户访问,实际申请需用户在浏览器中自行操作。
  • 认证密钥仅由代理服务器处理,即使在
    --dry-run
    模式下,工具也会用
    <DRY-RUN>
    替代密钥内容。