[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CNT5A4NAYVBJKYYFKV55CQ":3,"skill-same:01M7CNT5A4NAYVBJKYYFKV55CQ":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M7CNT5A4NAYVBJKYYFKV55CQ","nts-business-registration",null,"국세청 사업자등록정보 진위확인 및 사업자등록 상태조회를 공공데이터포털 API(k-skill-proxy 경유)로 수행한다.","om-scogo\u002Fskillsh-scraper","om-scogo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160466840?v=4","01M79AWB6DFVCQ7RK70CS34B96","Om Achrekar","01M79AWB6ZM9SKR8KDH1WSSM22",0,"MIT","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fnomadamas-k-skill\u002Fnts-business-registration\u002Fnts-business-registration\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: nts-business-registration\ndescription: 국세청 사업자등록정보 진위확인 및 사업자등록 상태조회를 공공데이터포털 API(k-skill-proxy 경유)로 수행한다.\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1\n---\n\n# 국세청 사업자등록정보 진위확인 및 상태조회\n\n## What this skill does\n\n공공데이터포털의 **국세청_사업자등록정보 진위확인 및 상태조회 서비스**를 `k-skill-proxy` 경유로 호출해 다음을 확인한다.\n\n- `status`: 사업자등록번호 기준 상태조회 (`계속사업자`, `휴업자`, `폐업자`, 과세유형 등 upstream 응답 그대로 포함)\n- `validate`: 사업자등록번호 + 개업일자 + 대표자명(및 선택 필드) 기준 진위확인\n\n## When to use\n\n- \"이 사업자등록번호가 계속사업자인지 확인해줘\"\n- \"사업자등록번호 상태조회해줘\"\n- \"사업자등록번호, 개업일, 대표자명으로 진위확인해줘\"\n- 거래처 등록 전 공식 NTS\u002F공공데이터포털 기준 확인이 필요할 때\n\n## Prerequisites\n\n- 인터넷 연결\n- `python3`\n- 설치된 skill payload 안에 `scripts\u002Fnts_business_registration.py` helper 포함\n- hosted\u002Fself-host `k-skill-proxy`의 `\u002Fv1\u002Fnts-business\u002Fstatus`, `\u002Fv1\u002Fnts-business\u002Fvalidate` route 접근 가능\n\n## Credential requirements\n\n- 사용자 측 필수 시크릿 없음.\n- `KSKILL_PROXY_BASE_URL` — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https:\u002F\u002Fk-skill-proxy.nomadamas.org` 를 사용한다.\n- `DATA_GO_KR_API_KEY` 는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서 `국세청_사업자등록정보 진위확인 및 상태조회 서비스` 활용신청이 되어 있어야 한다.\n\n## Validate privacy boundary\n\n- `validate`는 대표자명(`p_nm`), 개업일자(`start_dt`), 주소·상호 같은 선택 메타데이터를 hosted proxy와 공공데이터포털 upstream으로 전송한다.\n- hosted proxy는 `validate` 성공 응답을 캐시하지 않고, 프록시 `query` echo를 붙이지 않으며, upstream이 요청값을 되돌려도 민감 입력 필드를 응답에서 제거한다.\n- 프록시의 기본 Fastify request logging은 꺼져 있다. 운영자가 별도 로그를 켠 self-host 환경에서는 요청 본문 로깅 정책을 직접 점검해야 한다.\n- hosted proxy 경유가 부담스러운 진위확인 업무는 `KSKILL_PROXY_BASE_URL`로 직접 운영하는 self-host proxy를 지정한다.\n\n## Official surfaces\n\n- 공공데이터포털 문서: `https:\u002F\u002Fwww.data.go.kr\u002Ftcs\u002Fdss\u002FselectApiDataDetailView.do?publicDataPk=15081808`\n- 상태조회 upstream: `POST https:\u002F\u002Fapi.odcloud.kr\u002Fapi\u002Fnts-businessman\u002Fv1\u002Fstatus?serviceKey=...`\n- 진위확인 upstream: `POST https:\u002F\u002Fapi.odcloud.kr\u002Fapi\u002Fnts-businessman\u002Fv1\u002Fvalidate?serviceKey=...`\n- 프록시 route: `POST \u002Fv1\u002Fnts-business\u002Fstatus`, `POST \u002Fv1\u002Fnts-business\u002Fvalidate`\n\n## Inputs\n\n### 상태조회\n\n- `b_no`: 사업자등록번호 10자리. 하이픈은 허용되며 helper\u002Fproxy가 숫자만 남긴다.\n- 한 요청은 최대 100개까지 보낸다.\n\n### 진위확인\n\n필수:\n\n- `b_no`: 사업자등록번호 10자리\n- `start_dt`: 개업일자 `YYYYMMDD` (하이픈\u002F점 허용)\n- `p_nm`: 대표자 성명\n\n선택:\n\n- `p_nm2`: 대표자 성명2\n- `b_nm`: 상호\n- `corp_no`: 법인등록번호\n- `b_sector`: 주업태명\n- `b_type`: 주종목명\n- `b_adr`: 사업장주소\n\n텍스트 필드는 NTS 입력 규격에 맞춰 보수적으로 길이를 제한한다(`p_nm`\u002F`p_nm2` 30자, `b_nm` 200자, `b_sector`\u002F`b_type` 100자, `b_adr` 500자). `corp_no`는 제공할 경우 숫자 13자리여야 한다.\n\n## Workflow\n\n1. 사용자 입력에서 사업자등록번호는 숫자 10자리인지 확인한다.\n2. 상태조회만 필요하면 `status`를 호출한다.\n3. 진위확인은 최소 `b_no`, `start_dt`, `p_nm`이 있을 때만 호출한다.\n4. 개인정보\u002F거래처 정보는 필요한 필드만 보내고, 프록시 응답을 그대로 보존하되 핵심 상태\u002F진위 결과를 짧게 요약한다.\n5. upstream이 `upstream_not_configured`, 활용신청 미승인, 인증키 오류 등을 반환하면 설정\u002F승인 문제로 안내한다.\n\n## CLI examples\n\n```bash\npython3 scripts\u002Fnts_business_registration.py status \\\n  --b-no 123-45-67890\n```\n\n```bash\npython3 scripts\u002Fnts_business_registration.py validate \\\n  --business-json '{\"b_no\":\"123-45-67890\",\"start_dt\":\"2020-01-31\",\"p_nm\":\"홍길동\",\"b_nm\":\"테스트상사\"}'\n```\n\n## Direct proxy examples\n\n```bash\ncurl -fsS -X POST \"$KSKILL_PROXY_BASE_URL\u002Fv1\u002Fnts-business\u002Fstatus\" \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"b_no\":[\"123-45-67890\"]}'\n```\n\n```bash\ncurl -fsS -X POST \"$KSKILL_PROXY_BASE_URL\u002Fv1\u002Fnts-business\u002Fvalidate\" \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"businesses\":[{\"b_no\":\"123-45-67890\",\"start_dt\":\"20200131\",\"p_nm\":\"홍길동\"}]}'\n```\n\n## Failure modes\n\n- `400 bad_request`: 사업자등록번호가 10자리가 아니거나 진위확인 필수 필드가 빠짐.\n- `503 upstream_not_configured`: 프록시 서버에 `DATA_GO_KR_API_KEY`가 없음.\n- upstream 인증\u002F활용신청 오류: API 키가 해당 서비스에 승인되지 않았거나 만료\u002F오류 상태.\n- 빈 결과 또는 진위불일치: 공식 응답의 `valid`, `valid_msg`, `b_stt` 값을 그대로 근거로 설명한다.\n\n## Done when\n\n- 상태조회는 공식 응답의 `b_stt`, `b_stt_cd`, `tax_type` 등 핵심 필드를 확인했다.\n- 진위확인은 `valid`, `valid_msg` 결과를 확인했다.\n- API 키는 사용자에게 요구하지 않고 프록시 서버에만 둔다는 점을 지켰다.\n","# 국세청 사업자등록정보 진위확인 및 상태조회\n\n## What this skill does\n\n공공데이터포털의 **국세청_사업자등록정보 진위확인 및 상태조회 서비스**를 `k-skill-proxy` 경유로 호출해 다음을 확인한다.\n\n- `status`: 사업자등록번호 기준 상태조회 (`계속사업자`, `휴업자`, `폐업자`, 과세유형 등 upstream 응답 그대로 포함)\n- `validate`: 사업자등록번호 + 개업일자 + 대표자명(및 선택 필드) 기준 진위확인\n\n## When to use\n\n- \"이 사업자등록번호가 계속사업자인지 확인해줘\"\n- \"사업자등록번호 상태조회해줘\"\n- \"사업자등록번호, 개업일, 대표자명으로 진위확인해줘\"\n- 거래처 등록 전 공식 NTS\u002F공공데이터포털 기준 확인이 필요할 때\n\n## Prerequisites\n\n- 인터넷 연결\n- `python3`\n- 설치된 skill payload 안에 `scripts\u002Fnts_business_registration.py` helper 포함\n- hosted\u002Fself-host `k-skill-proxy`의 `\u002Fv1\u002Fnts-business\u002Fstatus`, `\u002Fv1\u002Fnts-business\u002Fvalidate` route 접근 가능\n\n## Credential requirements\n\n- 사용자 측 필수 시크릿 없음.\n- `KSKILL_PROXY_BASE_URL` — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https:\u002F\u002Fk-skill-proxy.nomadamas.org` 를 사용한다.\n- `DATA_GO_KR_API_KEY` 는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서 `국세청_사업자등록정보 진위확인 및 상태조회 서비스` 활용신청이 되어 있어야 한다.\n\n## Validate privacy boundary\n\n- `validate`는 대표자명(`p_nm`), 개업일자(`start_dt`), 주소·상호 같은 선택 메타데이터를 hosted proxy와 공공데이터포털 upstream으로 전송한다.\n- hosted proxy는 `validate` 성공 응답을 캐시하지 않고, 프록시 `query` echo를 붙이지 않으며, upstream이 요청값을 되돌려도 민감 입력 필드를 응답에서 제거한다.\n- 프록시의 기본 Fastify request logging은 꺼져 있다. 운영자가 별도 로그를 켠 self-host 환경에서는 요청 본문 로깅 정책을 직접 점검해야 한다.\n- hosted proxy 경유가 부담스러운 진위확인 업무는 `KSKILL_PROXY_BASE_URL`로 직접 운영하는 self-host proxy를 지정한다.\n\n## Official surfaces\n\n- 공공데이터포털 문서: `https:\u002F\u002Fwww.data.go.kr\u002Ftcs\u002Fdss\u002FselectApiDataDetailView.do?publicDataPk=15081808`\n- 상태조회 upstream: `POST https:\u002F\u002Fapi.odcloud.kr\u002Fapi\u002Fnts-businessman\u002Fv1\u002Fstatus?serviceKey=...`\n- 진위확인 upstream: `POST https:\u002F\u002Fapi.odcloud.kr\u002Fapi\u002Fnts-businessman\u002Fv1\u002Fvalidate?serviceKey=...`\n- 프록시 route: `POST \u002Fv1\u002Fnts-business\u002Fstatus`, `POST \u002Fv1\u002Fnts-business\u002Fvalidate`\n\n## Inputs\n\n### 상태조회\n\n- `b_no`: 사업자등록번호 10자리. 하이픈은 허용되며 helper\u002Fproxy가 숫자만 남긴다.\n- 한 요청은 최대 100개까지 보낸다.\n\n### 진위확인\n\n필수:\n\n- `b_no`: 사업자등록번호 10자리\n- `start_dt`: 개업일자 `YYYYMMDD` (하이픈\u002F점 허용)\n- `p_nm`: 대표자 성명\n\n선택:\n\n- `p_nm2`: 대표자 성명2\n- `b_nm`: 상호\n- `corp_no`: 법인등록번호\n- `b_sector`: 주업태명\n- `b_type`: 주종목명\n- `b_adr`: 사업장주소\n\n텍스트 필드는 NTS 입력 규격에 맞춰 보수적으로 길이를 제한한다(`p_nm`\u002F`p_nm2` 30자, `b_nm` 200자, `b_sector`\u002F`b_type` 100자, `b_adr` 500자). `corp_no`는 제공할 경우 숫자 13자리여야 한다.\n\n## Workflow\n\n1. 사용자 입력에서 사업자등록번호는 숫자 10자리인지 확인한다.\n2. 상태조회만 필요하면 `status`를 호출한다.\n3. 진위확인은 최소 `b_no`, `start_dt`, `p_nm`이 있을 때만 호출한다.\n4. 개인정보\u002F거래처 정보는 필요한 필드만 보내고, 프록시 응답을 그대로 보존하되 핵심 상태\u002F진위 결과를 짧게 요약한다.\n5. upstream이 `upstream_not_configured`, 활용신청 미승인, 인증키 오류 등을 반환하면 설정\u002F승인 문제로 안내한다.\n\n## CLI examples\n\n```bash\npython3 scripts\u002Fnts_business_registration.py status \\\n  --b-no 123-45-67890\n```\n\n```bash\npython3 scripts\u002Fnts_business_registration.py validate \\\n  --business-json '{\"b_no\":\"123-45-67890\",\"start_dt\":\"2020-01-31\",\"p_nm\":\"홍길동\",\"b_nm\":\"테스트상사\"}'\n```\n\n## Direct proxy examples\n\n```bash\ncurl -fsS -X POST \"$KSKILL_PROXY_BASE_URL\u002Fv1\u002Fnts-business\u002Fstatus\" \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"b_no\":[\"123-45-67890\"]}'\n```\n\n```bash\ncurl -fsS -X POST \"$KSKILL_PROXY_BASE_URL\u002Fv1\u002Fnts-business\u002Fvalidate\" \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"businesses\":[{\"b_no\":\"123-45-67890\",\"start_dt\":\"20200131\",\"p_nm\":\"홍길동\"}]}'\n```\n\n## Failure modes\n\n- `400 bad_request`: 사업자등록번호가 10자리가 아니거나 진위확인 필수 필드가 빠짐.\n- `503 upstream_not_configured`: 프록시 서버에 `DATA_GO_KR_API_KEY`가 없음.\n- upstream 인증\u002F활용신청 오류: API 키가 해당 서비스에 승인되지 않았거나 만료\u002F오류 상태.\n- 빈 결과 또는 진위불일치: 공식 응답의 `valid`, `valid_msg`, `b_stt` 값을 그대로 근거로 설명한다.\n\n## Done when\n\n- 상태조회는 공식 응답의 `b_stt`, `b_stt_cd`, `tax_type` 등 핵심 필드를 확인했다.\n- 진위확인은 `valid`, `valid_msg` 결과를 확인했다.\n- API 키는 사용자에게 요구하지 않고 프록시 서버에만 둔다는 점을 지켰다.\n",{"name":5,"license":15,"metadata":24,"description":7},{"phase":25,"locale":26,"category":27},"v1","ko-KR","business","main","8859218955d9504cd18b59e7892100718039d3b4","data\u002Fskills\u002Fnomadamas-k-skill\u002Fnts-business-registration\u002Fnts-business-registration",1,"https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper","https:\u002F\u002Fgithub.com\u002Fom-scogo","SDE-1 @ Scogo ","2026-07-18 12:22:46",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add om-scogo\u002Fskillsh-scraper --skill nts-business-registration",{"tool":42,"command":43},"bunx","bunx skills add om-scogo\u002Fskillsh-scraper --skill nts-business-registration",{"tool":45,"command":46},"pnpm","pnpm dlx skills add om-scogo\u002Fskillsh-scraper --skill nts-business-registration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fnomadamas-k-skill\u002Fnts-business-registration\u002Fnts-business-registration\u002FSKILL.md",true,[],[51,58,63,70,75,82],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7D6MC9FAAEV4CMNYX8W7JTG","arxiv-search","Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002Fskills\u002Farxiv-search\u002FSKILL.md",[],[],{"skillNo":59,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7D6M85CKKN87TA98VCQV4H7","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002FSkill.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7D4ZTCS4DR3CE4JY06X84T2","working-with-legacy-code","Safely change and test untested codebases using Feathers' \"Working Effectively with Legacy Code\". Use when the user mentions \"legacy code\", \"no tests\", \"untested codebase\", \"how do I test this\", \"seams\", \"characterization tests\", \"golden master\", \"sprout method\", \"afraid to change this code\", \"monster method\", \"dependency breaking\", or \"inherited a messy codebase\". Also trigger when changing code without tests safely, getting a class under test when constructors, statics, or singletons block it, adding features to tangled modules, or planning incremental test coverage for an old codebase. Covers the legacy-code change algorithm, seams, characterization tests, sprout\u002Fwrap, and dependency-breaking techniques. For refactoring code that already has tests, see refactoring-patterns. For day-to-day code quality, see clean-code.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002Fworking-with-legacy-code\u002FSKILL.md",[],[],{"skillNo":71,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7D4ZHZKJD2RSNGAF63V14P4","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002FSkill.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7D4ZB4CJBFW5JE67CPH2QRV","web-typography","Select, pair, and implement typefaces for web projects. Use when the user mentions \"font pairing\", \"which typeface\", \"line height\", \"responsive typography\", \"web font loading\", \"type hierarchy\", \"variable fonts\", \"FOUT\u002FFOIT\", \"typographic scale\", or \"the text is hard to read\". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002Fweb-typography\u002FSKILL.md",[],[],{"skillNo":83,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7D4Z4MVYVY3NMJ18BNV6WNA","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002FSkill.md",[],[]]