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(사업소개,사업공고,콘텐츠 등)_조회서비스 (, dataset )를 경유로 호출해 다음 4개 endpoint를 조회한다.
kisedKstartupService0115125364k-skill-proxy- →
business-info: 통합공고 지원사업 정보 (예산, 규모, 수행기관, 사업소개)getBusinessInformation01 - →
announcements: 지원사업 공고 정보 (공고명, 접수기간, 지역, 신청대상, 모집진행여부 등 — 가장 활용도 높음)getAnnouncementInformation01 - →
contents: 창업관련 콘텐츠 (공지·뉴스·우수사례 등)getContentInformation01 - →
statistics: 창업관련 통계보고서getStatisticalInformation01
조회 전용 스킬이다. 사업 신청·지원금 청구·콘텐츠 게시 같은 쓰기 동작은 다루지 않는다.
公共数据门户网站的创业振兴院_K-Startup(事业介绍、事业公告、内容等)_查询服务 (, dataset ),将通过调用以下4个端点进行查询:
kisedKstartupService0115125364k-skill-proxy- →
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
- 인터넷 연결
- (stdlib only)
python3 - 설치된 스킬 안의
scripts/run_kstartup.py - hosted/self-host 의
k-skill-proxy라우트 접근 가능 (4개)/v1/kstartup/*
- 网络连接
- (仅使用标准库)
python3 - 已安装技能包内的
scripts/run_kstartup.py - 可访问托管/自托管的
k-skill-proxy路由(共4个)/v1/kstartup/*
Credential requirements
Credential requirements
- 사용자 측 필수 시크릿 없음.
- — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted
KSKILL_PROXY_BASE_URL.https://k-skill-proxy.nomadamas.org - —
KSKILL_KSTARTUP_API_KEY로 K-Startup을 직접 호출할 때만 필요. 공공데이터포털에서--direct(창업진흥원_K-Startup(사업소개,사업공고, 콘텐츠 등)_조회서비스) 활용신청이 본인 계정으로 승인돼 있어야 한다(자동승인, 무료).15125364 - 프록시 운영자는 환경변수에 같은 조건의 키를 두고 활용신청을 추가해 둔다.
DATA_GO_KR_API_KEY
- 用户无需提供必要密钥。
- — 仅在使用自托管/独立代理时设置。留空则使用默认托管地址
KSKILL_PROXY_BASE_URL。https://k-skill-proxy.nomadamas.org - — 仅在使用
KSKILL_KSTARTUP_API_KEY直接调用K-Startup时需要。需在公共数据门户网站以个人账号完成创业振兴院_K-Startup(事业介绍、事业公告、内容等)_查询服务 (--direct)的使用申请(自动审批,免费)。15125364 - 代理运营者需在环境变量中配置符合上述条件的密钥,并完成使用申请。
DATA_GO_KR_API_KEY
Credential resolution order (--direct
전용)
--directCredential resolution order (--direct
专用)
--direct- 이미 환경변수에 있으면 그대로 사용한다.
- 에이전트 vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)에서 꺼내 환경변수로 주입.
- (plain dotenv, 권한
~/.config/k-skill/secrets.env).0600 - 아무것도 없으면 사용자에게 묻고 2 또는 3에 저장.
일반 조회 helper는 proxy URL만 읽고, K-Startup 인증키는 프록시 서버에서만 주입한다. 호출에서만 를 읽는다.
--directKSKILL_KSTARTUP_API_KEY- 若环境变量中已存在,则直接使用。
- 从Agent密钥库(1Password CLI、Bitwarden CLI、macOS Keychain等)读取并注入环境变量。
- 读取(纯dotenv格式,权限需设为
~/.config/k-skill/secrets.env)。0600 - 若以上均无,则询问用户并保存至上述第2或第3项。
普通查询工具仅读取代理URL,K-Startup认证密钥仅由代理服务器注入。仅在调用时会读取。
--directKSKILL_KSTARTUP_API_KEYInputs
Inputs
서브커맨드: , , , .
business-infoannouncementscontentsstatistics공통 옵션:
- (기본 1, ≥ 1)
--page N - (기본 10, 1–100)
--per-page N - 사람용 요약 /
--text구조화 결과(기본)--json - 인증키 없이 요청 URL/파라미터만 출력
--dry-run - HTTP 타임아웃 초 (기본 30)
--timeout N - 기본 hosted proxy 대신 self-host/alternate proxy
--proxy-base-url URL - proxy 우회,
--direct로 직접 호출KSKILL_KSTARTUP_API_KEY
서브커맨드별 필터:
business-info- (사업 연도, 4자리)
--biz-yr 2024 - (사업 구분 코드)
--biz-category-cd cmrczn_Tab3 - (사업 명)
--supt-biz-titl-nm "1인 창조기업"
announcements- (지원 사업 공고 명)
--biz-pbanc-nm "키워드" - (지역명. K-Startup upstream이 이 필터를 서버 측에서 적용하지 않는 사례가 있다 — 응답을 받은 뒤 client에서
--supt-regin 서울특별시으로 한 번 더 거른다)supt_regin - (지원 분야)
--supt-biz-clsfc 사업화 - /
--pbanc-rcpt-bgng-dt 20240101(공고 접수 시작/종료, YYYYMMDD)--pbanc-rcpt-end-dt 20241231 - (신청 대상)
--aply-trgt 일반인,예비창업자 - (창업 기간)
--biz-enyy 예비창업자,1년미만 - (대상 연령)
--biz-trgt-age "만 20세 이상 ~ 만 39세 이하" - (모집진행여부)
--rcrt-prgs-yn Y|N - (통합 공고 여부)
--intg-pbanc-yn Y|N
contents- (콘텐츠 구분 코드: notice_matr 등)
--clss-cd notice_matr - (제목 키워드)
--titl-nm "공모전"
statistics- (통계 자료 명)
--titl-nm "창업기업 실태조사" - (파일 명/내용 키워드)
--file-nm "PDF"
子命令:, , , .
business-infoannouncementscontentsstatistics通用选项:
- (默认1,≥1)
--page N - (默认10,范围1–100)
--per-page N - 面向用户的摘要输出 /
--text结构化结果(默认)--json - 无认证密钥,仅输出请求URL/参数
--dry-run - HTTP超时秒数(默认30)
--timeout N - 替代默认托管代理,使用自托管/其他代理
--proxy-base-url URL - 绕过代理,使用
--direct直接调用KSKILL_KSTARTUP_API_KEY
子命令专属筛选条件:
business-info- (事业年份,4位数字)
--biz-yr 2024 - (事业分类代码)
--biz-category-cd cmrczn_Tab3 - (事业名称)
--supt-biz-titl-nm "个人创意企业"
announcements- (支援事业公告名称)
--biz-pbanc-nm "关键词" - (地区名称。存在K-Startup上游未在服务器端应用该筛选条件的情况 — 需在客户端收到响应后,再次通过
--supt-regin 首尔特别市字段过滤)supt_regin - (支援领域)
--supt-biz-clsfc 事业化 - /
--pbanc-rcpt-bgng-dt 20240101(公告申请开始/结束日期,格式YYYYMMDD)--pbanc-rcpt-end-dt 20241231 - (申请对象)
--aply-trgt 普通民众,预备创业者 - (创业时长)
--biz-enyy 预备创业者,创业未满1年 - (目标年龄)
--biz-trgt-age "年满20岁 ~ 年满39岁" - (招募进行状态)
--rcrt-prgs-yn Y|N - (整合公告状态)
--intg-pbanc-yn Y|N
contents- (内容分类代码:如notice_matr)
--clss-cd 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-Startup 키가 필요 없다. self-host를 쓰면 을 설정한다. 가 필요할 때만 를 credential resolution order에 따라 확보한다.
k-skill-proxyKSKILL_PROXY_BASE_URL--directKSKILL_KSTARTUP_API_KEY普通查询默认使用托管,无需用户提供K-Startup密钥。若使用自托管代理,需设置。仅在需要调用时,才按凭证解析顺序获取。
k-skill-proxyKSKILL_PROXY_BASE_URL--directKSKILL_KSTARTUP_API_KEY2. 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 10bash
python3 scripts/run_kstartup.py announcements \
--supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text先以左右的参数获取第一页数据,确认响应结构后,再缩小筛选范围或翻页。
--per-page 10bash
python3 scripts/run_kstartup.py announcements \
--supt-regin 首尔特别市 --rcrt-prgs-yn Y --per-page 5 --text4. Filter on the client side for richer questions
4. Filter on the client side for richer questions
API는 단순 필드 매칭만 지원하고, 그중 같은 일부 필터는 upstream이 서버 측에서 적용하지 않는 사례가 관측된다. 로 호출해도 타 지역 공고가 섞여 돌아오는 경우가 있어서, ·· 필드는 helper가 받은 응답을 client에서 한 번 더 거른다.
supt_regin--supt-regin 서울특별시supt_reginaply_trgtbiz_enyy- 응답 은 upstream이 축약형(
supt_regin,서울,경기)으로 돌려준다. helper는 사용자가충북같은 표준 광역지자체명을 줘도 17개 광역시·도(+--supt-regin 서울특별시) 매핑 테이블로 자동 정규화해 매치한다.전국 - client filter가 적용되면 응답 JSON에 블록이 함께 붙는다.
client_filter: {fields, upstream_returned, after_filter}는 같지만upstream_returned가 작으면 첫 페이지로는 부족하니after_filter를 늘려 추가 페이지를 받는다.--page - 쉼표로 여러 값을 주면 AND 매치다 (→ 두 토큰 모두 row에 있어야 통과).
--aply-trgt 예비창업자,1년미만 - 는
pbanc_rcpt_end_dt문자열이라 KST 기준으로 직접 비교한다. "이번 주 마감", "30대 대상", "특정 키워드 포함" 같은 복합 조건은 helper가 안 거르므로 응답 JSON에서 agent가 직접 처리한다.YYYYMMDD
API仅支持简单字段匹配,且已观测到部分字段(如)上游未在服务器端应用筛选的情况。即使通过调用,仍可能返回其他地区的公告,因此工具会在客户端对··字段进行二次过滤。
supt_regin--supt-regin 首尔特别市supt_reginaply_trgtbiz_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字符串,需按KST时区直接比较。“本周截止”、“30岁以上对象”、“包含特定关键词”等复合条件,工具不会处理,需由Agent直接从响应JSON中处理。YYYYMMDD
5. Cite the source
5. Cite the source
응답을 요약할 때는 endpoint 이름, 호출 page/perPage, 응답의 또는 을 함께 적는다. 상세는 https://www.k-startup.go.kr 의 해당 URL로 안내한다.
pbanc_sndetl_pg_urlCLI examples
CLI examples
bash
undefinedbash
undefined서울 모집 중 공고 5건
首尔正在招募的5条公告
python3 scripts/run_kstartup.py announcements
--supt-regin 서울특별시 --rcrt-prgs-yn Y --per-page 5 --text
--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
--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
--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
--biz-yr 2024 --biz-category-cd cmrczn_Tab3 --json
정책·공지 최신 콘텐츠
政策·公告最新内容
python3 scripts/run_kstartup.py contents
--clss-cd notice_matr --per-page 10 --text
--clss-cd notice_matr --per-page 10 --text
python3 scripts/run_kstartup.py contents
--clss-cd notice_matr --per-page 10 --text
--clss-cd notice_matr --per-page 10 --text
창업기업 실태조사 통계보고서
创业企业实态调查统计报告
python3 scripts/run_kstartup.py statistics
--titl-nm "창업기업 실태조사" --per-page 5 --json
--titl-nm "창업기업 실태조사" --per-page 5 --json
python3 scripts/run_kstartup.py statistics
--titl-nm "创业企业实态调查" --per-page 5 --json
--titl-nm "创业企业实态调查" --per-page 5 --json
인증키 없이 dry-run 으로 요청 점검
无认证密钥,通过dry-run检查请求
python3 scripts/run_kstartup.py announcements
--supt-regin 부산광역시 --dry-run
--supt-regin 부산광역시 --dry-run
undefinedpython3 scripts/run_kstartup.py announcements
--supt-regin 釜山广域市 --dry-run
--supt-regin 釜山广域市 --dry-run
undefinedDirect 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, perPage 범위 초과, 시작일 > 종료일 → 메시지대로 입력 보정.Y/N - : 프록시 서버에
503 upstream_not_configured가 없거나 해당 데이터셋 활용신청이 미승인.DATA_GO_KR_API_KEY - : data.go.kr 응답이
502 upstream_error또는resultCode != "00"/errMsg등 인증/한도 오류.SERVICE_KEY_IS_NOT_REGISTERED_ERROR- data.go.kr 에러 코드: 10(잘못된 파라미터), 20(접근거부), 22(요청제한 초과), 30(미등록 키), 31(만료), 32(미등록 IP).
- : data.go.kr이 JSON 대신 HTML/XML 본문을 보낸 경우(점검·차단 등).
502 upstream_invalid_response앞 500자가 함께 반환된다.upstream_body - 빈 배열: 필터에 일치하는 공고/콘텐츠 없음. 키워드/지역/대상 범위를 완화한다.
data - 일 갱신 1회(서비스설계서 기준): 같은 날 같은 공고의 마감일·상태가 갱신되지 않을 수 있으므로, 마감/접수 상태는 응답의 페이지에서 최종 확인한다.
detl_pg_url
- : 日期格式错误(非
400 bad_request)、YYYYMMDD值错误、perPage超出范围、开始日期>结束日期 → 根据提示修正输入。Y/N - : 代理服务器未配置
503 upstream_not_configured,或该数据集使用申请未获批。DATA_GO_KR_API_KEY - : data.go.kr返回
502 upstream_error,或出现resultCode != "00"/errMsg等认证/限额错误。SERVICE_KEY_IS_NOT_REGISTERED_ERROR- data.go.kr错误代码:10(参数错误)、20(访问拒绝)、22(请求超限)、30(未注册密钥)、31(密钥过期)、32(未注册IP)。
- : data.go.kr返回HTML/XML而非JSON内容(如系统维护、访问拦截等)。会同时返回
502 upstream_invalid_response的前500个字符。upstream_body - 空数组:没有匹配筛选条件的公告/内容。放宽关键词、地区或对象范围。
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.shpython3 -m py_compile kstartup-search/scripts/run_kstartup.py kstartup-search/tests/test_run_kstartup.pypython3 kstartup-search/scripts/run_kstartup.py --helppython3 kstartup-search/scripts/run_kstartup.py announcements --supt-regin 서울특별시 --dry-runPYTHONPATH=kstartup-search/scripts python3 -m unittest discover -s kstartup-search/tests -p 'test_*.py' -v- (K-Startup 라우트 5개 신규 케이스 포함)
node --test packages/k-skill-proxy/test/server.test.js npm run ci
라이브 스모크는 hosted proxy 환경에 가 설정되고 활용신청이 승인된 뒤에 수행한다.
DATA_GO_KR_API_KEY15125364无需K-Startup认证密钥即可进行以下验证:
./scripts/validate-skills.shpython3 -m py_compile kstartup-search/scripts/run_kstartup.py kstartup-search/tests/test_run_kstartup.pypython3 kstartup-search/scripts/run_kstartup.py --helppython3 kstartup-search/scripts/run_kstartup.py announcements --supt-regin 首尔特别市 --dry-runPYTHONPATH=kstartup-search/scripts python3 -m unittest discover -s kstartup-search/tests -p 'test_*.py' -v- (包含K-Startup路由5个新增用例)
node --test packages/k-skill-proxy/test/server.test.js npm run ci
线上冒烟测试需在托管代理环境中配置好且数据集使用申请获批后进行。
DATA_GO_KR_API_KEY15125364Safety notes
Safety notes
- 조회 전용 스킬. 사업 신청·계좌 연결·결제 자동화는 하지 않는다.
- 응답에 K-Startup 사이트 URL이 있으면 그대로 안내하고, 실제 신청은 사용자가 브라우저에서 직접 진행한다.
- 인증키는 프록시 서버에서만 다루며, 시에도 helper는
--dry-run로 대체한다.<DRY-RUN>
- 本技能仅用于查询。不进行事业申请、账户关联、结算自动化等操作。
- 若响应中包含K-Startup网站URL,直接引导用户访问,实际申请需用户在浏览器中自行操作。
- 认证密钥仅由代理服务器处理,即使在模式下,工具也会用
--dry-run替代密钥内容。<DRY-RUN>