SuperAPI AI 工具集

pp-help-scout

编程与开发

查看项目

更新于 10-16 06:49

技能介绍

用途:通过 help-scout-pp-cli 以只读方式访问 Help Scout 收件箱 API,用于客服运营检查、数据导出、同步与分析,可供智能体工作流调用。

主要能力:涵盖 conversations(会话,支持按 ID 获取、v3 表示获取、列表)、customers(客户获取与列表)、mailboxes(邮箱获取与列表)、reports(会话、满意度、生产力指标)、tags、teams、users(含当前已认证用户)、webhooks、workflows 的查询。提供 which 命令将自然语言能力查询映射到匹配命令。

安装与验证:需先安装 CLI,可用 npx 安装:npx -y @mvanhorn/printing-press-library install help-scout --cli-only;验证:help-scout-pp-cli --version。若 npx 失败,可回退 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/help-scout/cmd/help-scout-pp-cli@latest。确保安装目录在 $PATH。

认证:运行 help-scout-pp-cli auth setup 获取获取令牌的 URL 与步骤(加 --launch 可打开 URL),再执行 help-scout-pp-cli auth set-token YOUR_TOKEN_HERE 存储,或设置 HELP_SCOUT_BEARER_AUTH 环境变量;用 help-scout-pp-cli doctor 验证。

使用方式:任意命令可加 --agent,等价于 --json --compact --no-input --no-color --yes。支持 --select 筛选字段、--dry-run 预览、本地 SQLite 离线同步/搜索、非交互执行。输出包裹在来源信封中,从 .results 取数据、.meta.source 判断 live/local。可用 --deliver 将结果输出到 stdout、file:<path> 或 webhook:<url>。支持命名 profile 保存与复用参数。退出码:0 成功、2 用法错误、3 资源未找到、4 需认证、5 API 错误、7 限流、10 配置错误。

适用场景:客服会话/客户/邮箱/团队/用户查询,报表指标读取,标签与工作流检查,agent 编排中的只读数据获取。

限制:本 CLI 为只读,不适用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息等会改变远端状态的请求。MCP 服务可按需安装:go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/help-scout/cmd/help-scout-pp-mcp@latest,并注册 claude mcp add help-scout-pp-mcp -- help-scout-pp-mcp。具体收费、价格与更多平台信息暂未提供。