移民案件状況データ抽出 AI法律ワークフロー用

TL;DR

• 申請者の承認と文書化された法的目的に基づいてのみ、移民ケースのステータスを収集する。
• 受領番号とステータス履歴を機密データとして扱い、暗号化、アクセス制御、短期間の保持期間を設定する。
• 公式アカウントの通知と承認されたAPIまたはエクスポートを優先し、ブラウザ自動化は許可された場合のみ使用する。
• 承認されたステータスページにCAPTCHAが表示された場合は、決定論的なブラウザツールで処理し、AIモデルは資格情報を避ける。
• AIは変更の要約とレビューキューの作成に使用するが、最終的な法的アドバイスや人間の承認なしにフォームの提出は行わない。

イントロダクション

移民ケースのステータスデータの抽出は、法務チーム、モビリティ提供者、申請者の繰り返しチェックを減らすが、同意、プライバシー、および人間の監視を基盤に設計する必要がある。正しいアーキテクチャは、AIエージェントに政府ポータルへの制限なしのアクセスを与えない。代わりに、セキュアなサービスは承認されたケース識別子を受け取り、承認されたチャネルを通じて最小限のステータスデータを取得し、ソースの証拠を記録し、意味のある変更を検出、AIワークフローに構造化されたイベントを送信する。CAPTCHAの処理は、許可されたブラウザセッションの復元ステップに限定され、認証の代替手段であってはならない。このガイドは、ステータスモニタリング、受領番号保護、ページパースング、CapSolverの統合、アラート分類、監査ログ、およびエスカレーションルールの実用的な設計を提示する。

最初に承認された利用ケースを定義する

ケースモニタリングサービスは、狭い質問に答えるべきである。「この承認されたケースのステータスは変化したか？」。これは、関係のない個人を検索したり、保護された特徴を推測したり、短いポータルメッセージから法的結論を導くことはしない。

USCIS Case Status Onlineツールは、3文字のアルファベットと10桁の数字からなる13文字のユニークな受領番号を使用する。これはパスワードではない場合でも、機密運用データとして扱う。USCISのケースステータス案内は、申請者が申請、請願、または要求をチェックする方法を説明している。

収集の前に、以下の条件を満たす必要がある：

• 明示的な申請者またはクライアントの承認；
• 定義された件名またはサービス関係；
• 文書化されたモニタリング頻度；
• 法務スタッフおよびサービスアカウントのアクセス制御；
• 削除日；
• 不明または悪影響のあるアップデートのエスカレーション経路。

CapSolver AIおよび自動化のFAQは、モデルが決定すべきことと、決定論的なツールが実行すべきことを定義する際に役立つ。

最小限のケースステータス記録をモデル化する

ワークフローが必要とするもののみを保存する。有用な記録には、擬似匿名の内部件名ID、保護された受領番号参照、正規化されたステータス、元のステータステキスト、ソース、タイムスタンプが含まれる。

from dataclasses import dataclass
from datetime import datetime, timezone

@dataclass
class ImmigrationCaseStatus:
    matter_id: str
    receipt_number_ref: str
    status_code: str
    status_title: str
    status_message: str
    source_url: str
    checked_at: str
    source_updated_at: str | None = None


def utc_now() -> str:
    return datetime.now(timezone.utc).isoformat()

モデルのプロンプト、ログ、アナリティクスイベント、エラートラッカーにフル受領番号を配置しない。暗号化された値をシークレットサービスに保存し、取得ワーカーに短期間有効な参照のみを送信する。

最も安全な収集チャネルを選択する

公式通知、オンラインアカウントアクセス、および承認されたデータフィードから始める。ブラウザ自動化は最後の構造化オプションであり、デフォルトではない。

公式USCISステータスチェックの手順は、主な運用リファレンスである。タイミングの文脈のために、USCIS処理時間ツールは別個の推定値を提供するが、推定値をケース固有の約束として扱ってはならない。

受領番号をログに残さずに検証する

ブラウザセッションを開始する前にフォーマットを検証する。これは不要なリクエストを減らし、不正な入力をポータルに届けるのを防ぐ。

import re

RECEIPT_PATTERN = re.compile(r"^[A-Z]{3}[0-9]{10}$")


