Repository navigation
Releases: cochinoraptor/WebMCPcss
Release list
v1.3.0 — Capa de Confianza Blockchain Gasless
Capa de Confianza Blockchain Gasless
Los agentes operan en sitios WebMCPcss con permisos verificables on-chain y transacciones sin gas, con auditoría inmutable. Cero dependencias nuevas; Node ≥ 18.
Novedades
- Políticas en
.webmcp.css:webmcp-auth(erc8004 | zk-proof | session-key | none),webmcp-payment(x402 | eip3009 | sponsored | none),webmcp-chain(sui | base | evm | skale o una red),webmcp-spending-limit,webmcp-rate-limit,webmcp-allowed-contracts,webmcp-allowed-hours,webmcp-requires-human-proof. - Identidad: ERC-8004 (owner,
agentWallet, nombre, reputación anti-Sybil) en Base/Ethereum, claves de sesión delegadas por el owner (EIP-712), registro Sui, pruebas ZK de humanidad (World ID / Self.xyz). - Gasless: transferencias de stablecoins a nivel de protocolo en Sui (gas 0, construidas en BCS propio), EIP-3009 (X-PAYMENT / relayer) y ERC-4337 v0.7 con paymaster en EVM, gas gratuito en SKALE; Seal/MPC como firmante externo.
- Auditoría encadenada por keccak (
trust audit-log --verify) con anclaje on-chain opcional. - MCP:
trust_verify_identity,trust_check_permission,trust_execute_gasless,trust_get_audit_log,trust_get_policies;tools/callaplica la política con_trust. REST:/api/trust/policies|identity|audit,POST /api/trust/verify(token de confianza) yPOST /api/trust/execute;X-Trust-TokenenPOST /api/call. Navegador:window.__WEBMCP_TRUST__. - CLI
webmcpcss trust networks|policies|set-policy|verify-identity|check-permission|sign-proof|execute-gasless|audit-log|balance|injectymcp --serve --trust. - Criptografía propia (keccak, secp256k1, EIP-712, ABI, RLP, BLAKE2b, Ed25519, BCS) verificada byte a byte contra
ethers6 y@mysten/sui2.
Calidad
653 tests (+82) · cobertura del módulo ≈ 89 % · tests en vivo opcionales contra Base Sepolia y Sui testnet (WEBMCP_TRUST_LIVE=1) · lint, prettier y CodeQL en verde.
Documentación
docs/trust-layer.md · docs/trust-policies.md · docs/gasless-guide.md · docs/agent-identity.md · docs/audit-logs.md · docs/CLI.md (30 comandos) · examples/trust/.
PR: #21 · CHANGELOG: [1.3.0].
v1.2.1 — sitio responsive, referencia CLI y puppeteer 24
Versión de mantenimiento. Sin cambios de API. npm i -g webmcpcss@1.2.1
📱 Sitio web responsive
Auditado con Chrome real a 320 / 375 / 414 / 768 / 1024 / 1440 px (11 páginas + 58 previews de componentes): 0 desbordamientos (antes 33 combinaciones con scroll horizontal).
- Landing: menú hamburguesa accesible (< 1100 px), rejillas fluidas para 320 px, tabla de agentes con scroll, CTAs a ancho completo en móvil.
- Component Hub: código/comandos/tablas con scroll interno, editor apilado bajo la previsualización, botones «Copiar» a ancho completo, previsualización acotada al viewport.
- Componentes:
core-checkout-form1.0.1 y emulación MUI corregidas para móvil.
📚 Documentación
docs/CLI.md: referencia completa de los 29 comandos con todas sus opciones.- Enlaces rotos corregidos (hub, PROMPT, good-first-issues); README (es) con los ejemplos en orden;
.env.examplecon todas las variables. SECURITY.md: versiones soportadas, notas del hub y aviso conocido denpm audit(extract-zip, solo afecta a la descarga de Chrome).
🧩 Sitio del hub
- El conversor Markdown reescribe enlaces
./guía.mda rutas del sitio y acepta cursiva_x_(tests nuevos, 571 en total).
📦 Dependencias y tooling
puppeteer23 → 24.43 (última rama compatible con Node 18), verificado con Chrome real.- Prettier cubre Markdown y workflows (bloques de código intactos);
CHANGELOG.mdincluido en el paquete npm.
Changelog completo: https://github.com/cochinoraptor/WebMCPcss/blob/main/CHANGELOG.md#121---2026-09-05
v1.2.0 — Component Hub
WebMCPcss 1.2.0 — Component Hub
📦 npm i -g webmcpcss@1.2.0 · 🌐 https://cochinoraptor.github.io/WebMCPcss/components/ · 🤖 https://cochinoraptor.github.io/WebMCPcss/api/components.json
Catálogo visual e interactivo de componentes IA-First (.webmcp.css + component.json) para Tailwind CSS, Bootstrap 5, Material UI, shadcn/ui y CSS puro: 58 componentes / 82 herramientas (botones, tarjetas, formularios, layout, animaciones e inteligentes). Sin dependencias nuevas.
Novedades
- Sitio del hub (GitHub Pages): inicio, catálogo con filtros por categoría/librería y búsqueda en vivo, favoritos, docs, y una página por componente con preview (escritorio/tablet/móvil), editor en vivo (color, radio, tamaño, animación), copiar código, comando de import, herramientas/contexto/animaciones y ejemplos
prompt/animate. Metawebmcp-hub, JSON-LD yapi/components.jsonpara agentes. - CLI
webmcpcss components:list,show,import(lock + fusión con marcadores en tu CSS),update,demo,publish(fork + PR al hub) ybuild. Funciona sin conexión con el catálogo incluido en el paquete. - MCP:
webmcpcss mcp --serve --hubañadelist_components,get_componenteimport_component(+GET /api/componentsen modo HTTP). - API:
import { hub } from 'webmcpcss'(listComponents,importComponent,updateComponents,buildHubSite,buildDemoSite,callHubTool…). - Incluye todo lo de 1.1.0 (no publicada en npm): módulo
standard(document.modelContext+ API declarativatoolname/tooldescription) y comandowebmcpcss standard scan|compile|check.
Corregido
mcp --no-prompt/--no-animateno desactivaban los ejecutores.
Dependencias
- Dev tooling actualizado (ESLint 9 flat config, Vitest 3, jsdom 26, TypeScript 5.9);
commander13.1. Se mantienenchalk4 y soporte Node ≥ 18.
Changelog completo: https://github.com/cochinoraptor/WebMCPcss/blob/main/CHANGELOG.md · PRs: #16, #17, #8–#12.
v1.0.1 — Las diez ideas innovadoras
1.0.1
Corregido
import { design } from 'webmcpcss'funciona como documentan el README y
docs/design-to-webmcp.md:designes un alias del namespace
designToWebmcp(que se mantiene).
1.0.0 — Las diez ideas innovadoras
Las diez ideas innovadoras: diez módulos independientes que convierten
WebMCPcss en una plataforma completa para sitios nativos de IA. Sin
dependencias nuevas (Node nativo http/zlib/crypto/fetch, Puppeteer ya
presente; ethers como peer opcional cargado dinámicamente; Figma y LLM por
fetch + variables de entorno). 116 tests nuevos (515 en total), cobertura
80 % en cada módulo. Guías en
docs/y salidas reales enexamples/v1/.
Añadido
- IA-First Framework (
src/framework/): componentesIAButton,IAForm,
IACard,IANav,IAHero,IAGridconwebmcp-component,
webmcp-intent: submit|cancel|navigate|action|read,
webmcp-confirmation: needed|none(la post-condición pasa a
webmcp-confirmation-selector) ywebmcp-accessibility;renderComponent,
validateIaFirst,initProject,assist(heurístico o LLM). CLI
webmcpcss init [--framework ia-first|minimal]ywebmcpcss assist "<petición>". - Design-to-WebMCP (
src/design-to-webmcp/):analyzeImage(LLM con
visión),analyzeFigma(REST API),analyzeDescription(heurística ES/EN);
generateFromDesign(contrato + andamiaje + mapping),validateDesign
(ok|missing|moved|relabeled, puntuación),optimizeToolMap
(nombres, descripciones, selectores, confirmaciones, formatos,
iaFriendlyScore). CLIdesign analyze|validate|optimize. - Retro-WebMCP (
src/retro/):scanLegacyHtml(13 señales legacy,
legacyScore, selectores estables con prioridad id > data > name > title >
href, fingerprints, notas),enhanceRetroWithLlm; proxy de compatibilidad
(createRetroProxy: descompresión gzip/deflate/br, inyección de
<link rel="webmcp">/<meta>/script, reescritura de URLs absolutas y
protocolo-relativas y deLocation, rutas/.webmcp/webmcp.css,
/.webmcp/graph.json,/.well-known/webmcp.json); inyector
(buildRetroInjectScript→window.__WEBMCP_GRAPH__y
window.__WEBMCP_RETRO__,injectRetrocon Puppeteer); publicación
comunitaria (prepareRetroSubmission,publishRetro). CLI
retro scan|proxy|inject|publish. - A11y-MCP (
src/a11y/): 16 reglas WCAG 2.2 AA evaluadas en la página,
summarizeAudit(puntuación, por impacto y regla),passesThresholds,
correcciones declarativas (buildA11yToolMap/buildA11yCsscon
webmcp-accessibility,webmcp-a11y-rule,webmcp-a11y-impact),
buildA11yFixScript,buildA11yWorkflow. CLIa11y audit|fix(--min-score,
--fail-on,--ci). - Test-MCP (
src/testing/):buildTestPlan(existencia, parámetros,
confirmación, formato y ejecución segura),generateTests(Playwright TS /
Cypress JS),runTestPlanconpuppeteerProbe,toJUnit,
buildTestWorkflow. CLItest generate|run. - Version-MCP (
src/versioning/):createSnapshot(hash por tool,
presencia y huella con página),diffSnapshots(renombres, selectores,
parámetros, permisos, contexto; impacto SemVer ysuggestedVersion),
buildMigration/applyMigrationcon notas para agentes,verifySnapshot.
CLIversion snapshot|diff|migrate. - Doc-MCP (
src/doc/):buildDocModel(parámetros, pagos, permisos,
fragilidad, ejemplos CLI/MCP/REST/prompt),renderHtml(autocontenido, con
buscador, filtros y pestañas),renderMarkdown,renderLlmsTxt,
renderAgentsMd,generateDocs; servidor con recarga
(createDocServer/startDocServer). CLIdoc generate|serve. - Security-MCP (
src/security/):webmcp-permissions: read-only|restricted|full,webmcp-requires: none|auth|oauth|jwt|session,
webmcp-scope,webmcp-risk,webmcp-rate-limit;inferPermissionLevel,
policyFor,authorizeTool,filterToolMapForAgent,validateSecurity
(hallazgosinvalid-permissions,underdeclared,payment-without-auth,
full-without-confirmation,write-without-auth,
selector-inline-handler…),suggestPolicies(overlay parseable), JWT HS256
sin dependencias (createAgentToken/verifyJwt),agentFromHeaders. CLI
security validate [--agent --suggest --suggest-output --strict]y
security token. - Recommender-MCP (
src/recommender/):recommend(goal, map)con
sinónimos ES/EN por raíz compartida, extracción de parámetros, puntuación
por nombre/descripción/parámetros, ajuste por historial por host,
penalización de acciones sensibles no solicitadas, login primero;
refineWithLlm,recordOutcome. Historial: eventosrecommendypayment
y bucketsrecommendations/paymentsencomputeStats. CLIrecommend. - Web3-MCP (
src/web3/):webmcp-payment: required|optional|none,
webmcp-network(nombre o chainId, sin restricción),webmcp-amount,
webmcp-pay-to,webmcp-payment-protocol: x402|onchain;NETWORKS(8
redes con USDC),AgentWalletcon límitesperTx/perSession/perDay/
receptores/redes; micropagos x402 (buildX402Requirements,
signX402AuthorizationEIP-3009,createPaymentGate,
createLocalFacilitator,X402Client);buildWalletConnectorScript
(MetaMask/WalletConnect,eth_signTypedData_v4,eth_sendTransaction);
getBalance/sendPayment/deployContractconethersopcional
(setEthersModulepara pruebas); contrato de referencia
WebMCPPayments.sol;validatePayments. CLIweb3 validate|balance|pay|deploy. - CLI (
src/cli-v1.ts): todos los comandos anteriores; con--jsonsolo
el JSON va a stdout. - API:
src/index.tsexporta los namespacesframework,design,
retro,a11y,testing,versioning,doc,security,recommender,
web3. - Parser: las propiedades
webmcp-*no reconocidas se conservan en
meta;webmcp-confirmation: needed|noneva ameta.confirmationy el
selector de post-condición awebmcp-confirmation-selector. - LLM:
LlmRequest.imagespara modelos con visión. - Documentación:
docs/ia-first-framework.md,design-to-webmcp.md,
retro-webmcp.md,a11y.md,testing.md,versioning.md,
doc-generation.md,security.md,recommender.md,web3.md. Ejemplos:
examples/v1/(contrato de tienda,regen.shy la salida de los diez
módulos). - CI: smoke test de los comandos v1.0.0 sin navegador y comprobación de que
examples/v1/está al día.
Cambiado
webmcp-confirmationadmite ahoraneeded|noneademás de un selector
(compatibilidad total: los selectores siguen funcionando como antes).
Notas
- «NanoCrawl» de la especificación se implementa como perfil x402/USDC
(HTTP 402 + autorización USDC firmada sin gas para el agente); ver
docs/web3.md.
📦 npm install -g webmcpcss · 🌐 https://cochinoraptor.github.io/WebMCPcss/ · 📚 Guías · 🧪 516 tests · 0 dependencias nuevas
v0.6.1 — Community Styles reales e índice para agentes
🌍 Community Styles reales + índice para agentes
✨ Novedades
- Definiciones comunitarias verificadas en vivo (selectores comprobados contra el HTML real el 2026-09-02):
wikipedia.org— buscar, cambiar idioma del portalen.wikipedia.org— buscar, menú de idiomas, contextoarticleTitlenews.ycombinator.com— buscar (Algolia), newest, submit, loginmercadolibre.com.co— búsqueda de productos 🇨🇴- Wikipedia y HN se re-validan automáticamente en cada CI con Puppeteer (
@validate-url).
community-styles/index.json— los agentes descubren todos los dominios disponibles con una sola petición HTTP. Connpm run build:community-indexy check de frescura en CI.- Gobernanza:
CODE_OF_CONDUCT.md,SECURITY.mdy plantilla de PR con checklist para estilos comunitarios. package.jsonconhomepageybugs(mejor página en npm).
🤖 Consumo por agentes
curl -s https://raw.githubusercontent.com/cochinoraptor/WebMCPcss/main/community-styles/index.json
webmcpcss run https://www.wikipedia.org community-styles/wikipedia.org.webmcp.css search --args '{"query":"WebMCP"}'204 tests · Node 18+ · MIT
Changelog completo: CHANGELOG.md
v0.6.0 — Generación desde código fuente y publish comunitario
🧩 Generación desde código fuente + publicación comunitaria
✨ Novedades
generate <ruta> --from-source— genera el.webmcp.cssdirectamente desde tus componentes React (JSX/TSX), Vue (SFC), Svelte y HTML, sin navegador ni deploy: extrae elementos interactivos (tags + handlersonClick/@click/on:click), usa solo atributos literales, agrupa inputs como parámetros y avisa qué elementos necesitanid/data-tool. Ideal como linter en CI. Guía completa.publish <css> --domain <dominio>— publica tu definición al repositorio comunitario con PR automático: valida el archivo, hace fork, crea rama, subecommunity-styles/<dominio>.webmcp.cssy abre el Pull Request (API de GitHub, fetch nativo). Sin token, imprime los pasos manuales.- Badges de npm en el README y borradores de anuncio en
docs/ANNOUNCEMENT.md.
📦 Instalación
npm install -g webmcpcss
webmcpcss generate ./src/components --from-source -o webmcp.css
webmcpcss publish webmcp.css --domain mi-sitio.com197 tests · cero dependencias nuevas · Node 18+ · MIT
Changelog completo: CHANGELOG.md
v0.5.0 — Integración universal para agentes IA
🤖 WebMCPcss ahora habla con 40+ agentes IA
La versión más grande hasta la fecha: cualquier agente (Claude, Cursor, CrewAI, AutoGen, LangGraph, ChatGPT Atlas...) puede generar, validar, reparar y ejecutar herramientas .webmcp.css — sin permisos del sitio objetivo.
✨ Novedades
generate --auto— genera el.webmcp.csssin grabación: escaneo headless de formularios/botones/campos, nombres inferidos (login,search...), detección de framework (React, Next, Vue, Svelte, Angular, MUI, AntD, Bootstrap, Tailwind) y selectores estables (data-*→id→name/aria-label).mcp --serve— servidor MCP real por stdio (JSON-RPC 2.0:tools/list,tools/call,resources/*) compatible con Claude Desktop/Code, Cursor, Goose, Windsurf...; con--http, API REST (GET /api/tools,GET /api/graph,POST /api/call). Con--url,tools/callejecuta de verdad con navegador headless.export --format <fmt>— 8 exportadores:mcp-config,claude-code(plugin con comandos slash),cursor,crewai,autogen,langgraph,browser-inject(window.__WEBMCP_GRAPH__) yjson-schema.run— ejecuta una herramienta y devuelve JSON puro (lo que invocan los módulos Python generados).- Docs: tabla de 45 agentes soportados + 10 guías en
docs/agents/+ ejemplos generados enexamples/agents/.
🐛 Arreglado
serializeToolMapgeneraba CSS inválido con triggers que contenían pseudo-clases (on form:nth-of-type(2)); ahora se citan correctamente.
📦 Instalación
npm install -g webmcpcss
webmcpcss generate https://tu-sitio.com --auto -o webmcp.css
webmcpcss mcp --serve --css webmcp.css --url https://tu-sitio.comSin dependencias nuevas · 180 tests · Node 18+ · MIT
Changelog completo: CHANGELOG.md