Web Intel

Web Intel MCP

面向 Agent 的网络情报 MCP 服务，按调用付费。许可和额度由 KeyFlint 处理（离线 Ed25519 许可证检查 + 额度账本），在此仅用作计费后端。抓取失败会自动退款；无效输入会在扣费前被拒绝。

工具	额度	返回内容
read_url	1	主要内容，格式为整洁的 Markdown（移除导航栏、页脚和 Cookie 横幅）
page_metadata	1	标题、描述、规范链接、语言、robots、Open Graph、JSON-LD 类型、H1-H3、图片 alt 统计信息
extract_links	1	去重后的站内 / 站外链接及锚文本
tech_stack	2	框架、CMS、分析工具、支付、CDN/托管、安全标头
seo_audit	3	0-100 分、A-F 等级、16 项加权检查、排名前 5 的修复建议
compare_seo	每个 URL 3	对 2-5 个页面（你与竞争对手）进行排名；只对已抓取的 URL 计费
pricing, credits_balance	免费	价格表、剩余额度

价格可覆盖：WEB_INTEL_PRICES="seo_audit=5,read_url=2"。

安装

你只需要 KeyFlint 许可证（LIC-...）。网关 URL、公钥和结账链接均有默认值。

**Claude Desktop，一键安装：**从最新版本下载 web-intel-mcp-X.Y.Z.mcpb，双击并粘贴许可证。无需终端，也无需 JSON。

Claude Code：

claude mcp add web-intel -e KEYFLINT_LICENSE=LIC-... -- uvx web-intel-mcp

Cursor、Windsurf、Claude Desktop（JSON）：

{
  "mcpServers": {
    "web-intel": {
      "command": "uvx",
      "args": ["web-intel-mcp"],
      "env": { "KEYFLINT_LICENSE": "LIC-..." }
    }
  }
}

可选项：KEYFLINT_URL、KEYFLINT_PUBLIC_KEYS（未设置时从网关获取并缓存至 ~/.keyflint/keyring.json）、KEYFLINT_CHECKOUT_URL。

可视化卡片（MCP Apps）

在 Claude、ChatGPT、VS Code 和 Goose 中，每个付费工具和 credits_balance 都会在 聊天中呈现为交互式卡片：额度余额及充值条和购买按钮，或结果摘要（关键数据、问题、表格预览和 已扣额度）。该卡片是 ui://web-intel/card.html 资源，自包含且无需网络访问。其他客户端 仍会收到与之前相同的 JSON。

托管模式（卖家）

付费逻辑保留在你的服务端。一个进程可向多位买家计费；每个 请求都携带买家的许可证。

docker build -t web-intel .
docker run -p 8080:8080 \
  web-intel

买家通过 https://<host>/mcp（Streamable HTTP，无状态）连接，并使用 Authorization: Bearer LIC-...（或 X-License-Key）。缺失或伪造的许可证会返回 -32060。

每次调用的计费流程

1. 验证 URL（仅限 http/https）。输入无效：返回错误，不扣费。
2. 离线 Ed25519 许可证检查（keyflint-verify），缓存 60 秒。
3. 使用新的幂等键执行 POST /api/v1/quota/deduct。额度不足：返回 -32062 和结账链接。
4. 抓取并分析。如果发生任何失败：执行 POST /api/v1/quota/refund（使用相同的键），客户端会收到 isError。

安全性

拒绝向私有、环回和链路本地地址发送请求（每次重定向跳转都会检查）， 响应大小上限为 3 MB（WEB_INTEL_MAX_BYTES），超时时间为 15 秒（WEB_INTEL_TIMEOUT），最多重定向 5 次。 WEB_INTEL_ALLOW_PRIVATE=1 可禁用地址检查（仅用于测试）。

测试

使用伪造的 KeyFlint 额度网关、本地签名的许可证和本地测试站点进行端到端测试 （无需网络）：

pip install -e ".[test]"
python -m pytest -q

许可证

Business Source License 1.1。源代码可用；生产用途需要 KeyFlint 许可证（或必须用于非商业用途）。每个版本会在发布四年后变为 Apache 2.0。请参阅 LICENSE。