def normalize_receipt_number(value: str) -> str:
    normalized = value.replace("-", "").replace(" ", "").upper()
    if not RECEIPT_PATTERN.fullmatch(normalized):
        raise ValueError("受領番号には3文字のアルファベットと10桁の数字が必要です")
    return normalized

ユーザーに一般的な検証エラーを返す。スタックトレースやサポートチケットでフル受領番号をエコーしない。

決定論的なブラウザ取得ワーカーを作成する

ブラウザワーカーは言語モデルから隔離されるべきである。これは承認された識別子参照を受け取り、暗号化された値を取得し、チェックを行い、サニタイズされた結果を発信する。

from playwright.async_api import Page

CASE_STATUS_URL = "https://egov.uscis.gov/"

async def fetch_status_page(page: Page, receipt_number: str) -> dict:
    await page.goto(CASE_STATUS_URL, wait_until="domcontentloaded")

    # セレクターは現在の承認されたページに対して検証する必要があります。
    await page.get_by_label("Enter a Receipt Number").fill(receipt_number)
    await page.get_by_role("button", name="Check Status").click()
    await page.wait_for_load_state("networkidle")

    title = await page.locator("main h1, main h2").first.inner_text()
    message = await page.locator("main").inner_text()

    return {
        "status_title": title.strip(),
        "status_message": message.strip(),
        "source_url": page.url,
    }

セレクターとページの動作は変更される可能性がある。許可されたステージングまたは制御されたワークフローでテストし、パーサーの失敗を監視し、予期しないレイアウトはモデルに推測させるのではなく、人間のレビューにルーティングする。

CapSolver Pythonウェブスクレイピングガイドは、堅牢なブラウザとパースングの実践をカバーし、CapSolverウェブスクレイピングFAQは一般的な自動化信頼性の質問に答えている。

CAPTCHAチャレンジを制御された復元ステップとして扱う

承認されたブラウザセッションがサポートされるCAPTCHAを提示した場合、ユーザー提供のAIエージェントドキュメントに記載されているCapSolver Coreブラウザメソッドを使用する。モデルは受領番号、ブラウザクッキー、またはCapSolverキーを受け取らない。

import os
from capsolver_core import Capsolver

cap = Capsolver(
    api_key=os.environ["CAPSOLVER_API_KEY"],
    default_timeout=180,
)

async def resolve_supported_challenge(page: Page) -> dict:
    detected = await cap.detect(page)
    if not detected:
        return {"handled": False, "reason": "サポートされるチャレンジが検出されませんでした"}

    solution = await cap.solve_on_page(page)
    return {
        "handled": True,
        "solution": solution,
    }

リトライを制限する。安全なワーカーはステータス検索を試み、必要に応じて一度チャレンジハンドラーを呼び出し、元のアクションを再試行する。チャレンジが繰り返された場合、オペレーターのレビューを要求する。

async def authorized_status_check(page: Page, receipt_number: str) -> dict:
    try:
        return await fetch_status_page(page, receipt_number)
    except Exception as first_error:
        recovery = await resolve_supported_challenge(page)
        if not recovery["handled"]:
            raise first_error
        return await fetch_status_page(page, receipt_number)

CapSolver CAPTCHA解決FAQはサポートされるチャレンジワークフローを説明している。トラブルシューティングには、CapSolverエラーFAQを使用する。

ボーナスコード: CapSolverダッシュボードでコード WEBS を使用すると、すべての充電で追加の5%のボーナスが得られます。

ステータステキストを正規化するが、法的意味を発明しない

ポータルメッセージは申請者向けに書かれており、機械分類のためではない。完全なソーステキストを保持し、高レベルのワークフローカテゴリのみをマップする。

STATUS_RULES = {
    "case was received": "received",
    "case is being actively reviewed": "under_review",
    "request for evidence": "evidence_requested",
    "case was approved": "approved",
    "card was produced": "document_produced",
    "case was denied": "adverse_decision",
}


def classify_status(title: str, message: str) -> dict:
    combined = f"{title} {message}".lower()
    for phrase, code in STATUS_RULES.items():
        if phrase in combined:
            return {"status_code": code, "confidence": "rule_match"}
    return {"status_code": "unclassified", "confidence": "needs_review"}

ルールはワークフローアクションをトリガーするものであり、法的結論ではない。たとえば、evidence_requestedはレビュータスクを作成するが、専門家のみが要求を解釈し、申請者にアドバイスを提供する。

