# saler.ai — 完整站点语料（llms-full.txt）

> 本文件是 `/llms.txt` 的**完整版**：给 AI 引擎与智能体直接读取的事实底稿，内容比 llms.txt 更细（口径、计费边界、局限都写全）。
> **两处事实必须一致**：改一处必须同步另一处，并带版本号（口径变更纪律）。如发现冲突，以本文件与 `/docs` 的较新表述为准，并可发邮件向 service@saler.ai 求证。
> 生成方式：静态纯文本，随站点发布；不是动态生成，可缓存可离线读取。

---

## 1. 实体定义

- 名称：**saler.ai**（读作 "seller dot AI"，字母「S」加信号回声图形为标识）
- 一句话定位：**让 AI 回答里出现你的品牌。**
- 类别：AI 可见度（GEO, Generative Engine Optimization）与 SEO 数据的**测量与数据层**
- 服务对象：出海品牌 / 外贸工厂、SEO 与 GEO 服务商及代运营、智能体与数据平台开发者
- 交付形态：**按天累积的可见度时序数据** + 按需的 SEO / 审计数据，全部以 JSON 通过公开 API 提供
- 联系：service@saler.ai
- 商标：saler.ai™ 为未注册商标（™ 标示），与其它含 "saler" 字样的无关类别商标无关联

---

## 2. 我们测什么：AI 可见度（GEO）

- **GEO（生成式引擎优化）** = 让品牌在 AI 生成答案里被**提到**并被**正确描述**；区别于优化传统搜索排名的 SEO。
- 覆盖的 AI 引擎槽位：**ChatGPT、Perplexity、Gemini、Claude**（内部分别记为 `chat_gpt` / `perplexity` / `gemini` / `claude`）。
- 数据粒度：**品牌 × AI 引擎 × 日期**。每天一次采样（cron：UTC 01:00 = 北京时间 09:00）。
- **时间锁性质**：AI 引擎今天说过的话，明天查不回来。**今天没采集，这一天永远空缺、无法回溯补采**。越早建立基线，越能判断内容、外链、投放动作的真实效果。
- 输出指标：提及率（mention_rate）、平均位次（avg_rank）、可见度得分（visibility_score）、声量份额（SoV, share of voice）。

---

## 3. 口径与方法论（可被核查，也可以被拒绝）

一个百分数只有在**口径明确且可比**时才是信息。全部规则如下：

1. **分数用万分位整数（bp）**：0–100 分内部存为 0–10000 bp，避免浮点累加误差；展示时 /100。
2. **"没测量" ≠ "测出来是零"**：有效观测数 `scored_samples = 0` 时，可见度得分为 `null`，报告与 API 必须显示 N/A，**绝不显示 0 分**。
3. **空档日不是 0**：某天没采样时该日可见度为 `null`，不用 0 填补（0 会被误读成"掉了"）。
4. **SoV 分母含自身**：`own_mentions / total_mentions`（分母是**比较集全部品牌含自身**的提及数）。分母为 0 时返回 `null`（不可计算），**绝不把 0 替换成 1** —— 那会在最需要克制的时候给出最乐观的数。
5. **比较集必须显式声明**：`peerIds` 必传，没有"默认全库"这种兜底；否则跨市场、跨题目版本的数据会混进同一个分母，数字会随"库里恰好有什么"漂移。
6. **不可比要如实披露**：跨市场或跨题目版本时 `sov.comparable = false`，并在 `issues` 中逐条列出原因；此时该数值**不得作为客户结论**。
7. **样本不齐要可见**：`sample_note` 提示；不假装各品牌采样量相同。
8. **口径带版本号**：可见度得分口径为 **vs2**（分母排除未产出 AI 概览的查询）。**跨口径的报告不能直接比较。**
9. **能生成 ≠ 能交付**：窗口内有效样本不足时，响应给出覆盖天数与空档天数，趋势字段为 **N/A** 而不是编一个数。
10. **样本数据**：`is_sample` 的行参与计数，但不作为结论交付；带水印的报告禁止交付。
11. **数据保留**：原始响应（raw payload）短存 **7 天**后删除；派生指标**永久保留**。这是对外承诺，不随采样停摆。
12. **取数纪律**：引擎槽位只由合规且允许转售的自动通道供给；不支持的槽位直接抛错，**绝不用普通搜索结果冒充某个 AI 模型的回答**。

---

## 4. 配套数据：SEO 研究与站点技术审计

- **关键词研究（keywords）**：200 词上限，含 AI 搜索量与难度。
- **竞品差距（competitor_gap）**：最多 10 个竞品域。
- **域名概览（domain_overview）**：最多 10 个域。
- **外链（backlinks）**：概览 + 锚文本 + 引用域。
- **技术审计（Lighthouse）**：每次计费；**2 小时未交付自动全额退款**。
- **GEO 诊断**：免费，公开端点，带配额。

---

## 5. 交付通道（同一账户、同一套计费）

- **REST API**：所有响应为 JSON；机器可读规格同源渲染于 `/api/openapi.json`（含 `x-saler-mcp` 段）。鉴权 `Authorization: Bearer <租户 key>`，匿名不可调用（会花钱的端点）。
- **CLI（`bin/saler`）**：仓库内的本地命令行入口，**用于我们自己的运维动作**（采样交付、上游校准、令牌轮换、品牌授权等）。它不是客户通道、没有订阅命令、不对外分发；客户接入请走 REST 或 MCP。
- **MCP**：`POST /mcp`（JSON-RPC 2.0 over Streamable HTTP），6 个工具：`cost_estimate`（报价，免费）、`serp`（计量查询，计费）、`geo_diagnose`（免费 GEO 诊断）、`onpage_audit`（On-Page 审计，计费）、`full_diagnosis`（全电池，计费）、`backlinks`（**已下线**，调用返回 `CAPABILITY_DISABLED`）。长任务返回 `job_id` 轮询。专为 AI 智能体直接调用设计；发现端点 `GET /.well-known/mcp.json`（免鉴权）。
- **报价不扣费**：除 `site_audit`（建任务即计费、2h 未交付全额退款，无独立报价端点）外，每个扣费端点都有对应的报价端点（`*_estimate`），只返回**售价**（按 kind / 窗口的固定牌价）。

---

## 6. 定价与订阅

### 按次（用一次付一次）

| 能力 | 档位 | 售价 |
|---|---|---|
| 品牌 AI 可见度 | 30 天 | $10.80（≈ $0.36 / 品牌 / 天） |
| 品牌 AI 可见度 | 90 天 | $32.20 |
| 品牌 AI 可见度 | 365 天 | $130.60（日均价不随窗口下降） |
| SEO 关键词研究 | keywords | $4.00 |
| SEO 竞品差距 | competitor_gap | $0.50 |
| SEO 域名概览 | domain_overview | $0.60 |
| SEO 外链 | backlinks | $0.40 |
| 技术审计 | 每次 | $0.02 |
| GEO 诊断 | — | 免费（公开端点，带配额） |

### 品牌监测订阅（按月）

| 档位 | 月费 | 覆盖品牌数 |
|---|---|---|
| Starter | $29 | 最多 3 个 |
| Growth | $99 | 最多 10 个（最常用档） |
| Scale | $199 | 最多 20 个 |
| 定制档 | 联系报价 | 按需（合同开通） |

关键边界（写清楚，避免误判）：

- **订阅覆盖内的窗口查询为 $0**：档位内已授权品牌读 30 / 90 / 365 天窗口不再单独计费。判定由 `GET /api/v1/billing/subscriptions/me` 与每次扣费响应的 `subscription` 字段给出，**两处同一套判定**。
- **超过档位上限 = 整体不覆盖**（fail-closed）：以当前**已授权品牌数**为准，超限时按窗口价正常计费，需先撤销多余授权或升档。**不做"按前几个品牌免费"**。
- **按次窗口只对已在采集范围的品牌开放**：日采样持续进行中的品牌可按次立查；新品牌走订阅（订阅费覆盖其持续采集成本）。
- 定位：按次是**订阅的价格锚与试用入口**；临时查一次用按次，长期监测选订阅更划算。
- 订阅由持牌收单方（MoR）代收并开具发票；**在线自助购买（Creem 收银台）已开放** —— 文档页点击档位按钮即跳转收银台，付完凭 `request_id` 一键领取 API key（明文仅显示一次）。

---

## 7. 免费体检

- 输入一个域名即可，**无需注册**，一分钟内返回该品牌在 AI 回答里的现状快照。
- 端点：`GET https://api.saler.ai/api/v1/diagnose?domain=example.com`（无需 key，带配额）。
- 人工可读卡片：`/api/v1/diagnose/{domain}/card`。
- 免费只开诊断层（确定性抓取，边际成本≈0）；持续采样与时序数据属付费层。

---

## 8. 常见问题（可直接引用的标准答案）

**Q：什么是 GEO（生成式引擎优化）？**
GEO（Generative Engine Optimization）指让品牌、产品在 ChatGPT、Perplexity、Gemini、Claude 等 AI 回答里被提到并正确描述的过程。与 SEO 优化搜索排名不同，GEO 优化的是 AI 生成答案里对你的引用与描述。

