Skim

Claude plugin 用户

本仓库中的 Claude 插件使用捆绑的、仅支持卡密的服务。 它不会运行下方的 npm/钱包设置。安装、数据处理、额度费用和审核者检查，请参阅 CLAUDE-PLUGIN.md。

---

skim-mcp

Skim 是面向 AI Agent 的完整网页工具包，不只是简单的页面阅读器。前往 skim402.com/pricing 免费获取卡密；钱包/x402 为可选项。

skim-mcp 是 Skim 的官方 Model Context Protocol 服务。它能将公开网页转换为整洁、适合 Agent 使用的 Markdown——根据 Skim 的测量对比，通常比原始 HTML 小约 4 倍；并提供完整工具包：整洁读取、批量读取、JavaScript/浏览器渲染、结构化提取、爬取、PDF、页面变更监控，以及精选 Signals。

默认方式：卡密套餐 API 密钥。 前往 skim402.com 免费获取 sk402_ 密钥（定价）。将其粘贴为 SKIM_API_KEY。无需加密货币钱包。

可选方式：x402 钱包支付。 如果你更倾向于在 Base 上用 USDC 按次付费，可以改为设置 SKIM_WALLET_PRIVATE_KEY。除非你需要，否则请忽略此项。

本软件包提供的工具： read_url、read_urls、extract_url、crawl_url、read_pdf、watch_urls、check_watch、poll_signal。

集成前先试用： 使用 Playground 快速读取，或使用 Workbench 测试批量处理、提取、爬取、PDF、监控和 Signals。

---

快速开始（60 秒）

卡密 API 密钥（推荐）

1. 前往 skim402.com 免费获取密钥——密钥以 sk402_ 开头。注册时需要银行卡；免费套餐每月可读取 1,000 次。详情：skim402.com/pricing。

2. 将以下内容添加到 MCP 客户端。Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。Cursor — ~/.cursor/mcp.json（或 Settings → MCP）。同一份 JSON 也适用于 Cline、Continue、Zed 和其他 MCP 客户端：

{
  "mcpServers": {
    "skim": {
      "command": "npx",
      "args": ["-y", "skim-mcp"],
      "env": {
        "SKIM_API_KEY": "sk402_your_key_here"
      }
    }
  }
}

3. 重启客户端，并让它读取一个 URL：

Read https://en.wikipedia.org/wiki/HTTP_402 and summarize it.

---

钱包 / x402（可选）

仅当你更倾向于按次付费（在 Base 上每次 0.002 USDC），而非使用卡密时才需要。你可以跳过整个部分。

