MCP — Visual Check

1 endpoints from the published OpenAPI import.

POST/api/v1/mcp/visual-check

Open a URL in a real browser and report what an end-user sees.

Proxies to the visual-check Playwright sidecar. Returns screenshot URL (R2-hosted), final URL, status code, DOM info, console errors, failed requests, and per-assertion results. URL must be on the allowlist (spideriq.ai subdomains + tenant verified domains). 20 req/min/client. 30s default timeout, 60s hard cap.

Try it

Examples

cURL

curl -X POST 'https://spideriq.ai/api/v1/mcp/visual-check' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "page_url": "string",
  "viewport": "desktop",
  "wait_for_text": "string",
  "expected_text": [
    "string"
  ],
  "expected_no_text": [
    "string"
  ],
  "timeout_ms": 30000,
  "tenant_id": "string"
}'

Python

import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/mcp/visual-check",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"page_url": "string", "viewport": "desktop", "wait_for_text": "string", "expected_text": ["string"], "expected_no_text": ["string"], "timeout_ms": 30000, "tenant_id": "string"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/mcp/visual-check", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"page_url": "string", "viewport": "desktop", "wait_for_text": "string", "expected_text": ["string"], "expected_no_text": ["string"], "timeout_ms": 30000, "tenant_id": "string"})
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"page_url": "string", "viewport": "desktop", "wait_for_text": "string", "expected_text": ["string"], "expected_no_text": ["string"], "timeout_ms": 30000, "tenant_id": "string"}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/mcp/visual-check", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error