Skim

Claude プラグインのユーザー

このリポジトリの Claude プラグインは、カードキー専用のバンドル済みサーバーを使用します。 以下の npm／ウォレットのセットアップは実行しません。インストール、データの取り扱い、クレジット費用、レビュアーの確認事項については、CLAUDE-PLUGIN.md をご覧ください。

---

skim-mcp

Skim は、単なるページリーダーではなく、AI エージェント向けの完全なウェブツールキットです。無料のカードキーを skim402.com/pricing で取得できます。ウォレット／x402 は任意です。

skim-mcp は Skim の公式 Model Context Protocol サーバーです。公開ページを、エージェントがすぐに使えるクリーンな 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 を、複数ページ、一括抽出、クロール、PDF、監視、Signals を試すには Workbench をご利用ください。

---

クイックスタート（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（または 設定 → 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 の通行料を支払うホットウォレットとして扱ってください。

---

FAQ

API キーは必要ですか？
標準の方法では必要です。https://skim402.com で無料の sk402_ キーを取得してください。ウォレットは任意です。

ウォレット専用ですか？暗号資産は必要ですか？
いいえ。カード API キーが標準です。x402 ウォレット決済は任意です。

エージェントから呼び出せるツールは何ですか？
read_url、read_urls（一括）、extract_url、crawl_url、read_pdf、watch_urls、check_watch、poll_signal です。

---

エージェントなしで試す

カードキーを使用する場合：

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 フロントマターブロック付きのクリーンな 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 回の呼び出しで 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

プリセットは、これらの抽出ルートでスキーマとして送信されます。

crawl_url

サイト（オリジンまたは開始 URL）をクロールし、ページごとに整形済み Markdown を返します。sitemap.xml／robots.txt のサイトマップと同一オリジンのリンクを検出します。上限は 25 ページです。成功したページごとに 1 クレジットです。失敗したページは課金されません。

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

任意：stripLinks、stripImages。example.com のようなホスト名のみの URL は 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）。

スラッグ： 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=

エージェントのプロンプト例

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	任意	—	カードキーを使用しない場合のみ必要です。x402 の読み取り（1 回あたり $0.002 USDC）の支払いに使う、専用 Base ウォレットの 16 進数秘密鍵です。SKIM_API_KEYが設定されている場合は無視されます。個人用ウォレットは絶対に使用しないでください。
SKIM_MAX_PRICE_USD	いいえ	0.01	ウォレット経路のみ。1 回あたりの価格の上限（米ドル）です。単一の読み取りは$0.002です。バッチ／抽出／監視はより高額です。ウォレット経路でこれらの呼び出しが拒否される場合は、この値を引き上げてください（例：0.05）。
SKIM_API_URL	いいえ	https://skim402.com	API のベース URL を上書きします。セルフホストやローカル開発に使用します。
SKIM_TIMEOUT_MS	いいえ	90000	呼び出しごとの厳格なタイムアウト（ミリ秒）です。応答が停止したリクエストを中止するため、問題のある呼び出しがエージェントを停止させることはありません。未決済の呼び出しに課金されることはないため、安全に再試行できます。

---

実際の仕組み

カード経路（デフォルト）：

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に設定した 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 は Base ではなく Ethereum にあります。」 これは資金を入れる際によくある間違いです。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