内容
skim-mcp
**赋予你的 AI 代理读取任何 URL 的能力 — 清洁的 Markdown，无广告，无导航，无样板。每次调用自动支付。无需注册，无需 API 密钥。**
[](https://www.npmjs.com/package/skim-mcp)
[](https://registry.modelcontextprotocol.io/v0/servers?search=skim402)
[](LICENSE)
`skim-mcp` 是 [Skim](https://skim402.com) 的官方模型上下文协议服务器，Skim 是规范的 [x402](https://x) 清洁阅读器 API。它公开了一个工具，`read，你的代理可以调用它以获取任何网页作为代理准备好的 Markdown 以及结构化元数据（标题、署名、发布时间、语言）。每次调用在 Base **0.002 美元的 USDC**，由你的本地钱包通过 HTTP 402 自动支付。
> **在使用之前先看看：** [在浏览器中免费试用 Skim](https://freeskims.skim402.com) — 每天 10 次免费试用，无需钱包，无需注册。粘贴一个 URL，看看你的代理能得到什么。
> _即将到来的 30 秒演示 GIF。_
---
## 快速入门（60 秒）
### 1. 添加到你的 MCP 兼容客户端
**Claude Desktop** — 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"skim": {
"command": "npx",
"args": ["-y", "skim-mcp"],
"env": {
"SKIM_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
}
}
}
}
```
**Cursor** — 编辑 `~/.cursor/mcp.json`（或 **设置 → MCP**）并使用相同的 JSON 块。
**Cline, Continue, Zed 或任何其他 MCP 客户端** — 形状相同；二进制文件为 `npx skim-mcp`，只有一个环境变量。
### 2. 用 1 美元的 USDC 资助一个 Base 钱包
一美元可资助大约 500 次读取。完整的逐步指南（带有截图，适用于非加密货币原生开发人员）：**<https://skim402.com/wallet>**。
> **钱包，而不是你的个人钱包。** 这个钱包的私钥存储在你机器上的一个纯文本配置文件中 — 将其视为一个热钱包，用于支付 0.002 美元的过路费，而不是一个储蓄账户。
### 3. 重启你的客户端并要求它读取某些内容
aude, 读取 https://en.wikipedia.org/wiki/HTTP_402 并总结它。
```
代理将调用 `read_url`，你的本地钱包将签署一个 EIP-3009 USDC 授权，价值 0.002 美元，Skim 返回干净的 Markdown，Claude 进行总结。你将在 [BaseScan](https://basescan.org/) 的钱包交易历史中看到支付凭证。
---
## 在没有代理的情况下试用
怀疑吗？直接测试上游端点 — 它将返回一个 402 挑战，让你看到协议的作用：
```bash
curl -i -X POST https://skim402.com/api/v1/read \
-H 'content-type: application/json' -d '{"url":"https://en.wikipedia.org/wiki/HTTP"}'
```
你将收到 `HTTP/1.1 402 Payment Required`，响应正文中带有 x402 挑战。要从脚本（非代理）支付挑战，请参阅 [x402-fetch](https://www.npmjs.com/package/x402-fetch)。
---
## 工具
### `read_url`
读取任何 URL 并返回带有 YAML 前置块的干净 Markdown。
**输入：**
```json
{ "url": "https://example.com/article" }
```
**输出：
```
---
title: 示例文章
byline: Jane Doe
published: 20201-15
lang: zh
excerpt: 简要摘要...
---
# 示例文章
清理后的文章正 Markdown 格式显示...
```
就是这样。一个工具，一个输入，一个输出格式。设计用于以零仪式插入任何代理的工具调用。
---
## 配置
| 变量 | 必需 | | 备注 |
| | -------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SKIM_WALLET_PRIVATE_KEY`是** | — | Base 钱包的十六，用于支付读取费用。不带 `0x` 前缀。 使用专用钱包绝不使用个人钱包。 |
| `SKIM_MAX_PRICE_USD` | 否 `0.01` 每调用美元价格的。如果价格超过此限制，钱包将拒绝签署。 Skim 目前为每次调用收取 0.002 美元，远低于默认上限 — 除非调整，否则保留默认值。 |
| `SKIM_API_URL` | 否 | `https://skim402.com` | 覆盖 API 基本 URL。用于自托管或本地开发。 |
---
## 它实际上
```
你的代理 ──► skim-mcp ──► POST https://skim402.com1/read
▲ │ ▼
│ 402 Payment Required │ (x402)
│ │
│
x402-fetch 签署 EIP-3009 ◄────────────┘
USDC 转账授权 │
▼
发送 POST 请求，带有AYMENT 头部
│
▼
Skim 验证 + 通过 Coinbase CDP 促进者结算
│
200 OK + 干净的 Markdown
```
端到端延迟通常为 **1.5–2 秒**，包括结算。你的私钥永远不会离开你的机器 — 它只在授权。
---
## 安全
- **专用钱包，始终。** 仅用你愿意在失控循环中花费的 USDC 资助它。 `SKIM_MAX_PRICE_USD` 上限捕获了服务器端的上涨。
- **纯警告。** MCP 磁盘上的 JSON 文件中（纯文本）。任何主目录具有读取权限的人都可以耗尽钱包。这是每个需要凭证的 MCP 服务器的属性 — 保持钱包小额。
-软件包无外部遥测数据。** `skim-mcp` 仅与 `skim402.com`（或你设置的 `SKIM_API_URL`）通信。无分析，无错误报告，无电话回拨。
---
##排除
**“在ursor 中没有名为 `read_url` 的工具。”**
完全重启客户端（退出，不要只是窗口）。MCP 服务器启动时生成。如果仍然，请在终端中直接npx skim-mcp 如果你得到一个堆，很可能是 Node < **“402 Payment Required”循环永远。**
你的钱包里的 USDC 余额不足（或者你将 `SKIM_API_URL` 设置为期望在不同网络上支付的服务器）。在 [BaseScan](https://basescan.org/) 上检查余额，如有需要请充值。
**“gas 资金不足”**
违反直觉但是：x402 USDC 转账从你的钱包角度来看是无 gas 的（促进者支付 gas，你只需签署授权）。如果你看到这个错误，你很可能资助了错误的钱包或错误的网络 — 验证你的配置中的地址是否与持有 USDC 的地址匹配。
**“USDC 在以太坊上，不在 Base 上。”**
这是最常见的资金错误。以太坊主网上的 USDC 不起作用 — Skim 只接受 Base 上的。有关桥接，请参阅 <https402.com/wallet>。
---
## 链接
- **Skim 网站** — <https://skim402.com>
- **钱包设置指南** — <https://skim402.com/wallet>
- **API 文档** — <https://skim402.com/docs>
- **x402 协议** — <https://x402.org>
- **模型上下文 — <https://protocol.io>
- **GitHub** — <https:///JessieJanie402>
---
## 许可证
MIT
