Skim

Lector web limpio para agentes de IA. Paga $0.002/llamada en USDC en Base mediante x402. Sin claves API, sin registro.

Documentación

Usuarios del plugin de Claude

El plugin de Claude en este repositorio utiliza un servidor incluido que solo funciona con tarjeta. No ejecuta la configuración de npm/wallet que se muestra a continuación. Consulta CLAUDE-PLUGIN.md para obtener información sobre instalación, manejo de datos, costos de créditos y revisiones.

skim-mcp

Skim es el kit de herramientas web completo para agentes de IA, no solo un simple lector de páginas. Obtén una clave de tarjeta gratuita en skim402.com/pricing; la wallet/x402 es opcional.

skim-mcp es el servidor oficial del Model Context Protocol para Skim. Convierte páginas públicas en Markdown limpio y listo para agentes—típicamente ~4 veces más pequeño que el HTML crudo en las comparaciones medidas de Skim—y expone el kit de herramientas completo: lecturas limpias, lecturas por lotes, renderizado con JavaScript/navegador, extracción estructurada, rastreo, PDFs, monitoreo de cambios de página y Signals seleccionados.

Ruta predeterminada: una clave de API del plan de tarjeta. Obtén una clave sk402_ gratuita en skim402.com (precios). Pégala como SKIM_API_KEY. No se requiere una wallet de criptomonedas.

Ruta opcional: pago con wallet x402. Si prefieres pagar por llamada en USDC en Base, puedes configurar SKIM_WALLET_PRIVATE_KEY en su lugar. Ignora esto a menos que lo quieras.

Herramientas en este paquete: read_url, read_urls, extract_url, crawl_url, read_pdf, watch_urls, check_watch, poll_signal.

Pruébalo antes de integrarlo: usa el Playground para una lectura rápida o el Workbench para probar lotes, extracción, rastreo, PDFs, monitoreos y Signals.

Skim in action — one URL in, clean Markdown out

Inicio rápido (60 segundos)

Clave de API de tarjeta (recomendado)

1. Obtén una clave gratuita en skim402.com — comienza con sk402_. Se requiere tarjeta al registrarse; 1,000 lecturas/mes en el plan gratuito. Detalles: skim402.com/pricing.

2. Agrega esto a tu cliente MCP. Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows). Cursor — ~/.cursor/mcp.json (o Configuración → MCP). El mismo JSON funciona en Cline, Continue, Zed y otros clientes MCP:

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

3. Reinicia el cliente y pídele que lea una URL:

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

Wallet / x402 (opcional)

Solo si prefieres pagar por llamada ($0.002 USDC en Base) en lugar de una clave de tarjeta. Puedes omitir todo este bloque.

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

Fondea una wallet de Base dedicada con un saldo pequeño de USDC ($1 ≈ 500 lecturas). Guía de configuración: https://skim402.com/wallet.

Usa una wallet nueva, no la personal. Esta clave privada vive en un archivo de configuración de texto plano en tu máquina—trátala como una wallet caliente para peajes de $0.002, no como una cuenta de ahorros.

Preguntas frecuentes

¿Necesito una clave de API?
Sí para la ruta predeterminada. Obtén una clave sk402_ gratuita en https://skim402.com. Una wallet es opcional.

¿Es solo con wallet? ¿Necesito criptomonedas?
No. La clave de API de tarjeta es la predeterminada. El pago con wallet x402 es opcional.

¿Qué herramientas puede llamar mi agente?
read_url, read_urls (lote), extract_url, crawl_url, read_pdf, watch_urls, check_watch y poll_signal.

Pruébalo sin un agente

Con una clave de tarjeta:

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

Desafío de wallet / x402 (opcional — devuelve HTTP 402 si no envías pago):

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

Las herramientas

`read_url`

Lee cualquier URL y devuelve Markdown limpio con un bloque de frontmatter YAML.

Entrada: { "url": "https://example.com/article" }

Rutas: GET /api/t/read?url= (clave de API) · POST /api/v1/read (wallet)

Salida:

---
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`

Lee en lote 1–10 URLs en una sola llamada. stripLinks / stripImages opcionales.

Entrada: { "urls": ["https://a.example", "https://b.example"] }

Rutas: POST /api/t/read/batch · POST /api/v1/read/batch

`extract_url`

JSON estructurado de una página. Pasa un JSON Schema, o un preset: article, product, job, review, event, table.

Entrada: { "url": "https://example.com/product", "preset": "product" }

Rutas: POST /api/t/extract · POST /api/v1/extract

Los presets se envían como esquemas en esas rutas de extracción.

`crawl_url`

Rastrea un sitio (origen o URL de inicio) y devuelve Markdown limpio por página. Descubre sitemaps sitemap.xml / robots.txt además de enlaces del mismo origen. Límite de 25 páginas. 1 crédito por página exitosa; las páginas fallidas no se cobran.

Entrada: { "url": "https://example.com", "maxPages": 10 }

Opcional: stripLinks, stripImages. Los hosts simples como example.com se tratan como https://example.com.

Ruta: POST /api/t/crawl (clave de API). No hay gemelo x402 /v1 — configura SKIM_API_KEY.

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

`read_pdf`

Obtiene una URL de PDF público y devuelve Markdown limpio más un esquema de marcadores opcional. El texto proviene solo del archivo. Los escaneos solo de imagen devuelven 422 (sin OCR). Los archivos mayores de 8 MB devuelven 413. 3 créditos; las conversiones fallidas no se cobran.

Entrada: { "url": "https://example.com/paper.pdf" }

Opcional: outline (predeterminado true).

Ruta: POST /api/t/read-pdf (clave de API). No hay gemelo x402 /v1 — configura SKIM_API_KEY.

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

`poll_signal`

Consulta un Skim Signal y devuelve los elementos estructurados más recientes (título, resumen, fuente, marca de tiempo, enlace, entidades). 2 créditos por consulta exitosa; las consultas fallidas se reembolsan.

Requiere SKIM_API_KEY. Las configuraciones solo con wallet reciben un error claro.

Entrada: { "slug": "ai-news", "limit": 20 }

Filtros opcionales (pasa solo los que documenta el feed): forms (sec-filings, campaign-finance), categories (deals), fields (research), states (film-incentives), committees (campaign-finance).

Slugs: ai-news, sec-filings, crypto-news, macro, security, regulations, courts, recalls, deals, launches, trending, research, energy, entertainment, studio-jobs, campaign-finance, film-incentives. Usa x402 para el feed del ecosistema.

Rutas (clave de API): GET /api/t/signal/{slug}/latest?limit= · GET /api/t/feeds/x402/latest?limit= (x402 no es /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`

