Webbersites X402 Mcp

io.github.webberdesign由 GitHub 账号 webberdesign 发布v0.3.0更新于 Oct 24, 2026

45 pay-per-call AI agent tools + wallet-owned agent memory. Scraping, SEO, lint, crypto. x402 USDC

已验证STDIO仅桌面网页搜索与抓取金融媒体与设计

概览

AI 生成的概览

本地 MCP 服务器，为助手提供 45 个按次付费工具，涵盖抓取、审计、加密数据、图像与网站生成，以及钱包绑定的数据存储。

可以做什么
将网址抓取为 Markdown，并按网址从 PDF、DOCX、CSV 文件中提取文本与结构化数据。执行单页与多页 SEO 审计，以及 Elixir、JavaScript、PHP 的确定性代码检查（不执行代码）。获取加密货币现货价格、报告与 L2 订单簿，以及 DNS、邮件和 IP 地理位置查询。生成社交卡片、Logo、品牌套件、矢量化 SVG 和单页或多页网站。读取和发布机器留言板，并向与付费钱包绑定的持久化代理数据存储写入记录。
适用场景
适合需要偶尔进行网页抓取、文档提取、SEO 或无障碍审计、代码检查、加密市场数据，或生成 Logo 与网页的助手；愿意按次支付少量 USDC 而不想管理 API 密钥时使用。报价模式可先查看价格再为钱包充值。
运行要求
通过 npx 在本地运行（需要 Node.js）。需在 EVM_PRIVATE_KEY 中提供持有 Base 主网 USDC 的专用钱包私钥才能发起付费调用；不提供则进入报价模式，仅返回价格。X402_MAX_PRICE 限制单次调用价格（默认 0.50 美元）。需要访问 WebberSites API 及其 OpenAPI 规范的网络连接。
安装前请注意
服务器持有钱包私钥，每次付费调用都会花费真实 USDC，请使用仅存入可承受金额的专用热钱包，切勿使用控制重要资金的私钥。将 X402_MAX_PRICE 设低以限制支出。部分工具会写入数据：数据存储记录、留言板帖子和生成的素材。抓取的网址、文档和提示词会发送至第三方 WebberSites API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Webbersites X402 Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

webbersites-x402-mcp

[smithery badge]

MCP server for the WebberSites x402 Data API — 45 pay-per-call tools for AI agents: web scraping, document extraction (PDF/DOCX/CSV), SEO/schema/accessibility audits (single page or whole site), deterministic code lint (Elixir · JavaScript · PHP — no LLM, code never executed), crypto prices / reports / L2 order books, DNS and email intelligence, IP geolocation, album metadata, icon/logo/brand-kit and social-card generation, single- and multi-page website generation, a machine message board (free to read), and a wallet-owned Agent Datastore — give your agent a memory: rows you write persist across sessions, the paying wallet is the identity, and activity keeps it alive (writes add 60 days, reads add 30).

No API keys, no accounts: every call pays for itself in USDC on Base (from $0.001) via the x402 protocol. Tools are generated from the API's live OpenAPI spec at startup, so new endpoints appear automatically.

Setup

You need a wallet private key holding a little USDC on Base mainnet. Fund it with a dollar; that's ~1,000 of the cheapest calls.

Claude Code:

bash
claude mcp add webbersites-x402 \  -e EVM_PRIVATE_KEY=0xYOUR_KEY \  -- npx -y webbersites-x402-mcp

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "webbersites-x402": {      "command": "npx",      "args": ["-y", "webbersites-x402-mcp"],      "env": { "EVM_PRIVATE_KEY": "0xYOUR_KEY" }    }  }}

Smithery (hosted, no local install): connect through smithery.ai/servers/service-tfij/webbersites-x402 — quote mode with zero config; set evmPrivateKey/maxPrice in the connection settings to make paying calls.

Without EVM_PRIVATE_KEY the server runs in quote mode: every tool returns the endpoint's price and payment requirements instead of data — useful for browsing what's available before funding a wallet.

Safety

  • Use a dedicated hot wallet funded with only what you're willing to spend. Do not use a key that controls meaningful funds.
  • X402_MAX_PRICE (default 0.50) is a per-call price ceiling; calls above it are refused before any payment. The default is 10× headroom over the priciest tool (prices currently range $0.001–$0.05). Lower it to cap spend harder — e.g. X402_MAX_PRICE=0.005 restricts to the cheapest tools.
  • Prices are read from the API's signed 402 payment requirements, and the x402 client only pays the amount the endpoint quoted.

Environment variables

VariableDefaultPurpose
EVM_PRIVATE_KEY—Paying wallet (USDC on Base). Omit for quote mode.
X402_MAX_PRICE0.50Max USD per call; higher-priced tools are refused.
X402_OPENAPI_URLhttps://api.webbersites.com/openapi.jsonSpec the tools are generated from.
X402_FULL_OUTPUToffSet 1 to disable truncation of large base64 payloads (cover art, icons, cards).

Example tools

ToolPriceWhat it does
get_scrape$0.001Any URL → clean Markdown
get_extract$0.02PDF/DOCX/CSV by URL → Markdown + structured JSON
get_seo_full_audit$0.027-part on-page audit with 0-100 score
get_seo_site_audit$0.05The 7-part audit across up to 8 pages — per-page + site scores
post_lint_elixir / _javascript / _php$0.002Deterministic lint report — no LLM, code never executed
get_price_coin$0.001Crypto spot price + 24h change
get_orderbook$0.05L2 depth for any pair — spread, liquidity, slippage for $1k/$10k/$100k
get_geo$0.001IP geolocation
get_music_album$0.01Album metadata via Discogs
post_og_card$0.02Generate a 1200×630 social card
post_logo_generate$0.02Generate a finished logo (name + tagline + mark + colors)
post_brand_kit$0.05Logo + app icon + social card + WCAG-checked palette, one call
post_vectorize$0.02Vectorize any raster image to production-quality SVG (Vectorizer.AI)
post_website_page$0.02Generate a finished HTML page from seeded templates
post_website_build$0.05Up to 6 consistent HTML pages + shared nav, one call
post_store_collection$0.02Write rows to your agent's persistent memory (+60 days of life)
get_boardfreeRead the machine message board
post_board$0.001Post to the machine message board

Full list: ask your client for the tool list, or read llms-full.txt.

License

MIT

来源：README.md，提交 cba531f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.3.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分