Square Automation 是一个基于 Rube MCP 与 Composio Square 工具包的自动化技能，用于处理 Square 的支付、订单、发票和门店位置相关任务。它面向需要通过自然语言或自动化流程管理 Square 业务数据的用户。
用途
该技能用于自动化 Square 支付处理、订单管理和发票操作。它覆盖四条核心工作流：支付列表与监控、订单搜索与管理、门店位置管理、发票管理。所有操作都通过 Rube MCP 暴露的 Square 工具完成，而不是直接编写 Square API 请求。
主要能力
支付方面，可通过 SQUARE_LIST_PAYMENTS 按时间范围和门店检索支付记录，并在需要时用 SQUARE_CANCEL_PAYMENT 取消待处理支付。订单方面，可先用 SQUARE_LIST_LOCATIONS 获取位置 ID，再用 SQUARE_SEARCH_ORDERS 按日期、状态、履约类型等条件搜索订单，并用 SQUARE_RETRIEVE_ORDER 查看详情、用 SQUARE_UPDATE_ORDER 修改订单状态或字段。位置方面，SQUARE_LIST_LOCATIONS 可列出所有可访问门店，返回 id、名称、地址、状态和时区。发票方面，可列出某门店的发票、查看发票详情，并取消已排期、未付款或部分付款的发票。
使用方式
使用前需满足两个前提：Rube MCP 已连接且 RUBE_SEARCH_TOOLS 可用；已通过 RUBE_MANAGE_CONNECTIONS 以 square 工具包建立活跃的 Square 连接。设置时把 https://rube.app/mcp 添加为 MCP 服务器即可，无需 API 密钥。随后确认 RUBE_SEARCH_TOOLS 有响应，调用 RUBE_MANAGE_CONNECTIONS 并指定 square 工具包，若连接非 ACTIVE 则按返回的授权链接完成 Square OAuth，并在运行任何工作流前确认连接状态为 ACTIVE。每次操作前应先用 RUBE_SEARCH_TOOLS 获取当前工具架构。
适用场景
适合需要批量查看支付历史、核对支付状态、按条件检索订单、维护订单信息、获取门店位置标识，以及管理发票列表与取消操作的业务场景。也适合把上述 Square 操作接入到自动化或智能体工作流中。
限制与注意事项
时间戳必须使用 RFC 3339 格式，例如 2024-01-01T00:00:00Z，所有时间均为 UTC。大结果集需要按 cursor 分页，直到 cursor 不存在或为空。只有待处理支付可取消，已完成支付需走退款流程；只有 SCHEDULED、UNPAID 或 PARTIALLY_PAID 状态的发票可取消，且取消后不可撤销。SQUARE_UPDATE_ORDER 和 SQUARE_CANCEL_INVOICE 需要当前 version 字段，版本不匹配会返回 409 Conflict。SEARCH_ORDERS 必须提供 location_ids，LIST_INVOICES 必须提供 location_id，因此通常需要先解析位置 ID。金额以最小货币单位表示（如美元为分）。Square API 存在各端点速率限制，批量操作应实现退避并加入适当延迟。响应数据可能嵌套在 data 键下，解析时应为可选字段提供回退处理。