convez.ai
SkillIntegração & APIsIntermediário
sergiobuilds

Verificação de Saúde de Negócio (Cadastro BR)

sergiobuilds/biz-health-check

Validação de empresa via CNPJ contra 6 bases públicas brasileiras

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que consulta dados públicos brasileiros (Receita Federal, INSS, inadimplência, reguladores) para validar a situação real de uma empresa usando apenas seu CNPJ. Retorna fatos brutos com fontes e timestamp, sem interpretações ou scores.

Instalação

$npx convez-ai sergiobuilds/biz-health-check

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Due diligence de parceiros comerciais antes de contratos
  • Verificação de regularidade fiscal e previdenciária em processos de crédito
  • Monitoramento de fornecedores e status operacional em tempo real

Veredito

Skill robusto e bem-testado que integra múltiplas APIs de dados públicos com princípio admirável de transparência (fatos sem interpretação). Orientado para contextos B2B e compliance, com roadmap claro para expansão a micro-negócios.

README

A tradução para o português deste README ainda está na fila.

biz-health-check

사업자등록번호 하나로 "이 사업자, 실제 문제 없나"를 확인하는 실사 사실 조회 스킬. k-skill(NomaDamas/k-skill) 기여용으로 개발 중 — 스킬 본체는 SKILL.md, 구현은 scripts/.

핵심 원칙

점수·등급·해석 라벨 없음. 조회된 사실 + 출처 + 조회시각만 병렬. 실패는 크래시 대신 unavailable/needs-key 강등.

빠른 실행

DATA_GO_KR_KEY=<공공데이터포털 키> python3 scripts/biz_health_check.py 124-81-00998 --name 삼성전자
python3 -m pytest tests/ -q   # 오프라인 단위 테스트 (네트워크 차단)

provider 현황 (2026-06-11 실측 — 6/6 live)

provider상태
국세청 상태조회live 검증 완료 (계속사업자 응답 확인)
체납 명단공개 검색live 검증 완료 (무인증, 법인·개인 명단 0건 매치 정상)
국민연금 가입 사업장live 검증 완료 — V2(camelCase) 기준, 가입자수·당월고지금액·월별 증감까지 확인
금융위 기업기본정보live 검증 완료 — 법인명 검색 + bzno 교차검증으로 정확 일치 후보 분리 확인
조달청 부정당제재업체정보live 검증 완료 — 나라장터 사용자정보 서비스(15129466), 사업자번호 정확 일치, 현재 유효 제재만
지방행정 인허가 영업상태live 검증 완료 — LOCALDATA 지역별 CSV(무인증), 업종 16종 등록, --region 필요, 1일 로컬 캐시

k-skill 기여 메모

  • 1차 PR은 BYO 키(DATA_GO_KR_KEY)로만. proxy route(연금·금융위)는 운영자 협의 후 후속 분리.
  • 합본 vs 단품 분리, 네이밍은 운영자 회신 반영 예정.

v2 로드맵 — 소규모 사업장(인허가 업종) 확장

목표: 법인 중심 5종에 더해, 동네 사업장(식당·숙박 등 인허가 업종)도 "영업 중/휴업/폐업, 업력, 주인 교체"가 한 방에 나오게 한다.

  • 백본 후보 1 — 행정안전부 개방표준(표준데이터셋): 전국 일반음식점(data.go.kr 15096283), 전국 숙박업소(15155657). api.data.go.kr/openapi/tn_pubr_public_*_api 패턴, data.go.kr 키 + 활용신청(자동승인). 엔드포인트 slug가 활용신청 승인 페이지에서만 공개되는 구조 확인(2026-06-11) — 신청 후 배선.
  • 백본 후보 2 — LOCALDATA(지방행정인허가, localdata.go.kr): 단일 키로 ~190 인허가 업종 + 변동분 동기화. 별도 회원가입·키 발급 필요, 벌크 동기화 지향(상호 단건 검색 비적합). 2026-06-11 현재 사이트 접속 불가(타임아웃) — 복구 후 재평가.
  • 매칭 한계(정직): 인허가 데이터에는 사업자등록번호가 수록되지 않아 상호+소재지 문자열 매칭만 가능 — 체납 명단과 같은 identity_note 방식으로 동일성 단정 금지.
  • 모니터링(watchlist+diff+알림)은 단발 조회와 성격이 달라 별도 스킬/인프라로 분리한다.
Ver o original no GitHub

Bom para

Relacionados