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 分

    请在仓库或注册中心条目中声明许可证。