Coupler.io 业务分析技能包

让 AI 助手基于 Coupler.io 实时业务数据,按可复用的流程完成营销、销售、财务与电商分析。

Star 数
★ 39
最近更新
今天
License
MIT
主语言
JavaScript

30 秒速览

运行形态
Agent 插件 / 技能MCP 服务器命令行工具
可在哪里用
兼容但需适配ChatGPT · Claude Code · Claude.ai
费用
有免费版,另有付费云服务
上手难度
中 · 需要几步配置
开始前需要
Coupler.io 账户Coupler.io MCP 服务器Shell / 命令行网络访问本地文件系统MCP Server
典型场景
市场投放负责人想知道上周 Google Ads ROAS 为什么下滑、哪些预算被浪费。
不适合
  • 没有 Coupler.io 账户或未连接其 MCP 服务器的团队
  • 希望完全脱离第三方 SaaS 在自己的数据仓库内闭环分析的团队
  • 只需要通用数据分析、不涉及营销/销售/财务/电商指标的团队

这个 Agent 能做什么,适合哪些场景?

这是 Coupler.io 官方维护的一套 AI Agent 技能(Skills)仓库,覆盖营销与 PPC、销售、财务、电商、SEO、GEO 以及 Black Friday 等业务场景。每个技能以 SKILL.md 形式描述完整的分析流程,通过 Coupler.io MCP 服务器读取实时数据:先用 list-skills 和 get-skill 加载流程,再用 list-datasets、get-schema、get-data 等工具发现数据集、检查字段并执行 SQL 查询。技能本身只定义“如何分析”,数据访问与执行由 MCP 工具承担,最终产出结构化、经校验的报告。仓库还包含 cap-ability 类共享模块(如 get-started、create-dataflow、report-generation)和工具类技能(如去除 AI 写作痕迹、构建实时仪表盘)。安装方式是通过 Claude Code 插件市场或把技能目录复制到 .claude/skills/,并按业务插件分别安装以控制上下文开销。

技能以目录形式组织,每个目录含一份带 YAML frontmatter 的 SKILL.md,frontmatter 使用 name、description、metadata 等字段(含 short_description、category、sources),并由 generate_skill_index.py 生成为机器可读的 skills-index.json。运行时技能调用 Coupler.io MCP 暴露的工具:list-skills / get-skill 取流程,list-templates、list-integrations、list-credentials、list-datasets、search-datasets 做发现,get-integration、get-integration-field-options、get-dataflow、get-schema、get-data 做检查,create-dataflow、create-dataflow-source、create-dataflow-destination、update-dataflow-source、update-dataflow-destination 做配置,run-dataflow 执行 preview 或 full 运行,update-dataset 保存数据集描述。以营销分析为例,ppc-analytics 会按平台分别追踪漏斗、以 CPA/ROAS 排序比较效果、检查预算节奏和素材疲劳,并避免跨平台混合转化数;google-ads-custom-gaql 在打包报表类型缺字段时构建 Custom GAQL 查询。report-generation 将分析结果整理为 TL;DR → Metrics → Context → Recommendations → Next Questions 的报告,并做算术、单位、结论与数据一致性的二次校验。

  1. 市场投放负责人想知道上周 Google Ads ROAS 为什么下滑、哪些预算被浪费。
  2. 电商运营需要按产品、变体、库存与折扣码拆解 Shopify 销售,并预测断货时间。
  3. 销售管理者要查看管道覆盖率、各阶段转化落差以及不同销售的成交周期。
  4. 财务团队需要解释本月 P&L 变化、计算现金跑道或拆解 MRR/ARR 变动。
  5. SEO/内容团队要找出排名接近首页的查询、判断新页面索引速度或诊断自然流量骤降。
  6. 在 Black Friday 等大促期间按天决定加投、削减或暂缓哪些广告活动。

如何安装或部署这个 Agent?

先准备一个 Coupler.io 账户并连接 Coupler.io MCP 服务器。在 Claude Code 中加入本仓库的插件市场并安装所需插件:

