Allscreenshots

Allscreenshots 插件

通过 Allscreenshots API，从 Claude Code、OpenAI Codex 和任何兼容 MCP 的客户端截取网站截图。

支持的平台

• Claude Code
• OpenAI Codex
• 兼容 MCP 的客户端，例如 Cursor、VS Code Copilot、Gemini CLI 和 Windsurf

快速安装

Claude Code

添加 Allscreenshots marketplace，然后安装插件：

/plugin marketplace add allscreenshots/allscreenshots-plugin
/plugin install allscreenshots@allscreenshots

安装后重启 Claude Code。Claude Code marketplace 会从 claude-code-plugin/ 安装一个小型插件包。

如果你已安装旧版本，且 Claude Code 仍然报告插件缓存错误，请刷新 marketplace 并更新插件：

/plugin marketplace update allscreenshots
/plugin update allscreenshots@allscreenshots

OpenAI Codex

添加 Allscreenshots marketplace，然后从 Codex 的插件目录安装插件：

codex plugin marketplace add allscreenshots/allscreenshots-plugin
codex
/plugins

选择 Allscreenshots marketplace，打开 Allscreenshots 插件并安装。该插件包含 MCP 服务配置，因此你无需粘贴很长的 codex mcp add 命令。

如果你已安装旧版本，请先刷新 marketplace：

codex plugin marketplace upgrade allscreenshots

通用 MCP 客户端

配置 MCP 客户端以运行：

python3 /path/to/allscreenshots-plugin/mcp_server/server.py

在 MCP 服务环境中设置 API 密钥，或通过 api_key 工具参数传入。

配置

从以下位置获取 API 密钥：

https://allscreenshots.com/dashboard

然后将其设为环境变量：

export ALLSCREENSHOTS_API_KEY=your-key-here

调用 take_screenshot 时，也可以通过 api_key 参数直接传入 API 密钥。

当 MCP 子进程可以读取 ALLSCREENSHOTS_API_KEY 变量时，MCP 服务会读取该变量。调用 take_screenshot 时，也可以通过 api_key 参数直接传入 API 密钥。

如果无法使用 MCP 工具，也可以直接通过 curl 调用 Allscreenshots REST API；无需安装 Allscreenshots CLI。

可用工具

工具	描述	参数
take_screenshot	截取网站截图并返回保存的本地文件路径。	url、api_key、width、height、format、full_page、delay、dark_mode、block_ads
get_api_info	返回设置链接、支持的格式、速率限制说明和 API 密钥指南。	无

示例

• “截取 https://example.com 的截图”
• “截取我们落地页的整页截图”
• “以深色模式截取此页面”
• “截取 https://example.com 的移动端截图”
• “截取不包含广告或 Cookie 横幅的截图”
• “如何获取 Allscreenshots API 密钥？”

开发

在本地运行 MCP 服务：

cd mcp_server
export ALLSCREENSHOTS_API_KEY=test-key
python3 server.py

运行测试：

uv run --with "fastmcp>=2.0" --with "httpx>=0.27" --with "pytest>=8" pytest

打包 Claude Code 和 Codex 插件发行包：

python3 scripts/package_plugins.py

归档文件会写入 dist/。

检查 Codex marketplace 元数据：

codex plugin marketplace add ./path/to/allscreenshots-plugin
codex
/plugins

许可证

MIT