SuperAPI AI 工具集

b2c-cip

通用与其它

查看项目

更新于 10-16 01:14

技能介绍

用途:通过 CIP/CCAC 仓储数据分析销售、商品、支付、流量及 API/控制器表现,适合做趋势分析;当前记录与即时诊断应改用 SCAPI/日志。

使用面:优先用 MCP 的 cip_discover / cip_query,查询前读 skill://mcp/cip/SKILL.md 并传 skillRead: true,发现与配置检查无需门禁。命令行用于显式 CLI 请求、自动化或较大本地 CSV/JSON 导出。两者报表与配置相同,不要重复执行同一成功结果。MCP 限制 500 行/24 KB,截断即输出不完整;CLI 日期标志默认当前月,需按任务显式指定日期。

配置与权限:复用 dw.json、环境变量、实例选择与配置插件中的 tenantId、clientId、clientSecret;目标或权限不清时用 b2c setup inspect(掩码),缺值应询问而非猜测,勿读密钥文件或导出令牌。需要 Account Manager 客户端凭据,以及在其 tenant filter 包含目标租户的 Salesforce Commerce API 角色;不适用用户/SLAS/JWT 流程。可用 --tenant-id/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。

发现与执行:列出/搜索报表,查看所选报表参数。固定站点/日期范围,nsite_id 常形如 Sites-Example-Site,应在 ccdw_dim_site 中核实而非由 SCAPI 站点 ID 构造。示例: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;b2c cip tables --pattern "ccdw_aggr_sales%";b2c cip describe ccdw_aggr_sales_summary;b2c cip query --file ./query.sql --from 2026-09-01 --to 2026-09-07 --format csv > sales.csv。CLI 会替换 <FROM>/<TO> 日期占位符,MCP SQL 必须写 literal 日期。--format table|csv|json 控制输出。

限制:安全模式生效,CIP 即使 SELECT/元数据也用 POST;401/403 应核对凭据、角色与租户过滤;配额/超时则缩小窗口或查询,勿重试循环。资料未提供具体价格与平台细节。