Skip to content

README.md

Latest commit

 

History

History
84 lines (58 loc) · 2.96 KB

README.md

File metadata and controls

84 lines (58 loc) · 2.96 KB

Visualping API Skill for Claude

A Claude skill that lets you interact with the Visualping API directly from Claude — create monitors, list jobs, check change history, and more.

What it does

  • Generate code snippets (curl, Python, JavaScript) for any Visualping API call
  • Execute API calls directly when running in an environment with terminal access
  • Automatically resolves your workspace ID
  • Uses sensible defaults so you can create monitors with minimal configuration

Installation

Option 1: Download the .skill file

  1. Download visualping-api.skill from the Releases page
  2. In Claude, go to Settings → Skills
  3. Upload the .skill file

Option 2: Clone this repo

  1. Clone the repository: 
    git clone https://github.com/webmonitoring/visualping-api-skill.git
  2. Point Claude at the skill folder in your project settings

Prerequisites

You'll need a Visualping API key. Get one from your Developer settings (up to 5 active keys).

Usage examples

Once installed, just talk to Claude naturally:

  • "Monitor https://example.com for changes"
  • "List all my active monitors"
  • "Show me the change history for job 12345"
  • "Pause my monitor on google.com"
  • "Set up a Slack notification for my monitor"
  • "Create a monitor that checks every hour"

Claude will ask for your API key if you haven't provided one, then either generate a code snippet or execute the call directly — your choice.

API coverage

Action Endpoint
Authenticate POST /v2/token
Get account info GET /describe-user
List jobs GET /v2/jobs
Create job POST /v2/jobs
Get job details & history GET /v2/jobs/{jobId}
Update job PUT /v2/jobs/{jobId}
Delete job DELETE /v2/jobs/{jobId}

Direct execution

The skill can execute API calls directly (instead of just generating snippets) when Claude has terminal access. This works out of the box in Claude Code and Cowork.

In Claude.ai with an organization account, your org owner needs to add these domains to the network allowlist:

  • account.api.visualping.io
  • job.api.visualping.io
  • api.visualping.io

Without these domains, the skill still works — it generates ready-to-run code snippets you can copy and execute in your own environment.

Defaults

When creating a monitor, the skill uses these defaults unless you specify otherwise:

Setting Default Notes
Check frequency Daily (1440 min) Common: 5m, 15m, 30m, 1h, 6h, 12h, 1d, 1w
Mode ALL Legacy options: VISUAL, WEB, TEXT
Trigger sensitivity 1 Most users don't need to change this
Active true Starts monitoring immediately

Support