net.shotbot/shotbot-mcp
NPM · SHOTBOT-MCP · SCANNED AUG 3
Screenshot API for AI agents: capture any public URL as JPEG, PNG, WebP, AVIF, or PDF.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
- Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 61 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability59
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2340 tokens (~585/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · shotbot-mcp
claude mcp add net-shotbot-shotbot-mcp -- npx -y shotbot-mcp
codex mcp add net-shotbot-shotbot-mcp -- npx -y shotbot-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"net-shotbot-shotbot-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"shotbot-mcp"
],
"enabled": true
}
}
} openclaw mcp add net-shotbot-shotbot-mcp --command npx --arg -y --arg shotbot-mcp
mcp_servers:
net-shotbot-shotbot-mcp:
command: "npx"
args: ["-y", "shotbot-mcp"] {
"mcpServers": {
"net-shotbot-shotbot-mcp": {
"command": "npx",
"args": [
"-y",
"shotbot-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +45
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: unverified functional
- Licence: MIT functional
- 31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Jul 26 35
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
account_status ~35
Get the current account status: plan (free | pro), credit balance, monthly quota usage, and number of captures currently in flight.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
batch ~805
Submit up to 500 URLs (Pro: 5000) in a single atomic request. Each job gets its own token. Quota is deducted atomically; partial batches never happen. Returns a list of {url, token, status, job_id} for each job. Jobs are private by default (retrieve via the download URL from get_status); pass cdn=true (batch-level or per job) for permanent public CDN URLs. Add a callback_url to receive each result as it completes instead of polling.
| Name | Type | Req | Description |
|---|---|---|---|
| autoplay_videos | boolean | — | Default autoplay_videos for all jobs. Launches Chromium with --autoplay-policy=no-user-gesture-required so unmuted <video autoplay> elements start playing. Pro only. |
| block_ads | boolean | — | Block ads/trackers for all jobs. Pro only. |
| callback_secret | string | — | Shared secret echoed in each callback payload. |
| callback_url | string | — | HTTPS URL to POST each result to as they complete. |
| cdn | boolean | — | Publish all jobs to the public CDN. Default: private (per-job cdn overrides this). |
| color_scheme | string | — | Default color_scheme for all jobs. |
| crop_height | integer | — | Default custom height in px for all jobs. Pro only. |
| dismiss_cookies | string | — | Default cookie-banner handling for all jobs. Pro only. |
| emulate_print_media | boolean | — | Default emulate_print_media for all jobs. Applies the page's print stylesheet. Pro only. |
| format | string | — | Default format for all jobs. |
| frame | string | — | Default frame for all jobs (rounded, shadow, browser_chrome, browser_chrome_dark, mobile, mobile_light, tablet, tablet_light, laptop, polaroid, gradient, shotbot_brand). |
| fullpage | boolean | — | Default fullpage for all jobs. |
| hidpi | boolean | — | Render at 2× DPR for all jobs. |
| idempotency_key | string | — | Optional client-supplied key (16-128 chars alphanumeric / - _ .). If the same key is replayed within 24h, the server returns the original response without creating new jobs or deducting quota — safe… |
| jobs | array | yes | Array of capture jobs. Each item must have a `url`. Other options override global defaults. |
| nojs | boolean | — | Disable JavaScript for all jobs. |
| omit_background | boolean | — | Default omit_background for all jobs. Transparent viewport backdrop on PNG/WebP/AVIF. Pro only. |
| output_size | integer | — | Default output size for all jobs. |
| prefers_reduced_motion | boolean | — | Default prefers_reduced_motion for all jobs. Emulates prefers-reduced-motion: reduce so well-built sites skip animations. |
| preset | string | — | Default preset for all jobs (og, mobile, square, etc). |
| ratio | string | — | Default crop ratio for all jobs (e.g. "16:9"). |
| render_region | string | — | Default render region for all jobs. fr-paris free, others Pro. |
| scroll_before_capture | boolean | — | Scroll to trigger lazy-load for all jobs. Pro only. |
| scroll_offset_px | integer | — | Default scroll-down offset (0-30000 px) before capture. Mutually exclusive with scroll_to. Pro only. |
| scroll_to | string | — | Default CSS selector (typically an element id, e.g. "#pricing") to scroll into view before capture. Resolved via querySelector. Mutually exclusive with scroll_offset_px. Pro only. |
| selector | string | — | Default CSS selector clip for all jobs. Pro only. |
| viewport_width | integer | — | Default viewport for all jobs. Free: 390/768/1280. Shotbot Pro: custom 280-3840. |
| wait | integer | — | Default wait for all jobs. |
No output schema declared.
No examples provided.
capture ~1,400
Submit a screenshot capture request for a URL. Returns a token to poll with get_status. Supported formats: jpg (free), png, webp, webp_lossless, avif, pdf (Pro). Captures are private by default (not on the CDN; retrieve via the download URL from get_status, fetchable repeatedly until it auto-expires). Pass cdn=true for a permanent public CDN image URL instead. Use callback_url for async delivery so you don't need to poll.
| Name | Type | Req | Description |
|---|---|---|---|
| autoplay_videos | boolean | — | Launch Chromium with --autoplay-policy=no-user-gesture-required so unmuted <video autoplay> elements start playing without a user gesture. Useful for pages with hero videos. Pro only. |
| block_ads | boolean | — | Block ads and trackers. Pro only. |
| callback_secret | string | — | Shared secret echoed in callback payload for verification. |
| callback_url | string | — | HTTPS URL to POST the result to when done. Skips polling. |
| cdn | boolean | — | When true, publish the result to the public CDN and return a permanent image URL. Default: captures are private (not uploaded to the CDN); retrieve them via the download URL from get_status, which st… |
| color_scheme | string | — | Emulate prefers-color-scheme media query. |
| cookies | array | — | Cookies injected before navigation (e.g. to capture pages behind a session). Max 50. Pro only. |
| crop_height | integer | — | Custom output height in px, cropped from top. Max 30000. Pro only. |
| dismiss_cookies | string | — | Handle cookie banners automatically. Pro only. |
| emulate_print_media | boolean | — | Apply the page's print stylesheet (page.emulateMediaType("print")) before capture. Useful for capturing print layouts as an image. No additional effect on PDF (already in print mode). Pro only. |
| format | string | — | Output format. Default: jpg. png, webp, webp_lossless, avif, pdf require Pro (non-Pro accounts are limited to jpg). |
| frame | string | — | Decorative frame composited around the rendered image (ignored for PDF). Variants: rounded (corner-clipped, no padding), shadow (drop shadow + rounded corners), browser_chrome / browser_chrome_dark (… |
| fullpage | boolean | — | Capture the full page height (max 30000 px). Default: false. |
| hidpi | boolean | — | Render at 2× device pixel ratio (retina / HiDPI). Doubles the output resolution. |
| http_auth | object | — | HTTP Basic Auth credentials for password-protected pages. Pro only. |
| nojs | boolean | — | Disable JavaScript before loading the page. |
| omit_background | boolean | — | Render with a transparent viewport backdrop (Chromium omitBackground). Visible on PNG/WebP/AVIF; JPG flattens to black. No effect on PDF. Pro only. |
| output_size | integer | — | Output image width in px. Defaults to viewport_width. |
| pdf_landscape | boolean | — | Render the PDF in landscape orientation (format=pdf only). |
| pdf_margin_mm | integer | — | PDF page margin in millimetres, 0-50 (format=pdf only). Default 10. |
| pdf_page_size | string | — | PDF page size (format=pdf only). Default A4. |
| pdf_scale | number | — | PDF render scale, 0.10-2.00 (format=pdf only). Default 1.0. |
| prefers_reduced_motion | boolean | — | Emulate the prefers-reduced-motion: reduce CSS media feature. Well-built sites use it to skip or shorten animations (framer-motion, GSAP, AOS, IntersectionObserver reveals), so captures show the sett… |
| preset | string | — | Named output bundle | fills viewport_width / output_size / crop_height. og=1200×630 (social card), mobile=390×844 (iPhone), square=1080×1080, reel=1080×1920, pinterest=1000×1500, youtube_thumbnail=12… |
| ratio | string | — | Crop ratio, e.g. "16:9" (default), "4:3", "1:1", "9:16". |
| render_region | string | — | Geographic render location, using a real local IP. fr-paris is the default and free; ca-montreal, sg-singapore (beta), au-sydney (beta), vn-hanoi (beta) are Pro. |
| scroll_before_capture | boolean | — | Scroll through the full page before capturing so lazy-loaded content (images, infinite scroll, content below the fold) is rendered. Recommended with fullpage=true. Pro only. |
| scroll_offset_px | integer | — | Scroll down this many px (0-30000) before capturing, so the frame starts lower. Mutually exclusive with scroll_to. No-op for fullpage/PDF/selector. Pro only. |
| scroll_to | string | — | CSS selector for an element to scroll into view (top of frame) before capturing. Typically an element id, e.g. "#pricing". Resolved via querySelector. Unlike selector, it does not clip output. Mutual… |
| selector | string | — | CSS selector: clips output to the matching element. Pro only, non-PDF. |
| url | string | yes | Public http/https URL to capture (required) |
| viewport_width | integer | — | Browser viewport width in px. Free: 390, 768, 1280. Shotbot Pro: any custom width 280-3840 (CSS / responsive testing). Default: 1280. |
| wait | integer | — | Seconds to wait after page load before capture. Free: 0-5, Pro: 0-30. Default: 5. |
No output schema declared.
No examples provided.
get_status ~100
Poll the status of a capture by token. Returns status (queued | processing | done | failed) and, when done, image_url for public (cdn) captures or a download URL for private captures (fetchable repeatedly until it auto-expires). Also returns meta_http_status, meta_final_url, and meta_page_title when available. No API key required for polling.
| Name | Type | Req | Description |
|---|---|---|---|
| token | string | yes | 32-character alphanumeric token returned by capture or batch. |
No output schema declared.
No examples provided.