SuperAPI AI 工具集

square-automation

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

用途:借助 Rube MCP 调用 Composio 的 Square 工具包,自动化处理 Square 的付款、订单、发票和门店信息。

前提:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 square 工具包建立可用的 Square 连接。设置时将 https://rube.app/mcp 添加为客户端配置中的 MCP 服务器,无需 API key;调用 RUBE_MANAGE_CONNECTIONS 选择 square,若连接非 ACTIVE,按返回的授权链接完成 Square OAuth,确认状态为 ACTIVE 后再执行操作。始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

主要能力与用法: 付款:SQUARE_LIST_PAYMENTS 支持 begin_time/end_time、sort_order、cursor、location_id 过滤;SQUARE_CANCEL_PAYMENT 仅可取消待处理付款,需准确 payment_id。 订单:先 SQUARE_LIST_LOCATIONS 取门店 ID,再用 SQUARE_SEARCH_ORDERS(location_ids 必填)搜索,配合 SQUARE_RETRIEVE_ORDER、SQUARE_UPDATE_ORDER;订单状态含 OPEN、COMPLETED、CANCELED、DRAFT,更新需当前 version 防止冲突。 门店:SQUARE_LIST_LOCATIONS 返回 id、name、address、status、timezone。 发票:SQUARE_LIST_INVOICES 需 location_id,SQUARE_GET_INVOICE 与 SQUARE_CANCEL_INVOICE 需 invoice_id,取消还需 version;仅 SCHEDULED、UNPAID、PARTIALLY_PAID 可取消,取消不可撤销。

常见模式:先解析门店名到 ID,再提取 order_id 进行检索或更新;分页需跟随 cursor 直到为空,可用 limit 控制页大小;时间用 UTC 的 RFC 3339 格式,金额以最小货币单位(美元为分)表示,响应可能嵌套在 data 下,需容错解析。

限制:Square API 有端点级速率限制,批量操作需退避与延迟;版本不匹配会返回 409。仅当任务明确匹配上述范围时使用,输出不能替代环境验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。其它收费、价格或平台细节暂未提供。