SuperAPI AI 工具集

square-automation

办公与效率

查看项目

更新于 10-16 01:27

技能介绍

用途:借助 Composio 的 Square 工具包,经 Rube MCP 自动化 Square 的支付处理、订单管理与发票操作。

前置条件:Rube MCP 需已连接(可用 RUBE_SEARCH_TOOLS);通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 square 的 Square 连接;每次先调用 RUBE_SEARCH_TOOLS 获取当前 schema。

设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API key;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 选择 toolkit square,若连接非 ACTIVE 则按返回的授权链接完成 Square OAuth,确认状态为 ACTIVE 再运行工作流。

核心能力:1) 列出与监控支付,可用 SQUARE_LIST_PAYMENTS 按 begin_time/end_time、location_id、sort_order、cursor 过滤,SQUARE_CANCEL_PAYMENT 取消待处理支付;2) 搜索与管理订单,先 SQUARE_LIST_LOCATIONS 取位置 ID,再用 SQUARE_SEARCH_ORDERS,可选 SQUARE_RETRIEVE_ORDER 与 SQUARE_UPDATE_ORDER;3) 门店位置,SQUARE_LIST_LOCATIONS 返回 id、name、address、status、timezone;4) 发票管理,SQUARE_LIST_INVOICES、SQUARE_GET_INVOICE、SQUARE_CANCEL_INVOICE。

使用要点:时间戳用 RFC 3339(如 2024-01-01T00:00:00Z);结果分页需跟随 cursor 直到缺失;更新订单与取消发票需提供当前 version,版本不符会返回 409;多数操作需 location_id,建议缓存位置 ID;金额以最小货币单位(如美元分)返回。

限制:仅待处理支付可取消,已完成支付需退款;仅 SCHEDULED、UNPAID、PARTIALLY_PAID 发票可取消,且取消不可撤销;Square API 有按端点限流,批量操作需退避;连接与 OAuth 状态必须为 ACTIVE。上述之外的信息暂未提供。