変更を検出し、重複アラートを回避する

正規化されたフィールドとソースメッセージのハッシュを比較する。ステータスコードまたは実質的なテキストが変更された場合のみアラートを送信する。

import hashlib


def status_fingerprint(status: dict) -> str:
    canonical = "|".join([
        status.get("status_code", ""),
        status.get("status_title", "").strip(),
        status.get("status_message", "").strip(),
    ])
    return hashlib.sha256(canonical.encode("utf-8")).hexdigest()


def has_changed(previous: dict | None, current: dict) -> bool:
    if previous is None:
        return True
    return status_fingerprint(previous) != status_fingerprint(current)

一定のポーリングではなく、リスクベースのスケジュールを使用する。多くのワークフローは毎日または毎週のチェックで十分であり、1分ごとのリクエストは必要ない。ポータルの制限を尊重し、インシデントや予期しないチャレンジの増加時にジョブを一時停止する。

構造化されたイベントをAI法的ワークフローにルーティングする

AIエージェントは安全に要約できる赤字イベントオブジェクトを受け取るべきである。

SAFE_EVENT = {
    "matter_id": "MAT-2026-00172",
    "previous_status": "under_review",
    "current_status": "evidence_requested",
    "change_detected_at": "2026-08-25T08:15:00Z",
    "source": "official_case_status_portal",
    "recommended_action": "create_human_review_task",
}

適切なシステム指示は、「検出された変更を要約し、ソースタイムスタンプを引用し、レビューチェックリストを作成してください。承認なしに政府または申請者と連絡を取る、または結果を予測しないでください。」

エージェントアーキテクチャのアイデアについては、CapSolver AIブログとCapSolver自動化リソースを参照してください。

プライバシー、セキュリティ、法的コントロール

移民の件は非常に機密性の高い個人情報が含まれる可能性がある。転送中および静止時の暗号化、最小権限アクセス、スタッフ認証、テナント隔離、監査ログ、削除スケジュール、インシデント対応を適用する。実装前にUSCISウェブサイトポリシーとポータルのプライバシーノーティスを確認する。

サービスを許可していない人々のステータスを収集しない。確認された記録と承認された目的を超えて、国籍、健康、宗教、家族状況、雇用資格を推測しない。受領番号やケース履歴で一般モデルをトレーニングしない。管轄区固有の法的およびプライバシー要件については、専門の弁護士に相談する。

操作チェックリスト

結論

移民ケースのステータスデータ抽出は、自律的な法的意思決定者ではなく、セキュアな証拠サービスとして構築されるべきである。受領番号を保護し、公式チャネルを優先し、ブラウザ実行を隔離し、ソーステキストを保持し、AIエージェントに赤字変更イベントのみを送信する。許可されたブラウザセッションがサポートされるCAPTCHAに遭遇した場合、CapSolverは制御された復元ステップを提供し、システム全体は認証、プライバシー、監査可能性を維持する。

制限付きテスト環境でCapSolverを開始し、実際のケースをモニタリングする前にプライバシー、セキュリティ、利用規約、法的レビューを完了する。

FAQ

オンラインで見つかった任意のUSCIS受領番号をモニタリングできますか？

いいえ。申請者または承認されたクライアントが許可し、組織が文書化された法的目的を持っているケースのみをモニタリングしてください。

すべての移民ケースステータスに公式公開APIがありますか？

機関やプログラムによって異なります。公式アカウント通知、承認された統合、またはユーザー提供の記録を優先してください。ウェブページが自動収集を許可していると仮定しないでください。

受領番号をAIモデルに送信する必要がありますか？

いいえ。フル識別子は保護された取得サービス内に保ち、モデルに擬似匿名の件名IDと赤字ステータスイベントを送信してください。

CAPTCHAが繰り返された場合どうなりますか？

制限付き復元試行後に停止し、人間のレビューを要求してください。繰り返されるチャレンジは、セッション、レート、ポリシー、または技術的な問題を示す可能性があり、自動化は無視しないでください。

AIエージェントが申請者のケースステータスアップデートを解釈できますか？

公式テキストを要約し、レビュータスクを作成することはできますが、法的解釈、期限、応答、および申請者とのコミュニケーションは、資格のある専門家によって処理または承認されるべきです。