{
  "mcpServers": {
    "skim": {
      "command": "npx",
      "args": ["-y", "skim-mcp"],
      "env": {
        "SKIM_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

为一个专用 Base 钱包充值少量 USDC（1 美元约可读取 500 次）。设置指南：https://skim402.com/wallet。

请使用新钱包，不要使用个人钱包。 此私钥会以纯文本形式保存在你设备上的配置文件中——请将其视为用于支付 0.002 美元通行费的热钱包，而不是储蓄账户。

---

常见问题

我需要 API 密钥吗？
默认方式需要。前往 https://skim402.com 免费获取 sk402_ 密钥。钱包为可选项。

这只能用钱包吗？我需要加密货币吗？
不需要。默认使用卡密 API 密钥。x402 钱包支付为可选项。

我的 Agent 可以调用哪些工具？
read_url、read_urls（批量）、extract_url、crawl_url、read_pdf、watch_urls、check_watch 和 poll_signal。

---

无需 Agent 即可试用

使用卡密：

curl -H 'Authorization: Bearer sk402_your_key_here' \
  'https://skim402.com/api/t/read?url=https://en.wikipedia.org/wiki/HTTP_402'

钱包 / x402 挑战（可选——不发送付款时返回 HTTP 402）：

curl -i -X POST https://skim402.com/api/v1/read \
  -H 'content-type: application/json' \
  -d '{"url":"https://en.wikipedia.org/wiki/HTTP_402"}'

---

工具

read_url

读取任意 URL，并返回包含 YAML frontmatter 区块的整洁 Markdown。

输入： { "url": "https://example.com/article" }

路由： GET /api/t/read?url=（API 密钥） · POST /api/v1/read（钱包）

输出：

---
title: Example article
byline: Jane Doe
published: 2025-01-15
lang: en
excerpt: A short summary...
---

# Example article

The cleaned article body in Markdown...

read_urls

一次调用批量读取 1–10 个 URL。可选使用 stripLinks / stripImages。

输入： { "urls": ["https://a.example", "https://b.example"] }

路由： POST /api/t/read/batch · POST /api/v1/read/batch

extract_url

从页面提取结构化 JSON。传入 JSON Schema，或使用预设：article、product、job、review、event、table。

输入： { "url": "https://example.com/product", "preset": "product" }

路由： POST /api/t/extract · POST /api/v1/extract

这些提取路由会将预设作为 Schema 发送。

crawl_url

爬取网站（源站或起始 URL），并为每个页面返回干净的 Markdown。发现 sitemap.xml / robots.txt 站点地图以及同源链接。最多 25 个页面。每个成功页面消耗 1 个额度；失败页面不收费。

输入： { "url": "https://example.com", "maxPages": 10 }

可选：stripLinks、stripImages。像 example.com 这样的纯主机名会被视为 https://example.com。

路由： POST /api/t/crawl（API 密钥）。没有对应的 x402 /v1 路由——请设置 SKIM_API_KEY。

Crawl https://example.com (max 10 pages) and list the page titles.

read_pdf

获取公开的 PDF URL，返回干净的 Markdown，以及可选的书签大纲。文本仅来自文件本身。纯图像扫描件返回 422（不支持 OCR）。大于 8 MB 的文件返回 413。消耗 3 个额度；转换失败不收费。

输入： { "url": "https://example.com/paper.pdf" }

可选：outline（默认值为 true）。

路由： POST /api/t/read-pdf（API 密钥）。没有对应的 x402 /v1 路由——请设置 SKIM_API_KEY。

Read the PDF at https://example.com/paper.pdf and summarize the outline.

poll_signal

轮询 Skim Signal，返回最新的结构化条目（标题、摘要、来源、时间戳、链接、实体）。每次成功轮询消耗 2 个额度；轮询失败会退还额度。

需要 SKIM_API_KEY。 仅配置钱包时会返回明确的错误。

输入： { "slug": "ai-news", "limit": 20 }

可选筛选条件（仅传入信息流文档说明支持的条件）：forms（sec-filings、campaign-finance）、categories（deals）、fields（research）、states（film-incentives）、committees（campaign-finance）。

Slug： ai-news、sec-filings、crypto-news、macro、security、regulations、courts、recalls、deals、launches、trending、research、energy、entertainment、studio-jobs、campaign-finance、film-incentives。生态系统信息流请使用 x402。

路由（API 密钥）： GET /api/t/signal/{slug}/latest?limit= · GET /api/t/feeds/x402/latest?limit=（x402 不是 /signal/x402）

curl -H 'Authorization: Bearer sk402_your_key_here' \
  'https://skim402.com/api/t/signal/ai-news/latest?limit=20'

Poll the ai-news signal for the latest 20 items.

watch_urls / check_watch

注册 1–20 个 URL，然后轮询内容差异。watch_id 是密钥。

输入： { "urls": ["https://competitor.com/pricing"], "note": "pricing" } 然后 { "watch_id": "w_…" }（可选 status_only: true）

路由（API 密钥）： POST /api/t/watch · GET /api/t/watch/diff?id= · GET /api/t/watch/status?id=

路由（钱包）： POST /api/v2/watch · GET /api/v2/watch/diff?id= · GET /api/v2/watch/status?id=

Agent 提示词示例

Read https://en.wikipedia.org/wiki/HTTP_402 and summarize it.

Read these three pages and compare their pricing: https://a.example/pricing https://b.example/pricing https://c.example/pricing

Extract the product name, price, and availability from https://example.com/products/notebook as JSON.

Crawl https://example.com (max 10 pages) and list the page titles.

Read the PDF at https://example.com/paper.pdf and summarize it.

Poll the ai-news signal for the latest 20 items.

Watch https://competitor.com/pricing and https://competitor.com/changelog, then check the watch for changes.

---

配置

变量	必填	默认值	说明
SKIM_API_KEY	是（或钱包）	—	卡套餐 API 密钥（sk402_...）。可在 skim402.com 免费获取 / 套餐价格。优先级高于 SKIM_WALLET_PRIVATE_KEY。
SKIM_WALLET_PRIVATE_KEY	可选	—	仅在不使用卡密钥时填写。专用 Base 钱包的十六进制私钥，用于支付 x402 读取费用（每次调用 $0.002 USDC）。设置 SKIM_API_KEY 后会忽略此项。切勿使用个人钱包。
SKIM_MAX_PRICE_USD	否	0.01	仅适用于钱包通道。单次调用价格上限（美元）。单次读取费用为 $0.002。批量、提取和监控的费用更高——如果钱包通道拒绝这些调用，请提高此值（例如设为 0.05）。
SKIM_API_URL	否	https://skim402.com	覆盖 API 基础 URL。用于自托管或本地开发。
SKIM_TIMEOUT_MS	否	90000	每次调用的硬性截止时间，单位为毫秒。超时后会中止卡住的请求，避免单次异常调用一直阻塞 Agent。未结算的调用不会收费，因此可以安全重试。

---

实际工作方式

卡通道（默认）：

your agent ──► skim-mcp ──► GET https://skim402.com/api/t/read?url=…
                                 Authorization: Bearer sk402_...
                                        │
                                        ▼
                                200 OK + clean Markdown

钱包通道（x402，可选）：

your agent ──► skim-mcp ──► POST https://skim402.com/api/v1/read
                   ▲                       │
                   │                       ▼
                   │              402 Payment Required
                   │                  (x402 challenge)
                   │                       │
                   ▼                       │
   x402-fetch signs EIP-3009 ◄────────────┘
   USDC transfer authorization
                   │
                   ▼
        retry POST with X-PAYMENT header
                   │
                   ▼
   Skim verifies + settles via Coinbase CDP
                   │
                   ▼
        200 OK + clean Markdown

端到端延迟通常为 1.5–2 秒（包括结算）。钱包通道的私钥不会离开你的设备——它们只会在本地签署授权。

---

安全

• **卡密钥：**存储在 MCP 客户端的 JSON 配置中。任何有权读取该文件的人都可以使用你的密钥。请使用免费套餐或余额较少的套餐。
• **钱包密钥（仅在使用可选的钱包方式时）：**以明文形式存储在同一个 JSON 配置中。任何能访问你的主目录的人都可以耗尽钱包余额。钱包中只需存入你愿意在失控循环中花掉的 USDC。
• 此软件包不会向外发送遥测数据。skim-mcp 只会连接到 skim402.com（或你通过 SKIM_API_URL 设置的地址）。没有分析、错误报告或主动回传数据。

---

故障排除

“Claude/Cursor 中没有显示名为 read_url 的工具。” 完全重启客户端（退出程序，不要只重新加载窗口）。MCP 服务会在客户端启动时生成。如果仍未显示，请在终端中直接运行 npx skim-mcp——如果出现堆栈跟踪，很可能是 Node < 18。

使用卡密钥时出现“401 Unauthorized”。 你的 SKIM_API_KEY 无效或已过期。请在 skim402.com/pricing 获取新密钥。

“402 Payment Required”无限循环（钱包通道）。 你的 Base 主网上的 USDC 余额不足。请在 BaseScan 查看余额，并按需充值。

“USDC 在 Ethereum 上，不在 Base 上。” 这是最常见的充值错误。Ethereum 主网上的 USDC 不可用——Skim 只接受 Base 上的 USDC。桥接操作指南请参阅 https://skim402.com/wallet。

---

链接

• Skim 网站 — https://skim402.com
• 套餐价格和免费密钥 — https://skim402.com/pricing
• 钱包设置指南 — https://skim402.com/wallet
• API 文档 — https://skim402.com/docs
• x402 协议 — https://x402.org
• Model Context Protocol — https://modelcontextprotocol.io
• GitHub — https://github.com/JessieJanie/skim402

---

许可证

MIT