DiffiCat
Compare a website before and after a migration: missing pages, content changes, visual diffs.
我該用這個嗎
品質與安全性
發現項目(2)
- HIGH
- MEDIUM在 capture_screenshot 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"difficat": {
"url": "https://app.difficat.com/mcp"
}
}
}遠端端點
https://app.difficat.com/mcpstreamable-http它能做什麼
工具清單
工具(6)
🟢check_page(url, baseline, rebaseline, viewportWidth, checkMode, ...)
Use when you deployed or edited a page and need to catch visual regressions and content changes: it compares the live URL with a baseline captured on the first call, a snapshot or a production URL, and answers the regressions. Free up to 100 pages per client address per day, no key needed.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "The live page to check (full URL)."
},
"baseline": {
"description": "What to compare against: a saved snapshot ({ snapshotId, shareToken? }) or a production origin ({ productionUrl }). Omit it to use the baseline the first call captured.",
"anyOf": [
{
"type": "object",
"properties": {
"snapshotId": {
"type": "string",
"pattern": "^snap-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The snapshot id, snap-<uuid>, from the web app or a snapshot listing."
},
"shareToken": {
"description": "A share token (dcs_…) the snapshot’s owner issued for agents. Needed unless the account key on the request’s HTTP headers owns or was granted the snapshot.",
"type": "string",
"minLength": 20,
"maxLength": 200
}
},
"required": [
"snapshotId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"productionUrl": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "A production origin: the page at the same path and query there is Site A."
}
},
"required": [
"productionUrl"
],
"additionalProperties": false
}
]
},
"rebaseline": {
"description": "Capture a new baseline now instead of comparing with the stored one.",
"type": "boolean"
},
"viewportWidth": {
"description": "Capture width in px (default 1440).",
"type": "integer",
"minimum": 320,
"maximum": 2560
},
"checkMode": {
"description": "full (existence, content and visual, the default), text-only (no screenshots) or existence-only.",
"type": "string",
"enum": [
"full",
"text-only",
"existence-only"
]
},
"maxPriceUsd": {
"description": "Spend cap in USD: a job priced above it is refused before any challenge.",
"type": "number",
"exclusiveMinimum": 0
},
"idempotencyKey": {
"description": "Retry key: under a prepaid balance, the same value within 24 hours is not charged again and answers DUPLICATE_REQUEST with the first jobId.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"code": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
},
"pagesChecked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pagesCharged": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"regressions": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"jobId": {
"type": "string"
},
"jobToken": {
"type": "string"
},
"payment": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "prepaid"
},
"balance": {
"type": "string"
}
},
"required": [
"amount",
"currency",
"rail",
"balance"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "subscription"
},
"pagesFromAllowance": {
"type": "number"
},
"allowanceRemaining": {
"type": "number"
}
},
"required": [
"amount",
"currency",
"rail",
"pagesFromAllowance",
"allowanceRemaining"
],
"additionalProperties": false
}
]
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
},
"sample": {
"type": "boolean"
},
"allowanceRemaining": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"url": {
"type": "string"
},
"httpStatus": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"baseline": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"created",
"stored",
"snapshot",
"production",
"none"
]
},
"snapshotId": {
"type": "string"
},
"takenAt": {
"type": "string"
}
},
"required": [
"kind"
],
"additionalProperties": false
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡diff_deploy(previewUrl, productionUrl, paths, maxPages, viewportWidth, ...)
Use when a staging or preview deploy should match production, or a migrated site its old one: it compares the pages of both origins and answers only the pages that are missing, changed or look different. Free up to 100 pages per client address per day, no key needed.
輸入結構描述
{
"type": "object",
"properties": {
"previewUrl": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "The preview or staging site (full URL), compared as Site B."
},
"productionUrl": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "The production site (full URL), compared as Site A."
},
"paths": {
"description": "Pages to compare, each starting with /; skips discovery.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"pattern": "^\\/(?![/\\\\])"
}
},
"maxPages": {
"description": "Without paths: pages discovery compares, default 10.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"viewportWidth": {
"description": "Capture width in px.",
"type": "integer",
"minimum": 320,
"maximum": 2560
},
"checkMode": {
"description": "full (existence, content and visual, the default), text-only (no screenshots) or existence-only.",
"type": "string",
"enum": [
"full",
"text-only",
"existence-only"
]
},
"threshold": {
"description": "Visual diff tolerance as a fraction from 0 (exact) to 1: 0.05 means 5%. The web app takes a percentage; the API does not.",
"type": "number",
"minimum": 0,
"maximum": 1
},
"maxPriceUsd": {
"description": "Spend cap in USD: a job priced above it is refused before any challenge.",
"type": "number",
"exclusiveMinimum": 0
},
"idempotencyKey": {
"description": "Retry key: under a prepaid balance, the same value within 24 hours is not charged again and answers DUPLICATE_REQUEST with the first jobId.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"previewUrl",
"productionUrl"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"code": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
},
"pagesChecked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pagesCharged": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"regressions": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"jobId": {
"type": "string"
},
"jobToken": {
"type": "string"
},
"payment": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "prepaid"
},
"balance": {
"type": "string"
}
},
"required": [
"amount",
"currency",
"rail",
"balance"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "subscription"
},
"pagesFromAllowance": {
"type": "number"
},
"allowanceRemaining": {
"type": "number"
}
},
"required": [
"amount",
"currency",
"rail",
"pagesFromAllowance",
"allowanceRemaining"
],
"additionalProperties": false
}
]
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
},
"sample": {
"type": "boolean"
},
"allowanceRemaining": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"regressionCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢wait_for_comparison(jobId, jobToken, timeoutSeconds)
Waits until the job is completed, failed or cancelled, or timeoutSeconds pass, then answers status, progress and, once terminal, the summary (passed, failed, issuesBySeverity). On "running", call it again. Free.
輸入結構描述
{
"type": "object",
"properties": {
"jobId": {
"type": "string",
"pattern": "^(?:web|cmp)-[a-z0-9-]+$",
"description": "Returned at job creation, e.g. web-1a2b3c."
},
"jobToken": {
"description": "Returned at job creation; optional when the HTTP headers carry the key that paid the job.",
"type": "string",
"minLength": 20,
"maxLength": 200
},
"timeoutSeconds": {
"description": "Seconds to wait for a terminal status before answering with the current one (default 60, at most 300).",
"type": "integer",
"minimum": 1,
"maximum": 300
}
},
"required": [
"jobId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"code": {
"type": "string"
},
"jobId": {
"type": "string"
},
"status": {
"type": "string"
},
"progress": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"pagesReturned": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_report(jobId, jobToken, offset, limit, failedOnly, ...)
The finished report. Call it first with failedOnly: true and view: "digest": only the failed pages, each with its issues, diff percentage and largest regions, and a text line per page; summary covers every page. check_page and diff_deploy return the first regressed region's image; get_screenshot (?surface=full) fetches a region by filename. Without view, results are { path, status, failedChecks }; responseFormat: "detailed" returns per-check fields. offset and limit page through results (default 50, at most 5000; nextOffset is next); limit: 1 returns the summary alone; includeText: true adds the plain-text report. A change whose flakyShare is at least 0.5 is likely the page moving on its own: mask its fingerprint's element (visual.masks), not a regression. Call wait_for_comparison first. Free.
輸入結構描述
{
"type": "object",
"properties": {
"jobId": {
"type": "string",
"pattern": "^(?:web|cmp)-[a-z0-9-]+$",
"description": "Returned at job creation, e.g. web-1a2b3c."
},
"jobToken": {
"description": "Returned at job creation; optional when the HTTP headers carry the key that paid the job.",
"type": "string",
"minLength": 20,
"maxLength": 200
},
"offset": {
"description": "Index of the first page result to return (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Page results to return (at most 5000; default 1000 on REST, 50 over MCP).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"failedOnly": {
"description": "Only failed pages in results, total, nextOffset and text; summary still covers every page.",
"type": "boolean"
},
"view": {
"description": "full (default): every page result with its diffs, screenshots and text; digest: one small object per page (status, failed checks, issues, diff percentage), no text.",
"type": "string",
"enum": [
"full",
"digest"
]
},
"responseFormat": {
"description": "concise (default): each result is { path, status, failedChecks }, plus snapshots when a side came from one; detailed: every per-check field, diff and screenshot name.",
"type": "string",
"enum": [
"concise",
"detailed"
]
},
"includeText": {
"description": "Also put the text block in structuredContent.text.",
"type": "boolean"
}
},
"required": [
"jobId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": [
"string",
"null"
]
},
"code": {
"type": "string"
},
"jobId": {
"type": "string"
},
"status": {
"type": "string"
},
"cancelled": {
"type": "boolean"
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"results": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"path": {
"type": "string"
},
"status": {
"type": "string"
},
"failedChecks": {
"type": "array",
"items": {
"type": "string"
}
},
"snapshots": {
"type": "object",
"properties": {
"a": {
"type": "object",
"properties": {
"snapshotId": {
"type": "string"
},
"n": {
"type": "number"
}
},
"required": [
"snapshotId",
"n"
],
"additionalProperties": false
},
"b": {
"type": "object",
"properties": {
"snapshotId": {
"type": "string"
},
"n": {
"type": "number"
}
},
"required": [
"snapshotId",
"n"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"path",
"status",
"failedChecks"
],
"additionalProperties": false
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
}
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"nextOffset": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"text": {
"type": "string"
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢capture_screenshot(url, auth, viewportWidth, visual, idempotencyKey)
Takes a full-page screenshot of one URL, for example to see how a relaunched page or a mobile layout looks. Free 10 times per client address per day, no key needed. The PNG is taken at the given viewport width and returned inline when small, else as links.file to fetch with the jobToken. Call it for a one-off look at a page or a mobile-width check. Do not call it for pages a comparison job covers: the job already stored their screenshots. Example: { "url": "https://new.example/pricing", "viewportWidth": 375 }. Answers with jobId, jobToken, filename, url, dimensions, bytes, links.file and, on a free run, sample and allowanceRemaining.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Page to capture (full URL)."
},
"auth": {
"description": "HTTP basic auth for the page.",
"type": "object",
"properties": {
"username": {
"type": "string",
"maxLength": 512,
"description": "Username for HTTP basic auth."
},
"password": {
"type": "string",
"maxLength": 512,
"description": "Password for HTTP basic auth."
}
},
"required": [
"username",
"password"
]
},
"viewportWidth": {
"description": "Capture width in px.",
"type": "integer",
"minimum": 320,
"maximum": 2560
},
"visual": {
"description": "Capture rules applied to both sides.",
"type": "object",
"properties": {
"masks": {
"description": "CSS selectors of elements hidden on both sites before the screenshot (at most 50, each up to 200 characters). The layout keeps its place.",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"freeze": {
"description": "Switches that stop motion before the screenshot.",
"type": "object",
"properties": {
"animations": {
"description": "Stop CSS animations and transitions before the screenshot.",
"type": "boolean"
},
"clock": {
"description": "Pause timers and the clock after load; a page that needs a timer to render may stay empty.",
"type": "boolean"
},
"clockSeconds": {
"description": "With clock: seconds the clock runs after load before it stops (1 to 600, default 60).",
"type": "integer",
"minimum": 1,
"maximum": 600
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"idempotencyKey": {
"description": "Retry key: under a prepaid balance, the same value within 24 hours is not charged again and answers DUPLICATE_REQUEST with the first jobId.",
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"code": {
"type": "string"
},
"jobId": {
"type": "string"
},
"filename": {
"type": "string"
},
"jobToken": {
"type": "string"
},
"url": {
"type": "string"
},
"dimensions": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"bytes": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"links": {
"type": "object",
"properties": {
"file": {
"type": "string"
}
},
"required": [
"file"
],
"additionalProperties": false
},
"region": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"y": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"width": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"height": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"x",
"y",
"width",
"height"
],
"additionalProperties": false
},
"imageSize": {
"type": "object",
"properties": {
"width": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"height": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
"payment": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "prepaid"
},
"balance": {
"type": "string"
}
},
"required": [
"amount",
"currency",
"rail",
"balance"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"rail": {
"type": "string",
"const": "subscription"
},
"pagesFromAllowance": {
"type": "number"
},
"allowanceRemaining": {
"type": "number"
}
},
"required": [
"amount",
"currency",
"rail",
"pagesFromAllowance",
"allowanceRemaining"
],
"additionalProperties": false
}
]
},
"pagesCharged": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"followUps": {
"type": "array",
"items": {
"type": "string"
}
},
"sample": {
"type": "boolean"
},
"allowanceRemaining": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_balance
The prepaid balance and last 20 ledger entries of the key in the request’s Authorization: Bearer or X-DiffiCat-Key header; a human obtains one on the account page (/account), which a refusal’s nextSteps name. A Pro key also returns allowance (included pages shared with the web app, used, reset time) and overage (amount this period, cap). Each entry names its surface, web or api. Without a key, answers the free allowance left for your address and prices, the USD a call costs beyond it; comparisons, discoveries and screenshots on old.difficat.com and new.difficat.com draw on demoPages first. Free.
輸入結構描述
{
"type": "object",
"properties": {}
}輸出結構描述
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"code": {
"type": "string"
},
"free": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Per kind: remaining, total and resetsAt, the time the kind renews"
},
"prices": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "USD per compared page (perPageTier2Usd past tierPages), discovery and screenshot"
},
"nextSteps": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"keyId": {
"type": "string"
},
"balance": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"allowance": {
"type": "object",
"properties": {
"includedPages": {
"type": "number"
},
"pagesUsed": {
"type": "number"
},
"resetsAt": {
"type": "string"
}
},
"required": [
"includedPages",
"pagesUsed",
"resetsAt"
],
"additionalProperties": false
},
"overage": {
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"capUsd": {
"type": "string"
}
},
"required": [
"amount",
"capUsd"
],
"additionalProperties": false
},
"recent": {
"type": "array",
"items": {
"type": "object",
"properties": {
"at": {
"type": "string"
},
"type": {
"type": "string"
},
"amount": {
"type": "string"
},
"kind": {
"type": "string"
},
"jobId": {
"type": "string"
},
"surface": {
"type": "string",
"enum": [
"web",
"api"
]
}
},
"required": [
"at",
"type",
"amount"
],
"additionalProperties": false
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據