/plugin marketplace add coupler-io/skills
/plugin install coupler-finance@coupler-io-skills
/plugin install coupler-sales@coupler-io-skills
/plugin install coupler-ecommerce@coupler-io-skills
/plugin install coupler-marketing-ads@coupler-io-skills

每个业务功能是独立插件,按需安装;若安装提示需要激活,执行:

/reload-plugins

安装前可查看插件包含的技能数量与开销:

claude plugin details coupler-marketing-ads@coupler-io-skills

也可手动安装:把任意含 SKILL.md 的技能文件夹复制到项目的 .claude/skills/ 目录。团队可通过仓库的 .claude/settings.json 注册市场:

{
  "extraKnownMarketplaces": {
    "coupler-io-skills": {
      "source": {
        "source": "github",
        "repo": "coupler-io/skills"
      }
    }
  }
}

以上只注册市场,每个人仍需自行执行 /plugin install 选择插件。

如何使用这个 Agent?

安装后直接用自然语言提问,Claude 会根据技能描述自动触发,也可显式调用带命名空间的命令,例如:

/coupler-finance:finance-analytics

典型问题是“Why did Google Ads ROAS decline last week?”或“How many months of cash runway do we have?”。技能会按流程调用 MCP 工具,先用 SELECT * FROM data LIMIT 5 确认数据形状再查询。若要从零搭建数据管道,可用 get-started 与 create-dataflow 技能:选择集成、绑定凭据、连接源与目标,先跑 preview 再跑 full,并可选设置刷新计划。维护技能时修改 SKILL.md 的 frontmatter 后,用脚本重新生成索引:

python .github/scripts/generate_skill_index.py

提交前做校验:

python .github/scripts/generate_skill_index.py --check

这个 Agent 有哪些优点和局限?

优点
  • 技能按业务平台细分到单个问题(如 Google、Meta、TikTok、Microsoft、LinkedIn、Amazon 各有成套技能),并明确互相交接而非重复。
  • 对分析诚实性有明确约束,例如 PPC 技能不跨平台混合转化数、Amazon 技能每次运行声明统一归因窗口、不合计不同币种市场。
  • report-generation 提供通用报告结构与二次校验,检查算术、单位与结论是否与数据一致。
  • 按插件拆分安装并公开披露上下文成本(coupler-marketing-ads 约增加 15k tokens),让用户能控制会话开销。
  • frontmatter 只使用 Agent Skills 规范允许的六个顶层键,其他信息放在 metadata 下,便于跨运行时移植。
局限
  • 核心数据访问完全依赖 Coupler.io 的 MCP 服务器与账户,脱离该服务无法执行分析。
  • coupler-marketing-ads 插件捆绑 81 个技能,全量安装会显著占用每次会话的上下文。
  • 技能以英文撰写,非英语团队需要额外理解或改写。
  • 质量取决于 Coupler.io 中数据集与连接器(如 Google Ads、Shopify、Salesforce)的配置,仓库本身不含数据管道实现。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Coupler.io 业务分析技能包 当前 33 · 缺口较多 Agent 插件 / 技能免费版 + 付费版 ★ 39 今天 JavaScript ChatGPT · Claude Code · Claude.ai
WrenAI GenBI 53 · 缺口较多 命令行工具免费版 + 付费版 ★ 18k 2 天前 Python Codex · Claude Code
智析 Agent 60 · 存在缺口 桌面应用免费 + 模型费 ★ 2.6k 4 天前 JavaScript OpenAI API
Cube Core 59 · 缺口较多 自托管服务免费版 + 付费版 ★ 21k 今天 Rust —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
33/ 100 五分制 1.7 / 5
信任安全 8/29
可靠稳定 3/14
适用触发 8/18
规范维护 8/18
有效结果 4/13
证据核验 2/8
查看各维度的扣分理由
信任安全8 / 29 · 1.4/5

