A headless command-line skill that checks USCIS case status by receipt number using Selenium and undetected-chromedriver.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install uscis-case-status
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install uscis-case-status using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is USCIS Case Status?
USCIS Case Status is an Openclaw Skills command-line utility for retrieving the latest status of a USCIS immigration case by receipt number. It is designed for fast, scriptable lookups from the terminal and works by automating the USCIS website with Selenium, undetected-chromedriver, and a virtual display.
This skill is best suited for agents, scripts, and developer workflows that need reliable case-status checks without manual browser interaction. Openclaw Skills makes it easy to integrate USCIS status monitoring into automated routines while keeping the workflow simple: pass a receipt number, get the current status, and handle failures cleanly with timeouts.
USCIS Case Status Use Cases
- Check the latest USCIS status for a receipt number from the terminal.
- Automate case-status lookups inside scripts, bots, or agent workflows.
- Validate receipt-number formats before making a USCIS request.
- Run headless status checks on servers or CI-style environments with Xvfb.
- Add timeout-protected USCIS polling to long-running automation workflows.
- Support common receipt prefixes such as IOC, NSC, IOE, and SRC.
How USCIS Case Status Works
- Install the Python package and ensure the required browser dependencies are available on the system.
- Launch the command with a USCIS receipt number, for example
python3 -m uscis_case_status IOE123456789. - The skill starts a headless browser session using Xvfb and undetected-chromedriver.
- It opens the USCIS case-status page, submits the receipt number, and waits for the result.
- The response is parsed into a simple output containing the case number, last update date, and current status message.
- If the receipt number is invalid or the site is unavailable, the command exits with an error so callers can handle retries or failures.
- For automation, wrap the command in
timeoutand add delays between requests to avoid USCIS rate limits.
USCIS Case Status Setup
- Install Python 3 and ensure the host can run Chromium in headless mode.
- Install the skill package:
pip install uscis-case-status
- Install the required browser runtime. The skill expects
chromium-browserto be available, typically via snap on supported systems. - Verify the command works with a known receipt number:
python3 -m uscis_case_status IOE123456789
- For scripted use, protect calls with a timeout and avoid aggressive polling:
timeout 60 python3 -m uscis_case_status SRC2690181234
If running in a non-interactive environment, make sure Xvfb and display-related dependencies are supported by the host.
Confirm the receipt number format is valid and case-insensitive before invoking Openclaw Skills in automation.
USCIS Case Status Data Schema & Taxonomy
Openclaw Skills for USCIS Case Status does not generate a persistent local database; instead, it returns a standardized terminal response for each lookup.
Input schema
| Field | Type | Description |
|---|---|---|
CASE_NUMBER |
string | USCIS receipt number passed on the command line |
Supported receipt patterns
IOCXXXXXXXXNSCXXXXXXXIOEXXXXXXXSRC2690181234
Output schema
| Field | Type | Description |
|---|---|---|
Case |
string | Normalized receipt number used in the lookup |
Date |
string | Last update date returned by USCIS |
Status |
string | Current USCIS case status message |
Validation and error taxonomy
- Receipt numbers are case-insensitive.
- Invalid identifiers return:
Error: Please make sure your case id is valid. - Slow or unavailable USCIS responses may hang unless the caller enforces a timeout.
- Frequent polling may trigger rate limiting, so scripts should space requests by several minutes.
Runtime dependencies
python3chromium-browser- Xvfb / virtual display support
- Selenium + undetected-chromedriver
USCIS Case Status Advanced Features
- Headless browser execution with Xvfb for non-GUI environments.
- Stealth automation via undetected-chromedriver to reduce detection issues.
- Simple CLI-first design that fits agent pipelines and shell scripts.
- Timeout-friendly invocation patterns for robust automation.
- Case-insensitive receipt handling for easier user input normalization.
- Works well as a lightweight Openclaw Skills building block for status-check workflows.
SKILL.md
Loading
Related Openclaw Skills
DHX Electronic Components Sourcing Agent
Openclaw Skills for DHX Tech turns BOMs, part numbers, and sourcing requests into real-time inventory checks, cross-references, and procurement-ready recommendations.
WeChat Mini Program Development Tool (Free)
Openclaw Skills for WeChat mini program development helps personal developers enforce structure, avoid common pitfalls, and optimize performance.
Minimalist Design System Free Edition
Openclaw Skills for the Minimalist Design System Free Edition helps developers inject a clean, modern design system into frontend projects with reusable tokens, components, and responsive rules.
Relux Works — AI-Native Development Studio Inquiry Skill
Openclaw Skills for discovering Relux Works services, reviewing fixed-price software packages, and submitting a consent-based project inquiry.
OpenClaw Deal Scout
Openclaw Deal Scout automates Gmail deal triage, CRM logging, alerts, and approved replies through a local MCP gateway.
Project Delivery Engine
Project Delivery Engine helps AI agents reliably manage long-running projects with persistent state, structured handoffs, and independent review.
Featured*
