SkuSync WebMCP SDK (v1.0.1)

目标：让任何电商网站用 1 行代码变成「AI 可读的结构化站点」。

SDK 只做两件事：

1. 自动扫描页面商品结构（JSON-LD / Shopify Liquid / microdata / meta / OG）
2. 自动注册工具，让 AI 代理可直接读取根目录下的标准文件（全部同源实时 fetch、零缓存）

不再内置任何转换逻辑（convertCSV、optimize 等全部移除），转换/优化交给 skusync.app 官网单独处理。

标准 ESM 引入（推荐）

<script type="module">
  import { initSkuSyncWebMCP } from 'https://esm.sh/skusync-webmcp-sdk@1';

  await initSkuSyncWebMCP({
    mode: 'auto',             // 'native' | 'bridge' | 'auto'
    autoRegister: 'readOnly', // 'readOnly' | 'off'（兼容 'on'）
    debug: false,
    whitelistForms: ['add-to-cart']
  });
</script>

自动初始化副作用入口（等价于原先 script 直接注入）：

<script type="module">
  window.skuSyncWebMCP = {
    mode: 'auto',
    autoRegister: 'readOnly',
    debug: false,
    whitelistForms: ['add-to-cart']
  };

  import 'https://esm.sh/skusync-webmcp-sdk@1/auto';
</script>

新工具列表（精简为 6 个，全部自动注册）

• skusync_getStructuredProducts —— 返回页面所有结构化商品数据
• skusync_getSitemap —— 返回 /sitemap.xml 内容
• skusync_getLLMsTxt —— 返回 /llms.txt 内容
• skusync_getRobotsTxt —— 返回 /robots.txt 内容
• skusync_getFeedXml —— 返回 /feed.xml 或 /products.xml（及常见变体）
• skusync_getSiteFile —— 通用工具（支持 llms-full.md、humans.txt、任意 *.html.md）

关键保证

• 全部工具：read-only（annotations.readOnlyHint=true）
• 全部同源文件：fetch 使用 cache: 'no-store' + Cache-Control: no-cache，零缓存，始终最新
• Tool description 均为静态字符串（防 tool poisoning）

发布到 npm（供 esm.sh 分发）

# 1) 安装依赖
bun install

# 2) 质量校验 + 构建
bun run prepublishOnly

# 3) 登录并发布
npm login
npm publish --access public

发布后可通过以下地址使用：

• https://esm.sh/skusync-webmcp-sdk@<major>
• https://esm.sh/skusync-webmcp-sdk@<major>/auto