インターネット等記所登記部等本自動化

このスキルが行うこと

大法院インターネット等記所(IROS, https://www.iros.go.kr)で、法人/不動産登記部等本(登記事項証明書) を複数件発行する必要がある場合、原著者 challengekim の参考実装 challengekim/iros-registry-automation (MIT)を基準に、安全な作業順序とローカル実行方式を案内する。

• 法人登記部等本：法人登録番号または商号でショッピングカートに追加し、ユーザーが直接決済した後、閲覧・保存する。
• 不動産登記部等本：住所/号室リストでショッピングカートに追加するが、決済・閲覧・ダウンロードはインターネット等記所ウェブUI で手動で処理することを基本推奨とする。
• TouchEn nxKey、公同認証書/簡便認証、カード決済のようにユーザーPC・認証手段が必要な準備事項をチェックする。
• 発行ファイルと入力リストに含まれる個人情報/機密情報をリポジトリ外で扱うよう案内する。

Hard limits

• ログインはユーザーがブラウザで直接行う。 ID/PW、公同認証書パスワード、簡便認証、OTP、セキュリティカード、カード番号をエージェントが入力・保存しない。
• 決済はユーザーが直接行う。 カード承認、決済確認、決済失敗対応は人がブラウザで処理する。
• 法律相談、権利関係解釈、提出/発行結果の法的有効性保証は行わない。このスキルは参考用自動化ガイドである。
• IROS セキュリティプログラム(TouchEn nxKey等)が要求されたら、先にインストールしてブラウザ/PCを再起動した後、再度開始する。
• 法人決済は upstream ドキュメント基準 ページごと10件 の単位制約を前提に案内する。それ以上はユーザーが10件単位で繰り返し決済する。
• 不動産はインターネット等記所がログイン状態で10万円未満一括決済と一括閲覧出力/一括保存UIを提供するため、v1では、ショッピングカート繰り返し作業のみ自動化価値が大きい領域と見なす。

Prerequisites

• Chrome/Chromium 実行可能な環境
• Python 3.10+
• Playwright / Chromium インストール可能な環境
• IROS ログイン手段(アイディ、公同認証書、簡便認証等)
• 決済カード
• TouchEn nxKey 事前インストール
• upstream 参考実装 clone または、ユーザーが管理するローカルコピー。実行前に必ずこのスキルリポジトリの iros-registry-automation/scripts/upstream.pin に書かれた reviewed SHA で固定する。

git clone https://github.com/challengekim/iros-registry-automation.git
cd iros-registry-automation
git checkout 7c6924b2ff88d693a12556659188cb91041e5097
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium
cp config.json.example config.json

upstream ピン更新はログイン・認証・決済隣接ブラウザ自動化の信頼境界を変える作業である。scripts/upstream.pin 値を変える前に、新しい upstream diff をレビューし、インストール例の git checkout SHA と共に同じPRで更新する。

Workflow

1. 入力ファイルをリポジトリ外の安全なフォルダに準備する

発行対象には法人登録番号、商号、住所、号室など機密情報が含まれる。公開リポジトリ、PR、テストログに入れない。

workdir="$(mktemp -d "${TMPDIR:-/tmp}/iros-registry.XXXXXX")"
chmod 700 "$workdir"
mkdir -p "$workdir/downloads" "$workdir/logs" "$workdir/output" "$workdir/tmp-downloads"

法人登録番号ベースの入力は upstream repo data/ ではなく $workdir/corp-input.json のようなリポジトリ外のファイルに置く。実際の法人登録番号/住所原文を upstream data/ ディレクトリ、git リポジトリ、PR添付、テストログに入れない。

iros_download.py は決済後の閲覧・保存段階で companies_list を開いて保存ファイル名を合わせる。法人登録番号フローを使う場合でも、決済前に $workdir/companies-input.json を一緒に作っておく。

cat > "$workdir/corp-input.json" <<'JSON'
{
  "1101111234567": "例示 株式会社",
  "1101117654321": "サンプル 株式会社"
}
JSON

python3 - "$workdir" <<'PY'
import json
import pathlib
import sys

workdir = pathlib.Path(sys.argv[1])
corp_input = json.loads((workdir / "corp-input.json").read_text())
companies = list(corp_input.values())
(workdir / "companies-input.json").write_text(
    json.dumps(companies, ensure_ascii=False, indent=2) + "\n"
)
PY

不動産住所ベースの入力例は棟/号室まで必要な場合があるため、data/iros_realties.json 形式を upstream README で確認するが、実際の住所原文は $workdir/realty-input.json のようなローカルファイルのみに置く。

事業者番号調査や統合レポートウィザードフローで使う顧客Excel も upstream repo data/ ではなく $workdir/customer-list.xlsx のようなリポジトリ外のファイルに置く。実際の顧客リストを upstream data/顧客リスト.xlsx にコピーしない。

config.json もリポジトリにコミットしないローカルファイルとし、機密入力・ログ・成果物パスをすべて $workdir 下に向ける。

python3 - "$workdir" <<'PY'
import json
import pathlib
import sys

workdir = pathlib.Path(sys.argv[1])
config = json.loads(pathlib.Path("config.json").read_text())
config.update({
    "corpnum_list": str(workdir / "corp-input.json"),
    "companies_list": str(workdir / "companies-input.json"),
    "realty_list": str(workdir / "realty-input.json"),
    "excel_path": str(workdir / "customer-list.xlsx"),
    "save_dir": str(workdir / "downloads"),
    "realty_save_dir": str(workdir / "downloads" / "realty"),
    "pdf_dir": str(workdir / "downloads"),
    "report_output": str(workdir / "output" / "corp-report.xlsx"),
    "extract_output": str(workdir / "output" / "corp-extract.json"),
    "bizno_cache": str(workdir / "logs" / "bizno-cache.json"),
    "bizno_results": str(workdir / "logs" / "bizno-results.json"),
    "realty_cart_log": str(workdir / "logs" / "cart-realty-log.json"),
    "realty_download_log": str(workdir / "logs" / "download-realty-log.json"),
    "cart_log": str(workdir / "logs" / "cart-log.json"),
    "cart_corpnum_log": str(workdir / "logs" / "cart-corpnum-log.json"),
    "download_log": str(workdir / "logs" / "download-log.json"),
    "download_temp": str(workdir / "tmp-downloads"),
})
pathlib.Path("config.json").write_text(json.dumps(config, ensure_ascii=False, indent=2) + "\n")
PY

2. TouchEn nxKey とログイン手段を先に確認する

1. インターネット等記所ログインページをブラウザで直接開く。
2. TouchEn nxKey インストール案内が出たら、インストール後ブラウザまたはPCを再起動する。
3. 公同認証書/簡便認証/アイディログインのうち、ユーザーが選択した方式で直接ログインする。
4. カード決済が可能か確認する。

3. 法人登記部等本ショッピングカート追加

法人登録番号を知っている場合は、精度が高い upstream iros_cart_by_corpnum.py フローを優先する。商号のみある場合は iros_cart.py を使うが、商号変更・特殊文字で失敗する可能性があり、失敗分は法人登録番号で再試行する。

python iros_cart_by_corpnum.py
# または
python iros_cart.py

完了するとブラウザの決済対象リストに移動する。ユーザーはブラウザからページごと10件単位でカード決済を直接完了し、ターミナルには決済完了後 Enter を入力する。

4. 法人決済後の閲覧・保存

決済完了した法人登記部等本は upstream iros_download.py またはウィザードメニューの法人閲覧・保存フローで保存する。

python iros_download.py

保存パスは config.json の save_dir で管理するが、上の例のように $workdir/downloads を使い、公開リポジトリ下のパスを使わない。companies_list が $workdir/companies-input.json を指しているか決済前に確認すると、決済後 iros_download.py が FileNotFoundError で中断することを避けられる。

5. 不動産登記部等本ショッピングカート追加

不動産は住所リスト反復入力とショッピングカート追加までのみ自動化を優先推奨する。

python iros_cart_realty.py

決済、閲覧、ダウンロードはインターネット等記所ウェブUIでユーザーが直接一括決済・一括閲覧出力・一括保存を実行する方が、通常より高速で安全である。必要な場合のみ iros_download_realty.py をレビューする。

6. ウィザード経路

初めて使うユーザーは upstream iros_wizard.py メニューが最も安全である。

python iros_wizard.py

メニューの概要：

• 法人登記部等本 — ショッピングカート追加
• 法人登記部等本 — 決済後閲覧・保存
• 不動産登記部等本 — ショッピングカート追加
• 不動産登記部等本 — 決済後閲覧・保存
• 事業者番号 → 法人情報照会 (excel_path は $workdir/customer-list.xlsx)
• ダウンロード済み法人PDF → 統合レポート Excel 生成 (excel_path と pdf_dir はリポジトリ外パス)

Response policy

• まず「ログインと決済はユーザーが直接」と言う。
• 法人と不動産を区分して、推奨自動化範囲を説明する。
• TouchEn nxKey 事前インストールとブラウザ再起動の可能性を案内する。
• 発行対象リスト、PDF、Excel、レポートには個人情報/機密情報が含まれる可能性があるため、リポジトリ外の非公開フォルダを使うよう促す。
• 法律相談や権利関係解釈に見える表現を避け、登記部等本発行補助とファイル整理までのみ助ける。
• 原著者/参考実装リンクをドキュメントまたは回答に残す：challengekim/iros-registry-automation — https://github.com/challengekim/iros-registry-automation

Verification

ログインなしで可能な検証：

• upstream リポジトリ clone
• pip install -r requirements.txt
• playwright install chromium
• python iros_wizard.py 実行後、メニュー/入力ファイル案内が正常に表示されるか確認

ログインセッションが必要な最終smoke：

1. ユーザーが直接IROSにログインする。
2. テスト用1件をショッピングカートに追加する。
3. ユーザーが直接決済する。
4. 閲覧・保存パスがPDFを保存するか確認する。
5. 成果物パスと個人情報をPR/ログに残さない。

Done when

• 法人/不動産対象タイプと入力形式が区分された。
• ログイン、認証、決済を人が直接処理するという案内が明確である。
• TouchEn nxKey とページごと10件決済制約が案内された。
• 原著者 challengekim と参考実装リンクが含まれた。