Coupler.io 业务分析技能包
让 AI 助手基于 Coupler.io 实时业务数据,按可复用的流程完成营销、销售、财务与电商分析。
- Star 数
- ★ 39
- 最近更新
- 今天
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 33/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配ChatGPT · Claude Code · Claude.ai
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 市场投放负责人想知道上周 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 的报告,并做算术、单位、结论与数据一致性的二次校验。
- 市场投放负责人想知道上周 Google Ads ROAS 为什么下滑、哪些预算被浪费。
- 电商运营需要按产品、变体、库存与折扣码拆解 Shopify 销售,并预测断货时间。
- 销售管理者要查看管道覆盖率、各阶段转化落差以及不同销售的成交周期。
- 财务团队需要解释本月 P&L 变化、计算现金跑道或拆解 MRR/ARR 变动。
- SEO/内容团队要找出排名接近首页的查询、判断新页面索引速度或诊断自然流量骤降。
- 在 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?
查看各维度的扣分理由
README 说明技能依赖 Coupler.io MCP 服务器访问实时业务数据,但未说明最小权限范围、写操作(如创建/配置 dataflow)是否需要用户确认、数据流向何处、敏感业务数据如何处理。存在创建和配置 dataflow 的能力,但无回滚或撤销说明,故 rollback 记 0。依赖仅见 pyyaml 与 GitHub Actions,无漏洞证据,但无依赖安全说明,记 1。来源归属仅 README 提及 Coupler.io,无逐条数据来源标注。
README 结构自洽,技能描述与目录一致,但无失败处理、错误消息或降级路径说明,failure_messages 记 0。依赖可用性仅体现为 MCP 服务器与 Coupler.io 账户前提,未验证,记 1。
面向营销、销售、财务、电商等场景覆盖充分,audience_and_scenarios 记 2。能力边界有部分说明(如 LinkedIn 无小时拆分、Amazon 单一销售基准),但整体边界与触发精度依赖各 SKILL.md,本次仅见 README,记 1。环境适配仅说明需 Coupler.io 账户与 MCP,记 1。
README 信息架构清晰,含目录、技能库、安装、示例问题,记 2。安装说明含 marketplace 与 plugin 命令,记 2。命名稳定一致,记 2。示例问题仅标题列出,未见具体内容,记 1。已知限制零散提及但无专门章节,记 1。MIT 许可证完整,记 2。无版本号或变更日志,记 0。维护责任仅见 Contributing 标题,无明确责任方,且发布者未经验证,记 1。
输出可用性依赖各 SKILL.md 的具体产出格式,README 仅描述用途,记 1。边际价值在于结构化分析工作流,但需 Coupler.io 付费账户与 MCP,成本较高,记 1。成本效益因需账户与令牌消耗(README 自述插件按技能数消耗 token),记 1。
README 声明多为功能描述,无逐条可追溯来源,claim_traceability 记 1。无跨源佐证材料,记 0。事实与推断分离在 README 中部分体现(如明确 GA4 only、LinkedIn 限制),记 1。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 技能可创建和配置 Coupler.io dataflow,但未见写操作的用户确认或回滚机制说明。
- 依赖 Coupler.io MCP 服务器与付费账户,数据流向与敏感业务数据处理未在 README 中说明。
- 发布者身份未经验证,维护责任与更新路径不明确。
- 无版本号或变更日志,难以追踪技能行为变化。
- 本次仅见 README、LICENSE 与 CI 工作流,各 SKILL.md 内容未提供,评估置信度低。