← Back to Skills Marketplace
92
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install healthprobe
Description
Probe any URL and check if it's up. Returns the HTTP status code, response latency in milliseconds, and a healthy/not-healthy verdict. Configurable timeout....
README (SKILL.md)
HealthProbe
Check if a URL is up before you call it.
Start the server
uvicorn healthprobe.app:app --port 8009
Probe a URL
curl -s -X POST http://localhost:8009/v1/probe \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}' | jq
Returns healthy (true if 2xx), status_code (HTTP code or -1 on error), latency_ms, and error (if connection failed).
With custom timeout
curl -s -X POST http://localhost:8009/v1/probe \
-H "Content-Type: application/json" \
-d '{"url": "https://slow-api.example.com", "timeout_ms": 1000}' | jq '.healthy'
Timeout range: 100ms to 30,000ms (default: 5,000ms).
Usage Guidance
This skill appears to do exactly what it says: run a local HTTP service that probes arbitrary URLs. Before installing, consider: (1) SSRF risk — the skill will perform outbound requests to any URL you pass it, including internal IPs or cloud metadata endpoints; run it in an isolated environment or restrict egress if you don't want internal scanning. (2) Supply-chain caution — pip packages are not version-pinned; consider pinning or auditing dependencies before installation. (3) Operational limits — the server listens on a port (example uses 8009); ensure it is firewall-protected if you run it on a shared host. If you plan to allow autonomous agent use of this skill, restrict or validate target URLs to avoid unintended network probing.
Capability Analysis
Type: OpenClaw Skill
Name: healthprobe
Version: 1.0.0
The skill provides a FastAPI-based service to probe arbitrary URLs, which introduces a Server-Side Request Forgery (SSRF) risk as it lacks restrictions on internal IP ranges or local endpoints. While this network access is plausibly needed for the stated purpose in SKILL.md, the implementation in healthprobe/app.py and healthprobe/models.py allows an agent to interact with potentially sensitive internal infrastructure. No evidence of intentional malice, data exfiltration, or obfuscation was found.
Capability Assessment
Purpose & Capability
Name/description, declared binaries (python), declared dependencies (fastapi, uvicorn, pydantic, httpx), and code implementing /v1/probe all align with a URL health-checking service.
Instruction Scope
SKILL.md instructs running a local FastAPI server and POSTing arbitrary URLs to /v1/probe — this is consistent with purpose. However, the ability to request any URL means the skill can be used to reach internal services (SSRF/internal network scanning) or cloud metadata endpoints if not sandboxed; the README does not include any allowlist/denylist or additional safeguards.
Install Mechanism
Install spec uses PyPI packages (fastapi, uvicorn, pydantic, httpx), which is expected. Risk: packages are not version-pinned in the manifest, creating a supply-chain risk if you want to lock reproducible installs.
Credentials
The skill requires no environment variables, no credentials, and no config paths — this is proportionate to a network probe service.
Persistence & Privilege
The skill is not forced-always, does not request elevated persistence, and does not modify other skills or system-wide configs. It runs a local server when started, which is expected for this design.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install healthprobe - After installation, invoke the skill by name or use
/healthprobe - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Improved and clarified the skill description for easier understanding.
- Enhanced usage instructions with simplified curl examples and output details.
- Explicitly documented the supported timeout range (100ms–30,000ms).
- Added an emoji and reorganized metadata for better at-a-glance identification.
- Streamlined documentation structure for quicker onboarding.
v0.1.1
- Added metadata for installation requirements and Openclaw compatibility.
- Included pydantic in dependencies and installation instructions.
- Updated installation and usage instructions for clarity.
- Minor formatting and structure improvements in documentation.
v0.1.0
Initial release of healthprobe.
- Provides an API to probe any URL for health, HTTP status code, and response latency.
- Supports on-demand checks for service availability, with optional custom timeout.
- Returns JSON with detailed probe results, including error messages if unreachable.
- Available as both a hosted API and a standalone FastAPI service.
Metadata
Frequently Asked Questions
What is Healthprobe?
Probe any URL and check if it's up. Returns the HTTP status code, response latency in milliseconds, and a healthy/not-healthy verdict. Configurable timeout.... It is an AI Agent Skill for Claude Code / OpenClaw, with 92 downloads so far.
How do I install Healthprobe?
Run "/install healthprobe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Healthprobe free?
Yes, Healthprobe is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Healthprobe support?
Healthprobe is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Healthprobe?
It is built and maintained by mirni (@mirni); the current version is v1.0.0.
More Skills