Shotanvil

com.shotanvil.api由 api.shotanvil.com 發布官方發布者v1.0.0更新於 Nov 2, 2026

Screenshot/PDF/HTML rendering API. API key or x402 required — keyless access disabled.

已驗證Streamable HTTP可網頁執行瀏覽器自動化媒體與設計

概覽

AI 產生的概覽

遠端截圖、PDF 與 HTML 渲染 API，讓助理把網頁或內嵌 HTML 擷取成圖片或 PDF。

可以做什麼
  • 把網頁擷取成 PNG、JPEG、WebP 或 PDF，可設定整頁、視窗尺寸、深色模式與快取
  • 把內嵌 HTML 渲染成圖片或 PDF
  • 回傳原始位元組，或回傳含 base64 圖片、擷取文字與中繼資料的 JSON
  • 截圖時可封鎖廣告並隱藏 Cookie 同意橫幅
  • 查詢目前金鑰的當日用量與限流狀態
適用情境
適合助理需要把線上網址或一段 HTML 變成視覺快照或 PDF 的情況，例如產生報告、預覽或做視覺檢查，而不必在本機執行瀏覽器。
執行需求
透過 streamable HTTP 連線到 api.shotanvil.com 的遠端端點。存取需要 API 金鑰（以 X-Api-Key 或 access_key 查詢參數送出）或用於逐次付費的 X-Payment 標頭；免金鑰存取僅在營運方開啟時可用。需要能連上該服務的網路。
安裝前請注意
請求會計費：API 金鑰對應含免費額度的付費方案，x402 方式逐次付費，用量可能產生費用。API 金鑰屬於機密，應避免出現在共用日誌中。目標網址與送出的 HTML 會傳給第三方服務，不宜送出不應外流的頁面或內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Shotanvil，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.shotanvil.api%2Fshotanvil/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "shotanvil": {
      "type": "http",
      "url": "https://api.shotanvil.com/mcp"
    }
  }
}

README

shotanvil-examples

Usage examples and a live-synced OpenAPI spec copy for the shotanvil screenshot API — 1 screenshot = 1 request, a free tier that's actually free, from $9/mo.

Base URL: https://api.shotanvil.com

Access paths

GET /take and POST /render-html accept three access paths, checked in this order:

  1. x402 — send an X-Payment header (pay-per-call, no signup, testnet-settled).
  2. API key — send X-Api-Key: <key> or ?access_key=<key>.
  3. Keyless — no credential, IP-rate-limited, only when the operator has keyless access enabled.

An invalid API key always fails with 401 and never falls through to keyless, even when keyless is enabled — a typo'd paying key never silently downgrades to a lower tier.

Get an API key at shotanvil.com.

Quickstart

Take a screenshot:

bash
curl "https://api.shotanvil.com/take?url=https://example.com" \  -H "X-Api-Key: $SHOTANVIL_API_KEY" \  -o screenshot.png

Get text + metadata as JSON instead of raw bytes:

bash
curl "https://api.shotanvil.com/take?url=https://example.com&response_format=json" \  -H "X-Api-Key: $SHOTANVIL_API_KEY"

Render inline HTML:

bash
curl -X POST https://api.shotanvil.com/render-html \  -H "Content-Type: application/json" \  -H "X-Api-Key: $SHOTANVIL_API_KEY" \  -d '{"html": "<html><body><h1>Hello</h1></body></html>"}' \  -o out.png

More runnable examples: examples/curl.sh, examples/node/screenshot.mjs.

Common GET /take parameters

ParamTypeNotes
urlstring, requiredTarget page URL, http/https only.
formatstringpng (default), jpeg, webp, or pdf.
full_pageboolCapture the full scrollable page height, not just the viewport.
viewport_width / viewport_heightint320–3840 / 240–2160.
cache_ttlintSeconds to cache this exact render, 0–86400.
freshboolBypass the cache read for this request.
block_adsboolBlock ad-network requests via an EasyList-derived blocklist.
block_cookie_bannersboolInject a CSS kill-list that hides common cookie-consent banners.
dark_modeboolEmulate prefers-color-scheme: dark before navigation.
response_formatstringbinary (default) returns raw bytes; json wraps image (base64) + extracted text/metadata.

Full parameter reference, request/response schemas, and every field's worked example live in openapi.json — open it in any OpenAPI viewer (e.g. editor.swagger.io) for the browsable version.

Rate limits

Each API key has a per-second rate limit and a daily call cap. GET /usage reports the current key's usage for the day. Exceeding either returns 429 with a retry_after_s field.

Keeping openapi.json in sync

openapi.json in this repo is a point-in-time copy, fetched from the live GET https://api.shotanvil.com/openapi.json endpoint — it is not hand-written and will drift as the API evolves.

Before relying on it for anything beyond casual browsing, or before any future update to this repo, re-fetch and diff:

bash
curl -sS https://api.shotanvil.com/openapi.json -o /tmp/openapi.latest.jsondiff openapi.json /tmp/openapi.latest.json

If they differ, review the diff, replace openapi.json with the fresh copy, and commit — do not hand-edit openapi.json directly.

License

Examples in this repo are MIT-licensed — copy and adapt freely. openapi.json describes the shotanvil API and is provided for reference only.

來源：README.md，提交 30362bb

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。