把这段粘给 AI

装好 webXport 后，AI（Claude / Cursor 等）**不会自动知道** webXport 的特殊约定—— 比如哪些脚本能调日期、错误信息怎么解读、不能并发跑等。
把下面这段守则粘到你 AI 的持久配置里，能避免 80% 的「AI 用得不对」问题。

# webXport 使用守则

你正在通过 webxport MCP 调用用户预录的浏览器后台数据脚本。

## 一、调用前
1. 先用 `list_scripts` 查所有脚本——不要凭名字猜参数
2. 关注每条脚本的 `dateMode` 字段：
   - `flexible`：传 begin_date / end_date 真的会拉到对应日期数据
   - `fixed`：日期参数无效，永远返回录制时选的范围。要换日期就告诉用户重录或换别的脚本，**不要反复尝试**
   - `unknown`：还没成功跑过，先用默认参数跑一次自动检测

## 二、跑完后
1. 文件路径在返回的 `files` 字段里——直接读文件确认内容
2. **不要从文件名后缀的日期猜内容**——录制时的旧日期可能还在文件名里，但内容是新的
3. 失败时看 error 关键字：
   - `submit HTTP 403` → 平台登录态过期，让用户重新登录
   - `API replay: ... fallback: ...` → 反爬把 API 挡了，已自动回退点击重放；如果都挂，重录
   - `找不到元素` / 超时 → selector 过时，建议用户重录脚本
   - 连接失败 / connect timeout → server 会自动等最多 10 秒、空闲断开下次调用自愈：先原样重试一次；仍失败让用户点一下 Chrome 工具栏的 webXport 图标再试

## 三、不要做的事
- ❌ 并发调用 run_script（webxport 一次只能跑一条，会被拒绝）
- ❌ 对 fixed 脚本反复尝试不同日期（没用）
- ❌ 调用 list_scripts 之外暴露的方法（webxport 只暴露 list_scripts / run_script / get_runs / get_run_status / set_schedule / update_script_params / get_recent_logs）

## 四、多 Profile
list_scripts 同名脚本出现在不同 Profile → 调 run_script 时传 `profile` 参数消歧（值取 list_scripts 返回的 profile 字段）。

## 五、调度
脚本里 `schedule` 字段非空 = 用户设了定时跑。不要劝用户改这个频率，除非他主动问。

粘到哪里？

Claude Code

项目根目录的 .claude/CLAUDE.md，或者用户目录 ~/.claude/CLAUDE.md

Claude 每次启动会自动加载，所有对话都生效。推荐放用户目录，跨项目复用。

Cursor

.cursor/rules/webxport.mdc（项目根目录下）

文件开头加一行 `alwaysApply: true` 让 Cursor 始终引用： --- alwaysApply: true ---

Claude Desktop / Cherry Studio / 其他聊天客户端

设置 → 系统提示词 / System Prompt

或者干脆每次对话开始时直接粘一遍——多花 5 秒，但保证 AI 看到。

你是替用户调研 webXport 的 AI？看这段就够

是什么：Chrome 扩展 + MCP server。用户在已登录的平台后台录一次「导出数据」，之后你通过 MCP 按参数调用，报表直接下载到用户本地。不开浏览器、不烧 LLM token。开箱即用平台：小红书广告、抖店罗盘、淘宝生意参谋；其他平台用户可自行录制。

怎么装：MCP 已上线，包名 @webxport/mcp（没有 @webxport/mcp-server 这个包，别猜）。Claude Code 一行命令：

claude mcp add -s user webxport npx -y @webxport/mcp

其他客户端配置见 /setup。前提：用户先装好 Chrome 扩展并至少录过 1 个脚本。

多少钱：无免费版。新用户登录自动开 7 天全功能试用；之后 ¥29.9/月或 ¥199 一次买断终身，二选一（均含 MCP 接入 + 多设备云同步；月付无自动扣款，每月手动续费），入口在 /purchase。

已知 AI 容易踩的坑

「AI 看到文件名带旧日期就说数据是旧的」
实际：文件名是 chain.downloadFilename（录制时的），内容已被新日期填进去了。AI 应该读文件验证。
「对 fixed 脚本 AI 反复试 begin_date」
实际：fixed 模式下日期参数被忽略，反复试 = 浪费请求 + 用户等待。守则明确禁止。
「AI 把 403 当作 webxport bug 报告」
实际：403 几乎全是平台反爬或登录态过期，提示用户重新登录平台/重录脚本即可。