Skip to main content
Glama
orange_island_commerce_data

orange_island_commerce_data

橙岛跨境电商数据 MCP

读取卖家明确授权并导入的 JSON 报表,使用确定性公式完成订单、商品、库存、利润、广告、达人和客服分析。

当前能力

  • 版本:0.1.0

  • 传输:本地 stdio

  • 存储:SQLite

  • 工具:12 个

  • 外部平台写操作:无

  • 实时 API:未连接

Related MCP server: ecommerce-mcp-automation

工具

工具

作用

report_import

导入卖家授权的标准化 JSON 报表

report_list

查看已经导入的报表

product_metrics_get

按 SKU 汇总曝光、点击、订单、收入等指标

order_summary_get

汇总订单、销量、退款、客单价和国家

inventory_risk_detect

计算库存覆盖天数和补货风险

profit_calculate

计算贡献利润并指出缺少的成本字段

listing_audit

检查标题、图片、描述、价格和状态

ad_anomaly_detect

检测烧钱无收入、高 ACOS、低 CTR

creator_performance_get

计算达人 ROAS 和单均成本

customer_service_issue_summary

汇总客服类别、响应、解决时间和 CSAT

daily_operation_brief

使用各类最新报表生成每日经营简报

evidence_export

导出可交给经营底座 MCP 保存的证据结构

字段规范可通过 MCP Resource oi-commerce://schema 获取。

使用顺序

  1. 调用 report_import 导入一种标准化报表。

  2. 保存返回的 report_id。

  3. 将正确类型的报表交给对应分析工具。

  4. 检查返回结果中的 warning、null 和边界说明。

  5. 调用 evidence_export。

  6. 把返回结果交给 orange_island_core.evidence_add 长期留档。

  7. 改价、上架、投放、退款和采购仍需人工确认,并由获得平台授权的执行系统完成。

支持的报表

  • orders

  • products

  • inventory

  • ads

  • creators

  • service

详细字段见 报表字段文档。

运行与测试

npm ci
npm run check
node dist/index.js

默认数据库:data/commerce.sqlite。

安装到 Codex

codex mcp add orange_island_commerce_data -- \
  /usr/local/bin/node \
  /Users/borytan/Documents/Codex/proj_018_mcp_橙岛跨境电商数据/dist/index.js

安装后新开 Codex 任务。

边界

这个版本处理用户导入的数据,不等于已经连接 TikTok Shop、Amazon、Shopify、Shopee、Ozon 或其他平台。分析结果不能自动修改店铺、广告或订单。缺少字段时保留缺口,不补造成本和收入。

Available Tools

12 tools
ad_anomaly_detect广告异常检测A
Read-onlyIdempotent

根据用户设定的 ACOS 和 CTR 阈值检查烧钱无收入、高 ACOS、低 CTR 和有点击无订单。

Inputs: report_id (required), min_ctr, max_acos.

creator_performance_get达人效果汇总A
Read-onlyIdempotent

计算达人视频数、花费、收入、订单、ROAS 和单均成本。

Inputs: report_id (required).

customer_service_issue_summary客服问题汇总C
Read-onlyIdempotent

汇总客服问题类别、未关闭数量、首次响应、解决时长和 CSAT。

Inputs: report_id (required).

daily_operation_brief每日经营简报A
Read-onlyIdempotent

读取项目各类最新导入报表,生成订单、库存、广告和客服简报;缺失数据类型返回 null。

Inputs: project_id (required).

evidence_export导出经营证据B
Read-onlyIdempotent

把一个分析结果包装为可交给 orange_island_core evidence_add 的证据结构。

Inputs: summary (required), analysis (required), project_id (required), analysis_type (required), +1 more.

inventory_risk_detect库存风险检测C
Read-onlyIdempotent

根据库存、日销、在途和交期计算库存覆盖天数与补货风险。

Inputs: report_id (required), target_cover_days.

listing_audit商品刊登检查C
Read-onlyIdempotent

检查标题、图片、描述、价格和状态等基础刊登问题,不写回平台。

Inputs: report_id (required).

order_summary_get订单经营汇总C
Read-onlyIdempotent

汇总订单、销量、收入、退款、客单价和国家分布。

Inputs: report_id (required).

product_metrics_get商品指标汇总B
Read-onlyIdempotent

按 SKU 汇总曝光、点击、订单、销量、收入、CTR、转化率和客单价。

Inputs: report_id (required).

profit_calculate贡献利润核算C
Read-onlyIdempotent

使用报表中的真实收入、成本、物流、平台费、广告费和退款计算贡献利润;缺字段会明确提示。

Inputs: report_id (required).

report_import导入卖家报表B

把卖家授权的标准化 JSON 报表保存到本地。不会连接或写入外部平台。

Inputs: rows (required), platform (required), project_id (required), report_type (required), +3 more.

report_list查看已导入报表A
Read-onlyIdempotent

列出项目已经导入的报表元数据。

Inputs: project_id (required), limit, report_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 12 tools

    Disambiguation4/5

    每个工具大致针对不同方面,如报表导入/列表、产品指标、订单汇总、库存风险、利润计算、listing审计、广告异常、达人绩效、客服汇总、简报和证据导出,区分度较高。但 inventory_risk_detect 与 daily_operation_brief 可能都涉及库存,product_metrics_get 与 order_summary_get 在订单/销量上有轻微重叠,不过描述清晰,总体可辨。

    Naming Consistency3/5

    所有工具采用蛇形命名,但动词风格不统一,混合使用 get、detect、calculate、audit、summary、brief、export 等,且 daily_operation_brief 为名词短语,缺乏统一的 verb_noun 模式。虽可读,但一致性中等。

    Tool Count4/5

    12个工具对于电商数据分析服务器而言数量适中,每个工具都有明确职责,无冗余。范围涵盖导入、分析、导出等,没有过度膨胀或不足,处于合理区间。

    Completeness4/5

    覆盖了电商数据的核心领域:报表管理、产品/订单指标、库存风险、利润、listing审计、广告异常、达人绩效、客服汇总和简报,以及证据导出。缺少报表更新/删除或更细粒度的操作,但服务器定位为只读分析,核心流程完整,无重大缺口。

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables connecting to Shopify and Meta Ads through MCP tools to retrieve orders, revenue, COGS, and ad-performance metrics, and to generate a combined daily P&L and ad-performance spreadsheet.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects Amazon Seller Central and Amazon Advertising to any MCP client, with a settlement-accurate P&L underneath: every fee, refund and reimbursement as Amazon actually posted it, so contribution margin and breakeven are per product, per marketplace, per day. 107 tools spanning P&L, full Sponsored Products/Brands/Display management, Search Query Performance and Brand Analytics, inventory and for
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables unified management of Amazon Ads, Google Shopping, Meta, TikTok, and Shopify data, integrated with cross-border e-commerce workflows such as product selection, inventory, profit, and feed optimization.
      MIT