Registra 1–20 URLs y luego consulta las diferencias de contenido. watch_id es un secreto.

Entrada: { "urls": ["https://competitor.com/pricing"], "note": "pricing" } y luego { "watch_id": "w_…" } (status_only: true opcional)

Rutas (clave de API): POST /api/t/watch · GET /api/t/watch/diff?id= · GET /api/t/watch/status?id=

Rutas (wallet): POST /api/v2/watch · GET /api/v2/watch/diff?id= · GET /api/v2/watch/status?id=

Ejemplos de prompts para agentes

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.

Configuración

Variable	Requerida	Predeterminado	Notas
`SKIM_API_KEY`	sí (o wallet)	—	Clave de API del plan de tarjeta (`sk402_...`). Obtén una gratis en skim402.com / precios. Tiene prioridad sobre `SKIM_WALLET_PRIVATE_KEY`.
`SKIM_WALLET_PRIVATE_KEY`	opcional	—	Solo si no usas una clave de tarjeta. Clave privada hexadecimal para una wallet de Base dedicada que paga lecturas x402 ($0.002 USDC/llamada). Se ignora cuando `SKIM_API_KEY` está configurado. Nunca uses una wallet personal.
`SKIM_MAX_PRICE_USD`	no	`0.01`	Solo carril de wallet. Límite máximo de precio por llamada en USD. Las lecturas individuales son `$0.002`. Lote / extracción / monitoreo cuestan más — aumenta esto (p. ej. `0.05`) si el carril de wallet rechaza esas llamadas.
`SKIM_API_URL`	no	`https://skim402.com`	Anula la URL base de la API. Para autoalojamiento o desarrollo local.
`SKIM_TIMEOUT_MS`	no	`90000`	Límite máximo por llamada en milisegundos. Aborta solicitudes estancadas para que una sola llamada defectuosa nunca cuelgue a tu agente. Las llamadas no resueltas nunca se cobran, así que reintentar es seguro.

Cómo funciona realmente

Carril de tarjeta (predeterminado):

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

Carril de wallet (x402, opcional):

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

La latencia de extremo a extremo es típicamente 1.5–2 segundos incluida la liquidación. Las claves privadas del carril de wallet nunca salen de tu máquina — solo firman autorizaciones localmente.

Seguridad

Clave de tarjeta: se almacena en la configuración JSON de tu cliente MCP. Cualquiera con acceso de lectura a ese archivo puede usar tu clave. Mantén tu clave en el plan gratuito o en un plan de saldo pequeño.
Clave de wallet (solo si usas la ruta de wallet opcional): vive en la misma configuración JSON en texto plano. Cualquiera con acceso a tu directorio de inicio puede vaciar la wallet. Manténla fondeada solo con el USDC que estés dispuesto a gastar en un bucle descontrolado.
Sin telemetría de salida desde este paquete. skim-mcp solo habla con skim402.com (o lo que configures como SKIM_API_URL). Sin análisis, sin informes de errores, sin llamadas a casa.

Solución de problemas

"No aparece ninguna herramienta llamada read_url en Claude/Cursor." Reinicia el cliente por completo (sal, no solo recargues la ventana). Los servidores MCP se inician al arrancar el cliente. Si aún falta, ejecuta npx skim-mcp directamente en una terminal — si obtienes un traceback, probablemente sea Node < 18.

"401 Unauthorized" con clave de tarjeta. Tu SKIM_API_KEY no es válida o está vencida. Obtén una nueva en skim402.com/pricing.

"402 Payment Required se repite para siempre" (carril de wallet). Tu wallet no tiene USDC en la red principal de Base. Verifica el saldo en BaseScan, recarga si es necesario.

"USDC está en Ethereum, no en Base." Este es el error de fondeo más común. El USDC en la red principal de Ethereum no funciona — Skim solo acepta USDC en Base. Consulta https://skim402.com/wallet para el tutorial de puente.

Enlaces

Sitio web de Skim — https://skim402.com
Precios y clave gratuita — https://skim402.com/pricing
Guía de configuración de wallet — https://skim402.com/wallet
Documentación de la API — https://skim402.com/docs
Protocolo x402 — https://x402.org
Model Context Protocol — https://modelcontextprotocol.io
GitHub — https://github.com/JessieJanie/skim402

Licencia

MIT