README 说明技能依赖 Coupler.io MCP 服务器访问实时业务数据,但未说明最小权限范围、写操作(如创建/配置 dataflow)是否需要用户确认、数据流向何处、敏感业务数据如何处理。存在创建和配置 dataflow 的能力,但无回滚或撤销说明,故 rollback 记 0。依赖仅见 pyyaml 与 GitHub Actions,无漏洞证据,但无依赖安全说明,记 1。来源归属仅 README 提及 Coupler.io,无逐条数据来源标注。

可靠稳定3 / 14 · 1.1/5

README 结构自洽,技能描述与目录一致,但无失败处理、错误消息或降级路径说明,failure_messages 记 0。依赖可用性仅体现为 MCP 服务器与 Coupler.io 账户前提,未验证,记 1。

适用触发8 / 18 · 2.2/5

面向营销、销售、财务、电商等场景覆盖充分,audience_and_scenarios 记 2。能力边界有部分说明(如 LinkedIn 无小时拆分、Amazon 单一销售基准),但整体边界与触发精度依赖各 SKILL.md,本次仅见 README,记 1。环境适配仅说明需 Coupler.io 账户与 MCP,记 1。

规范维护8 / 18 · 2.2/5

README 信息架构清晰,含目录、技能库、安装、示例问题,记 2。安装说明含 marketplace 与 plugin 命令,记 2。命名稳定一致,记 2。示例问题仅标题列出,未见具体内容,记 1。已知限制零散提及但无专门章节,记 1。MIT 许可证完整,记 2。无版本号或变更日志,记 0。维护责任仅见 Contributing 标题,无明确责任方,且发布者未经验证,记 1。

有效结果4 / 13 · 1.5/5

输出可用性依赖各 SKILL.md 的具体产出格式,README 仅描述用途,记 1。边际价值在于结构化分析工作流,但需 Coupler.io 付费账户与 MCP,成本较高,记 1。成本效益因需账户与令牌消耗(README 自述插件按技能数消耗 token),记 1。

证据核验2 / 8 · 1.3/5

README 声明多为功能描述,无逐条可追溯来源,claim_traceability 记 1。无跨源佐证材料,记 0。事实与推断分离在 README 中部分体现(如明确 GA4 only、LinkedIn 限制),记 1。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 技能可创建和配置 Coupler.io dataflow,但未见写操作的用户确认或回滚机制说明。
  • 依赖 Coupler.io MCP 服务器与付费账户,数据流向与敏感业务数据处理未在 README 中说明。
  • 发布者身份未经验证,维护责任与更新路径不明确。
  • 无版本号或变更日志,难以追踪技能行为变化。
  • 本次仅见 README、LICENSE 与 CI 工作流,各 SKILL.md 内容未提供,评估置信度低。
证据充分度:低 评估于 2026年10月29日 审查版本 fb46df192c5d
查看完整评分方法 →

常见问题

使用这些技能需要付费吗?
仓库以 MIT 许可开源,技能本身免费;但需要 Coupler.io 账户及其 MCP 服务器连接实时数据,Coupler.io 的账户与套餐条件需另行确认。
只能在 Claude Code 里用吗?
不是。README 说明技能可在 Claude、ChatGPT、Cursor 等主流 AI 工具中使用;任何连接到 Coupler.io MCP 服务器的助手都能加载,即使不安装插件。
为什么建议只装需要的插件?
每个技能的描述会在整个会话中保留在上下文里,插件成本与包含的技能数量成正比。coupler-marketing-ads 捆绑 81 个技能,约增加 15k tokens,而单技能插件只增加数百 tokens。
技能如何真正拿到数据?
技能只定义分析流程,实际通过 Coupler.io MCP 工具执行:list-datasets/search-datasets 找数据集,get-schema 看字段,get-data 用 SQL 查询,必要时用 create-dataflow 系列工具配置数据流。
我可以自己添加技能吗?
可以。修改 SKILL.md 的 frontmatter 后运行 generate_skill_index.py 生成 skills-index.json(不要手工编辑该文件),提交 PR 后 GitHub Action 会在合并到 main 时重新生成索引。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents