mcpField
B
b2c-cip

b2c-cip

github.com/salesforcecommercecloud数据与数据库5773 次安装今天更新
代码仓库

关于 b2c-cip

b2c-cip 技能介绍如何通过 MCP 或 `b2c` 命令行分析 Salesforce Commerce Insights 数据仓库报告与数据。它指导报告发现、限定范围的查询和结果解读，并区分趋势分析与当前记录及即时诊断。

主要功能

  1. 01发现报告及其参数
  2. 02运行报告和 SQL 查询
  3. 03检查相关表与列
  4. 04按站点和日期范围筛选
  5. 05结合覆盖范围解读指标

适用场景

  1. 01查看指定时段的销售趋势
  2. 02分析 SCAPI 延迟或错误率
  3. 03调查缓存命中率或客户端用量
  4. 04用自定义 SQL 调整报告

MCP 相关

该技能建议在可用时使用 MCP `cip_discover` 和 `cip_query`，并要求查询前阅读 MCP 技能说明。对于明确的命令行需求、自动化和较大的本地导出，则使用 `b2c` 命令行。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-cip

安装后在 Claude Code 中输入/b2c-cip确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
trigger-evals.json
references/
KNOWN_TABLES.md
SALES_ANALYSIS.md
STARTER_QUERIES.md

详细介绍

原文在翻译后有更新，译文可能不是最新。

CIP 分析

使用数据仓库分析了解趋势；查看当前记录并立即诊断时，使用 SCAPI/日志。如果 b2c 不可用，请使用 npx @salesforce/b2c-cli。

选择使用方式

  • 如果 MCP cip_discover / cip_query 可用，优先使用。查询前先阅读 skill://mcp/cip/SKILL.md，并传入 skillRead: true。 发现/配置检查不受限制。无需终端或导出令牌。
  • 对于明确要求使用 CLI、自动化或较大的本地 CSV/JSON 导出，使用 CLI。 MCP 结果上限为 500 行 / 24 KB；truncated 表示输出不完整， rowCount 统计返回的行数。CLI 的默认值有所不同：日期标志默认使用 当前月份，除非另行指定。请根据用户的任务设置明确日期。
  • 两种方式使用相同的报告和工具包配置。成功获取结果后，不要再用另一种方式重复运行。

配置和访问权限

复用从 dw.json、环境、实例选择和配置插件中解析出的 tenantId、clientId、clientSecret。只有在目标或访问权限不明确时，才使用经过掩码处理的 b2c setup inspect；缺少值时应询问，不要猜测。 正常分析请求无需读取密钥文件或导出令牌。

需要 Account Manager 客户端凭据，以及具有目标租户的租户筛选条件的 Salesforce Commerce API 角色。用户/SLAS/JWT 流程不适用。 覆盖项：

值CLI / 环境变量
租户--tenant-id（--tenant）/ SFCC_TENANT_ID
客户端--client-id / SFCC_CLIENT_ID
密钥--client-secret / SFCC_CLIENT_SECRET
分析主机--cip-host / SFCC_CIP_HOST
强制使用暂存分析--staging / SFCC_CIP_STAGING

以 _prd 结尾的租户会选择生产分析；其他租户则选择暂存分析。 显式配置的主机优先。暂存分析是一个目标，不是更改目标实例的指令。非生产环境的数据需要 26.1+ 版本的 Enable Reports & Dashboards Data Tracking。测试区域中的生产租户也可能需要暂存分析。 仪表板：https://ccac.stg.analytics.commercecloud.salesforce.com。

缺少配置/无法使用： 分析指南。 解析详情：b2c-cli/b2c-config。只阅读相关部分。

发现并执行

  1. 列出/搜索报告；检查所选报告的参数。MCP 报告详情还会提供表格和可用结果的说明。
  2. 确定站点/日期范围。数据仓库中的 nsite_id 通常类似于 Sites-Example-Site； 请在 ccdw_dim_site 中验证，不要根据 SCAPI 站点 ID 拼接。
  3. 运行报告。仅在需要调整或解决定义不明确的问题时预览 SQL。 自定义 SQL 需要了解表列时再检查列；避免穷举浏览。
b2c cip report list --category "Sales Analytics"
b2c cip report sales-analytics --describe
b2c cip report sales-analytics --site-id Sites-Example-Site --from 2026-09-01 --to 2026-09-07

# Existing report does not fit: inspect the relevant table, then adapt SQL.
b2c cip tables --pattern "ccdw_aggr_sales%"
b2c cip describe ccdw_aggr_sales_summary
b2c cip report sales-analytics --site-id Sites-Example-Site --from 2026-09-01 --to 2026-09-07 --sql

# Execute a reviewed query; CLI replaces <FROM>/<TO> date placeholders.
b2c cip query --file ./query.sql --from 2026-09-01 --to 2026-09-07 --format csv > sales.csv

原始 SQL 也接受位置参数查询或标准输入。MCP SQL 必须包含字面日期；占位符替换是 CLI 的功能。 重定向输出时请保留退出状态/错误信息。--format table|csv|json 控制报告/查询输出； --json 使用 CLI 的标准 JSON 封装。

选择技术报告

问题报告 / 限制
SCAPI 端点响应缓慢scapi-latency-distribution；直方图区间描述的是分布，而非精确百分位数
HTTP 失败scapi-error-rate-by-status --status-class 5xx
缓存效果scapi-cache-hit-ratio
集成客户端使用情况ocapi-client-usage
SFRA 控制器controller-health-scorecard、controller-error-rate-trend；必须指定站点

SCAPI 流量可能是无头流量或未分配流量。只有在确实要分析所有站点时，才省略可选的站点筛选条件；并说明范围。使用 --describe 查找准确参数，不要自行编造标志。所有示例都需要指定日期范围。

查询与解读

筛选日期和站点，并选择所需列；仅使用 LIMIT 并不能限制数据库工作量。优先使用汇总表，而不是事实表关联。计算某个时期的 AOV 时，使用收入总和 / 订单总和，而不是每日平均值。保留比率中的 null、缺失日期、币种、时区和覆盖范围限制。最新事件日期不代表数据摄取的新鲜度。

安全模式适用；即使执行 SELECT/元数据查询，CIP 也会使用 POST。不要绕过阻止操作。遇到 401/403 时，检查凭据、角色和租户筛选条件，但不要据此推断每次拒绝都是因为缺少角色。遇到配额限制/超时，缩小时间窗口或查询范围；不要循环重试。官方 访问权限和服务限制。

条件参考资料

仅在任务需要时阅读匹配的章节：

确认所请求的结果和重要限制后，即可停止。

评论

支持 Markdown