HojinCheck — Japanese corporate verification API (hojin = 法人/corporate entity)
Verify Japanese companies, invoice-issuer registrations and addresses against government open data.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWresolve_company에서
- LOWverify_company에서
- LOWverify_invoice_number에서
- LOWnormalize_address에서
- LOWjp_calendar에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"hojincheck": {
"url": "https://hojincheck.com/mcp"
}
}
}원격 엔드포인트
https://hojincheck.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
⚪resolve_company(name, address, include_closed, limit)
法人名(表記ゆれ・かな/カナ対応)から法人番号の候補と確度(0〜1+根拠ラベル)を返します。データ源: 国税庁法人番号システムWeb-API。
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "法人名((株)等の略記・全半角・かな/カナ・旧字体の表記ゆれ可)"
},
"address": {
"type": "string",
"pattern": "^\\d{2}(\\d{3})?$",
"description": "所在地で絞り込み: 都道府県コード2桁(JIS X 0401)または+市区町村コード3桁の計5桁"
},
"include_closed": {
"type": "boolean",
"default": true,
"description": "閉鎖法人を候補に含める(既定true)"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10,
"description": "返却する候補数の上限(既定10)"
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪verify_company(corporate_number, include_history)
法人番号(13桁・チェックディジット検証つき)から実在・商号・本店所在地・法人種別・閉鎖ステータスを返します。include_history=trueで商号変更等の履歴も返します。データ源: 国税庁法人番号システムWeb-API。
입력 스키마
{
"type": "object",
"properties": {
"corporate_number": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "法人番号13桁(全角・ハイフン・空白は吸収)"
},
"include_history": {
"type": "boolean",
"default": false,
"description": "商号変更等の履歴を含める(既定false)"
}
},
"required": [
"corporate_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪verify_invoice_number(registration_number, on_date, include_history)
適格請求書発行事業者の登録番号(T+13桁)から登録有無・登録年月日・取消/失効を返します。on_dateで基準日時点の有効性判定、include_history=trueで公表履歴も返します。入力は登録番号のみ(氏名等による検索は提供しません)。データ源: 国税庁適格請求書発行事業者公表システムWeb-API。
입력 스키마
{
"type": "object",
"properties": {
"registration_number": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "適格請求書発行事業者登録番号(T+13桁。Tなし13桁・全角・ハイフン空白は吸収)"
},
"on_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "基準日 YYYY-MM-DD(指定時はその日時点で登録が有効だったかを as_of で返す)"
},
"include_history": {
"type": "boolean",
"default": false,
"description": "公表履歴(新規登録・変更・取消・失効)を含める(既定false)"
}
},
"required": [
"registration_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_company_profile(corporate_number)
法人番号(13桁・チェックディジット検証つき)からgBizINFOの法人プロファイル(所在地・代表者・資本金・従業員数等)を、項目別の出典・最終取得日メタとあわせて返します。データ源: Gビズインフォ REST API v2(経済産業省)。
입력 스키마
{
"type": "object",
"properties": {
"corporate_number": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "法人番号13桁(全角・ハイフン・空白は吸収。チェックディジット検証あり)"
}
},
"required": [
"corporate_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪normalize_address(address, postal_code)
日本の住所を正規化し、都道府県/市区町村/町字(大字・町名+丁目)に分解して町字ID(アドレス・ベース・レジストリ)を解決し、郵便番号と照合します(不一致は不一致として明示)。【v1の粒度と限界】分解は町字(大字・丁目)まで。街区符号・住居番号・地番・小字・京都の通り名は解析対象外で、未解析部分は残余文字列としてそのまま返します(推測補完なし)。データ源: アドレス・ベース・レジストリ町字マスター(デジタル庁)+日本郵便郵便番号データ(ローカルマスター駆動・政府API停止の影響なし)。
입력 스키마
{
"type": "object",
"properties": {
"address": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "日本の住所文字列(郵便番号含み可。全半角・漢数字/算用数字・旧字体の表記ゆれ可)"
},
"postal_code": {
"type": "string",
"pattern": "^\\d{3}-?\\d{4}$",
"description": "郵便番号を別引数で渡す場合に指定(住所文字列内の記載より優先して照合)"
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪jp_calendar(op, date, days, from, to, ...)
日本の祝日判定と営業日計算(内閣府「国民の祝日」CSV準拠)。営業日=土日・祝日以外。year_end_as_holiday=trueで12/29〜1/3も非営業日扱い。
입력 스키마
{
"type": "object",
"properties": {
"op": {
"type": "string",
"enum": [
"is_business_day",
"next_business_day",
"prev_business_day",
"add_business_days",
"list_holidays"
],
"description": "操作種別"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "基準日 YYYY-MM-DD(list_holidays以外で必須)"
},
"days": {
"type": "integer",
"minimum": -1000,
"maximum": 1000,
"description": "加算する営業日数(add_business_daysで必須。負数=遡り、0=基準日をそのまま返す)"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "期間開始日(list_holidaysで必須)"
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "期間終了日(list_holidaysで必須)"
},
"year_end_as_holiday": {
"type": "boolean",
"default": false,
"description": "12/29〜1/3を非営業日として扱う(官公庁・銀行休業の慣行。既定false=祝日法と土日のみ)"
}
},
"required": [
"op"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거