프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

ir-search Skill

저장소 ↗

제작자: djfksjd★ 394skill 1개

설치

What it does

🇰🇷 한국 정부 지원사업 전수조사 에이전트 스킬 [Claude Code·Codex·agy(Antigravity)·Cursor·Gemini CLI·Grok Build 지원] K-Startup·기업마당·NIPA·KOCCA·SMTECH 크롤링 + 즉시/로드맵/변형 3분류 (Korea-only)

  • Connects Instruction files the AI reads, with steps that call an outside service
  • Account or key Some steps need a key for DATA_GO_KR_KEY (per the README)
  • Category 코딩
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/djfksjd-ir-search.svg)](https://mcp.popnx.com/en/skills/djfksjd-ir-search)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

제작자: morluto널리 사용됨↓ 38.9만/주★ 46.8만7일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

제작자: fallow-rs널리 사용됨↓ 244.1만/주★ 5.4천그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만어제 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
ir-search
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
제작자djfksjdmorlutomultica-aiGraphify-Labsharry0703
Skill 수11111
GitHub 별394467,235234,125149,873144,332
마지막 코드 변경2026년 7월 30일2026년 11월 18일2026년 4월 20일2026년 11월 18일2026년 11월 18일
라이선스MITMIT–Apache-2.0MIT

djfksjd의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude CodeCodexCursorGemini CLI

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account djfksjd (person), 1 years old

  • Use and upkeep

    ★ 394 stars, few users so far · code last changed 2026년 7월 30일

  • Any scripts?

    7 scripts that can run on a computer: scripts/attach_download.py, scripts/diff_surveys.py, scripts/kstartup_api.py, scripts/kstartup_crawl.py and 3 more

  • Uses the internet?

    Scripts that go online: scripts/kstartup_api.py, scripts/attach_download.py, scripts/kstartup_crawl.py, scripts/sources_crawl.py

  • Changes machine-wide settings?

    Installing the maker’s way adds hooks that run without you asking: run every time a chat starts

Checked automatically from the repo files at commit 9ef913a (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (730). Use "Let the AI install it" instead

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /ir-search를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Claude Code를 다시 열고 /ir-search를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

ir-search 폴더를 ~/.agents/skills/ir-search에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 ir-search 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Cursor Agent 채팅에서 /를 입력하고 ir-search 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · GitHub에서 전체 파일 열기

---
name: ir-search
description: '한국 정부·공공기관 지원사업(창업지원, 사업화 자금, 입주공간, R&D, 바우처, 경진대회) 전수조사 및 프로젝트 적합성 판정 스킬. K-Startup·기업마당(bizinfo)·NIPA·KOCCA·SMTECH 공고를 크롤링해 현재 작업 폴더의 프로젝트(아이템) 프로필에 맞는 사업을 "즉시 지원 가능 / 요건 충족 시 / 변형하면 가능" 3단계로 분류하고 마감일·자격요건을 원문 검증해 보고서를 만든다. 사용자가 "지원사업 찾아줘", "정부지원", "창업지원 사업", "입주공간/사업화 자금 알아봐", "공모전/경진대회 조사", "우리 아이템에 맞는 지원사업", "K-Startup/기업마당 조사" 등을 요청하면 반드시 이 스킬을 사용한다. 이전에 조사한 적이 있는 프로젝트에서 "재조사", "새로 나온 지원사업 있나", "지난번 이후 뭐 올라왔나"를 물으면 diff 모드(증분 재조사)로 이 스킬을 사용한다. 특정 사이트를 지목하지 않아도 지원사업·보조금·정부과제 탐색 의도가 보이면 트리거된다. 단, 이미 운영 중인 소상공인·가게·점포·자영업자의 지원(소상공인 지원금, 정책자금 대출, 가게 시설개선, 소상공인24, 폐업·재기 지원)은 이 스킬이 아니라 sole-search 스킬을 사용한다. 신호가 섞이면(예: ''온라인 셀러 지원금'') 어느 쪽인지 한 번 묻는다. 사용자 신분보다 요청 목적이 우선이다 — 가게 사장이라도 신규 아이템 창업지원·R&D를 찾으면 ir-search. 한국 지원사업 전용.'
---

# ir-search — 지원사업 전수조사

> **스크립트 위치**: 크롤러·유틸리티는 플러그인 디렉토리 아래 `${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/` 에 있다. `${CLAUDE_PLUGIN_ROOT}`가 미정의(단독 스킬 설치)면 폴백: `~/.claude/skills/ir-search/skills/ir-search/scripts/` (클래식 설치) 또는 **이 SKILL.md와 같은 폴더의 `scripts/`**. 아래 코드 블록의 `${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/` 부분을 실제 확인된 경로로 치환해 실행한다.

정부 지원사업 탐색의 3대 실패 원인을 구조적으로 막는 스킬이다:

1. **키워드 검색의 사각지대** — "AI"로 검색하면 변형 지원이 가능한 콘텐츠·사회서비스·예술융합 사업을 놓친다. → 모집중 공고 **전수(全數)** 수집 후 제목 전체를 직접 검토한다.
2. **자격요건 오판** — 제목만 보고 지원했다가 "예비창업자 불가", "지역 제한"으로 탈락한다. → 후보는 반드시 상세공고 원문에서 신청대상·지역제한을 검증한다.
3. **추정 보고** — "아마 될 것"이라는 결론은 방향을 망친다. → 공고 텍스트에 없는 것은 '불명'으로 표기하고 접수기관 유선확인을 권고한다.

## 워크플로

### 0단계 — 신청자(아이템) 프로필 구축

**먼저 프로젝트 폴더에서 `ir-search-profile.md`를 찾는다.** 있으면 내용을 요약해 보여주고 "바뀐 것 있나요?" **한 번만** 확인한 뒤 바로 1단계로 간다 — 같은 질문을 조사 때마다 반복하는 것이 이 스킬의 가장 큰 마찰이므로, 프로필이 있으면 아래 질문은 생략한다.

없으면 현재 작업 폴더에서 프로젝트 정보를 수집한다: CLAUDE.md, README, docs/, 메모리(있다면). 그래도 비는 항목은 사용자에게 **한 번에** 묻는다 (여러 번 나눠 묻지 않는다):

- **창업 단계**: 예비창업자(사업자 미등록) / 개인사업자 / 법인 + 업력 — 가장 많은 사업을 가르는 축
- **지역 연고**: 현재 소재지, 이전 가능 지역 — 지역 제한 사업 판정과 "비수도권" 요건(프리팁스 등)에 필요
- **대표자 특성**: 연령대(청년 만39세 이하 / 중장년 만40세 이상), 성별(여성 특화 사업), 소속(대학·출연연 재직 여부)
- **필요한 것**: 사업화 자금 / 입주공간 / R&D / 멘토링·컨설팅 / 글로벌 / 인프라(GPU·장비) — 복수 선택
- **아이템 한 줄 요약**: 기술·업종 (변형 프레이밍 판단의 재료)

이미 대화나 폴더에서 파악된 항목은 다시 묻지 않는다.

**프로필 확정 후 프로젝트 폴더에 `ir-search-profile.md`로 저장한다** (기존 파일이 있으면 갱신). 형식:

```markdown
# ir-search 프로필
- 대상: <프로젝트명 (아이템 한 줄)>
- 창업 단계: <예비창업자 / 개인사업자 / 법인 N년차>
- 지역 연고: <소재지 (이전 가능: ...)>
- 대표자: <연령대 / 성별 / 소속>
- 필요한 것: <자금, 공간, R&D, ...>
- 마지막 조사: <보고서 폴더 경로> (<YYYY-MM-DD>)
```

`마지막 조사` 줄은 매 조사 완료 시 갱신한다 — 재조사(diff 모드)가 이 경로로 직전 결과를 찾는다. 이 파일은 로컬 프로젝트 폴더에만 저장되며, 프로필 축 외의 개인정보는 넣지 않는다.

### 0.5단계 — 조사 범위 명시 선택

실제 수집 전에 범위 계획기를 실행해 사용자 선택과 커버리지 한계를 고정한다. 계획기는
Python 표준 라이브러리만 사용하고 **네트워크·LLM을 호출하지 않으므로 모델 토큰은 0**이다.

```bash
# 빠른 확인: K-Startup만
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/scope_plan.py" \
    --preset quick -o scope-plan.json

# 특정 소스 하나만
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/scope_plan.py" \
    --preset focused --source kstartup -o scope-plan.json

# 프로필 기반 권장 범위
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/scope_plan.py" \
    --preset recommended --need ai --need rnd --province 서울 -o scope-plan.json

# 사용자가 직접 고른 범위 (후보 소스는 자동화하지 않고 manual로 남음)
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/scope_plan.py" \
    --preset custom --source kstartup --source iris -o scope-plan.json
```

프리셋 의미:

- `quick`: K-Startup만. 빠른 확인이지 전체 조사가 아니다
- `focused`: 사용자가 지목한 소스 정확히 하나
- `recommended`: K-Startup·기업마당 + 프로필 태그에 맞는 **검증된** 어댑터
- `all_registered`: 현재 저장소에 검증된 자동 어댑터 5개 전체. 인터넷 전체가 아니다
- `all_known`: 등록 어댑터와 알려진 공식 후보 전체. 후보는 모두 수동 확인으로 남는다
- `custom`: 사용자가 명시한 소스 조합. 미검증 후보는 `candidate/manual`

`scope-plan.json`의 모든 소스 상태(`selected / omitted_by_user / not_applicable`,
`automated / manual`)와 요청 수·시간 추정을 먼저 보여준다. 보고서에는
`scope_fingerprint`와 "선택 범위 기준" 커버리지를 기록한다. 재조사는 직전과 fingerprint가
같을 때만 GONE·UNCHANGED 승계를 허용한다. fingerprint가 다르면 소스 제외를 GONE으로
오판하지 말고 범위 변경으로 표시해 전체 재판정한다. 후보·수동 출처 목록과 등록 조건은
`references/sources.md`를 따른다.

### 재조사 — diff 모드

프로필의 `마지막 조사` 폴더가 존재하면 (또는 사용자가 이전 보고서 폴더를 지목하면) **전수 재검토 대신 증분 조사**를 한다. 지원사업 조사는 2~4주마다 반복하는 일이고, 매번 250건+를 다시 읽는 것은 낭비다:

1. 1단계 크롤링은 **직전과 같은 소스 구성으로** 그대로 실행한다 (소스를 빼면 diff가 그 소스를 비교 못 하고, 새 소스는 전수 검토 대상이 된다)
2. 새 보고서 폴더에 jsonl 저장 후 비교 — 프로필 스냅샷이 있으면 반드시 함께 넘긴다:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/diff_surveys.py" <직전_폴더> <새_폴더> --out new_items.jsonl \
       --old-profile <직전_폴더>/ir-profile-snapshot.md --new-profile ir-search-profile.md
   ```
3. **검토·상세검증은 `new_items.jsonl`(신규 + 변경 + NEEDS_REHASH + 새 소스분)만** 한다. UNCHANGED 항목은 직전 보고서의 A/B/C 판정을 그대로 승계하고 재검증하지 않는다. `--out` 파일은 sole-search와 공통인 wrapper 형식이다 — 한 줄에 `{"kind": NEW|CHANGED|NEEDS_REHASH, "diff_status": kind와 동일, "changed_fields": [...], "record": {원본 레코드 + source/source_id 정규화}}` (`references/diff_record_schema.json` 계약). NEEDS_REHASH(직전엔 content_hash가 있었는데 새 조사에 없음)는 상세 재수집(`--merge-into`) 후 재분류한다. 소멸 공고는 `--out`이 아니라 옆의 `gone_new_items.jsonl`(kind GONE)에 기록된다 — 기회 소멸 알림 재료
4. 상세 검증(`--merge-into`)을 거친 레코드는 content_hash로도 비교된다: 목록 필드가 그대로여도 본문(해시)이 바뀌면 CHANGED다. 두 조사의 hash_version이 다르면(v2↔v3 산식 전환 — 값 비교 불가) **1회 CHANGED(상세 재검증)**로 흡수한다
5. **프로필의 판정 축(창업 단계·지역·연령 등)이 바뀌었으면 UNCHANGED 승계 금지 — 전수 재검토한다.** diff 스크립트가 fingerprint로 이를 검증하며, 프로필 인자를 한쪽만 줬거나 fingerprint가 다르면 "CARRY-OVER INVALIDATED"를 출력하고 전건을 `--out`에 기록한다
6. CHANGED(제목·기간·상태 변경)는 changed_fields를 보고 판단: 마감일만 연장이면 판정 유지 + 마감일 갱신, 단 이전 A그룹 건이면 상세를 재확인 (연장 공고는 자격요건 변경이 동반되기도 한다)
7. 보고서는 증분 구조로: **신규 공고 (A/B/C 분류) / 변경 (changed_fields 명시) / 종료된 공고 중 직전 A그룹이던 것 (기회 소멸 알림) / 승계 요약 (직전 A그룹 현황 + 남은 마감)**. 직전 보고서 경로를 상단에 링크한다
8. **조사 완료 시 사용한 프로필 사본을 보고서 폴더에 `ir-profile-snapshot.md`로 저장한다** — 다음 diff의 `--old-profile` 입력이 된다

diff 스크립트가 출력하는 WARNING(재크롤 안 된 소스)이 있으면 그 소스는 "미갱신"으로 보고서에 명시한다 — 조용히 빠뜨리지 않는다.

### 1단계 — 전수 수집 (다중 소스)

두 개의 검증된 크롤러가 동봉되어 있다:

```bash
# 기본: K-Startup 모집중 전수 (창업지원 중심, 250~300건, 1~2분)
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/kstartup_crawl.py" list -o kstartup_all.jsonl

# 보강: 기업마당·NIPA·KOCCA·SMTECH (프로필에 따라 선택)
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/sources_crawl.py" list bizinfo -o bizinfo.jsonl --max-pages 20
python3 "${CLAUDE_PLUGIN_ROOT}/skills/ir-search/scripts/sources_crawl.py" list all -o sources_all.jsonl
```

**K-Startup 공식 API 우선 (data.go.kr 키가 있으면)**: `kstartup_crawl.py list`는 data.go.kr 서비스키가 있으면 **공식 오픈API(K-Startup 사업공고, 데이터셋 15125364)로 모집중 공고를 받고**, 키가 없거나 API가 실패/응답 이상/커버리지 부족이면 **자동으로 공개 페이지 크롤로 폴백**한다. 출력 jsonl 스키마·`run_manifest.json`은 두 경로가 동일하다. **커버리지 정직성**: 이 데이터셋은 등록순(최신우선)이고 모집중 공고가 마감 이력 사이에 분산돼 있어, API는 최신우선 스캔으로 모집중 집합을 모은다 — 데이터셋 끝까지 스캔해 totalCount로 소진을 증명하면 manifest `stop_reason: "api"`·status `ok`·**exit 0**(전수 증명), 최신우선 무마감 페이지 연속으로 조기 종료하면 `stop_reason: "api-window"`·status `partial`·**exit 2**로 정직하게 남긴다(최근 창(window) 커버리지, 전수 증명 아님 — 기존 exit 계약과 일치). `api-window`일 때는 뒤늦게 재연장된 오래된 공고가 누락될 수 있으므로 **전수 보증은 크롤이 권위**이며, **diff 모드는 partial(api-window) 실행에서 GONE(소멸)을 단정하지 않는다**. `reported_total`은 전체 이력 건수다. 401/403·200 위장 차단(CAPTCHA)은 크롤로 우회하지 않고 **수동 전환(exit 3)**한다. 키는 `DATA_GO_KR_KEY` 환경변수 → 리포 루트 `.env` → `~/.config/ir-search/data_go_kr_key` 순으로 탐색하고 **로그·에러·명령행에 절대 출력하지 않는다**(리다이렉트·URL 인코딩 변형까지 마스킹, `apis.data.go.kr` 호스트 검증, 자동 리다이렉트 차단). 키 발급: `data.go.kr/data/15125364/openapi.do`에서 활용신청 → 서비스키 확인(같은 키를 bizinfo·gov24 등 다른 data.go.kr API에 재사용 가능). `.env`는 gitignore로 커밋되지 않는다.

**크롤러 종료코드 계약**: 0 = 전체 수집 성공 / 2 = partial(네트워크 오류·구조 변경·페이지 캡·소스 일부 실패). **exit 2면 partial이다 — 절대 "0건이지만 성공"으로 취급하지 않는다.** jsonl은 partial이어도 수집분까지는 저장돼 있다.

**커버리지 기록 — `run_manifest.json` 기준**: 두 크롤러 모두 `list` 실행이 끝나면(성공·partial 모두) 출력 jsonl **옆에 `run_manifest.json`(schema v1)을 원자적으로 기록**한다. 소스별 run 항목에 `status(ok/partial)·exit_code·pages_fetched·collected·duplicates·stop_reason·errors`가 들어 있고, 같은 폴더에 여러 소스를 수집하면(`all` 모드 포함) 소스별 항목이 한 파일에 누적된다(같은 소스는 최신으로 교체). **보고서의 커버리지(한계 고지)는 stderr 메시지가 아니라 이 파일을 읽어 작성한다** — 어떤 소스가 몇 페이지까지·몇 건 수집됐고 왜 멈췄는지(stop_reason·errors)를 그대로 옮긴다. status가 `partial`인 소스는 "미완 수집"으로 명시한다. manifest에는 카운트·상태만 있고 검색어·프로필·공고 본문은 넣지 않는다.

**소스

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
394
제작자
djfksjd
라이선스
MIT
최근 코드 수정
2026년 7월 30일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-skills, antigravity, claude-code, claude-skill, codex, crawler, cursor, gemini-cli, government-grants, grok, korea, startup