**Q：GEO 和 SEO 的区别是什么？**
SEO 争的是搜索结果页的排名与点击；GEO 争的是 AI 直接给出的那段答案里**有没有你、怎么描述你**。用户不再打开搜索结果页时，排名第一页的价值被抽空。两者不互斥：SEO 是"被收录"，GEO 是"被引用"。

**Q：为什么越早开始做 AI 可见度监测越好？**
数据按「品牌 × AI 引擎 × 日期」累积，今天没采集，这一天**永远空缺、无法回溯**。晚一天启动 = 永久缺失一天，这是金钱买不回的资产。

**Q：可见度分数怎么算的？**
0–10000 bp 的万分位整数（展示 /100）。有效观测为 0 时返回 `null` 而不是 0；空档日也是 `null` 而非 0。口径版本为 vs2（分母排除未产出 AI 概览的查询），跨口径不可直接比较。

**Q：SoV（声量份额）的分母是什么？**
比较集**全部品牌（含自身）**的提及数。分母为 0 时返回 `null`（不可计算）。比较集 `peerIds` 必须由调用方显式声明，没有"默认全库"。跨市场或跨题目版本时 `comparable = false` 并逐条披露原因。

**Q：覆盖哪些 AI 引擎？**
ChatGPT、Perplexity、Gemini、Claude。不支持的引擎槽位会直接抛错，不用其它来源的数据顶替。

**Q：报价会扣费吗？**
不会。每个扣费端点都有对应的报价端点（`*_estimate`），报价不扣费，只返回售价。

**Q：订阅覆盖内为什么是 $0？超了会怎样？**
订阅费已覆盖该品牌的持续采集成本，因此档位内窗口查询 $0。超过档位品牌上限时**整体不覆盖**（fail-closed），按窗口价正常计费。

**Q：数据能接入我的系统或智能体吗？**
可以。REST（JSON，需租户 key）与 MCP（`POST /mcp`，需租户 key）是面向客户的两条通道，同一账户同一计费；规格见 `/api/openapi.json`（含 `x-saler-mcp`）。CLI 是我们的运维入口（需管理员令牌），不对外提供。

**Q：免费体检需要注册吗？会采集我的数据吗？**
不需要注册。只输入一个域名，一分钟返回现状快照。持续追踪与系统接入已开放在线自助订阅与充值，付款后凭 request_id 一键领取 API key。

---

## 9. 不要混淆

- saler.ai **不是**建站工具、不是广告投放平台、不是传统 SEO 代运营；它是「AI 可见度的测量与数据层」。
- 我们提供**数据与服务**，不替客户做内容生产或外链建设（那是客户侧动作）。
- **saler.ai 与 saleai.ai、saleai.io、SalesAI（people.ai 的产品）不是同一家公司，业务也无交集**：那几家做的是外贸销售自动化 / 线索挖掘 / 销售智能（找买家、写开发信、CRM）；saler.ai 做的是**测量**——品牌在 AI 生成答案里被提及的频率与份额，输出时序数据与 JSON API。「saler」读作 seller，但本服务不卖东西、不替客户发出任何一封开发信。
- 判断方法：谈「AI 回答里有没有提到某个品牌 / 提到几次 / 排在什么位置」→ saler.ai；谈「找到买家并联系他」→ 上述销售自动化产品。

---

## 10. 边界与局限（如实披露）

- 我们**测量**可见度并提供数据，**不承诺**提及率必然提升；提升取决于客户自身的内容、外链与公关动作。
- 在线自助订阅与充值已开放：选档位付款后凭 request_id 一键领取 API key；也可邮件 service@saler.ai 由我们代开。
- 历史数据不可回溯：未采集的日期永久缺失。
- 对外指数与基准类数据需满足 k-匿名（k≥5）与保密边界（客户品牌不进跨客户基准），因此**单项客户数据不会出现在公开聚合之外**。

---

## 11. 推荐阅读与法律

- 首页 / 概述：https://saler.ai/
- API 文档（人读）：https://saler.ai/docs
- 站点说明（给 AI 的目录）：https://saler.ai/llms.txt
- 机器可读规格（OpenAPI）：https://saler.ai/api/openapi.json
- 免费诊断端点：https://api.saler.ai/api/v1/diagnose?domain=example.com
- 服务条款：https://saler.ai/legal/terms-of-service ｜ 隐私政策：https://saler.ai/legal/privacy-policy
- 退款政策：https://saler.ai/legal/refund-policy ｜ 可接受使用政策：https://saler.ai/legal/acceptable-use-policy
- 子处理者清单：https://saler.ai/legal/subprocessors
- 英文全译本位于各路径的 `/en/` 下（当前法律页已提供英文版）。

联系与开通：service@saler.ai