CEAC Visa Status Checker (Zhipu Captcha)

This skill checks U.S. visa application status from CEAC and uses Zhipu vision model to read captcha.

Required User Fields

• LOCATION: visa application location text in CEAC (example: CHINA, BEIJING)
• NUMBER: Application ID or Case Number (example: AA0020AKAX)
• PASSPORT_NUMBER: passport number
• SURNAME: first letters of surname as used in CEAC
• ZHIPU_API_KEY: API key for captcha OCR

Optional:

• ZHIPU_MODEL_VISION (default: glm-4v-flash)
• MAX_RETRIES (default: 5)
• RETRY_DELAY_SECONDS (default: 5)

Location help:

• See references/LOCATION.md

Workflow

1. Ensure dependencies are installed from requirements.txt.
2. Create .env based on .env.example.txt.
3. Run scripts/check_ceac_status.py.
4. Return JSON output to user.

Commands

Install:

python -m pip install -r requirements.txt

Run:

python scripts/check_ceac_status.py

Output Contract

On success:

• success: true
• status: CEAC status text
• case_last_updated: CEAC last updated date
• description: CEAC message
• application_num: returned case number

On failure:

• success: false
• error/message/last_error

Notes

• Captcha recognition may fail occasionally. The script retries automatically.
• LOCATION must match CEAC location dropdown text. Fuzzy match is attempted.
• Keep API keys in environment variables. Avoid hardcoding secrets in scripts.