技能 square-automation
💳

square-automation

安全

自动化 Square 支付和订单管理

简化 Square 支付处理和订单管理,无需手动调用 API。通过 Claude Code 自动化发票生成、支付跟踪和位置管理。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“square-automation”。 列出昨天的所有支付

预期结果:

找到 2024-01-15 的 23 笔支付:
- Payment #1A2B3C: $145.00 (已完成)
- Payment #4D5E6F: $89.50 (已完成)
- Payment #7G8H9I: $210.00 (待处理)

总计:$444.50

正在使用“square-automation”。 查找 Downtown 位置的订单

预期结果:

从 Downtown 位置检索到 47 个订单:
- Order #ORD-001: $350.00 (已完成)
- Order #ORD-002: $125.00 (进行中)
- Order #ORD-003: $75.00 (已完成)

位置 ID: L1234ABCD

正在使用“square-automation”。 显示所有业务位置

预期结果:

找到 3 个位置:
1. Downtown Store (L1234ABCD) - 活跃
2. Uptown Branch (L5678EFGH) - 活跃
3. Warehouse (L9012IJKL) - 未活跃

安全审计

安全
v1 • 2/25/2026

All static findings are false positives. The detected 'external_commands' patterns (57 instances) are Ruby/shell backtick syntax examples in markdown documentation, not executable code. The network detection is a documentation URL (https://rube.app/mcp) showing where to obtain the Rube MCP server. This skill is legitimate documentation for automating Square payment tasks with no executable code or security risks.

1
已扫描文件
182
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

支付对账

企业主可以自动列出和分析所有 Square 位置的每日支付,以对账账户并识别差异。

订单状态跟踪

支持团队可以按客户名称或日期搜索和检索订单详情,提供实时订单状态更新,无需访问 Square 仪表板。

发票工作流自动化

财务团队可以列出已调度和未支付的发票,取消无效发票,并导出发票数据到会计系统。

试试这些提示

列出最近支付
列出过去 7 天的所有 Square 支付。显示支付 ID、金额和状态。
按日期查找订单
搜索 'Main Street' 位置在 1 月 1 日至 1 月 31 日之间的所有���完成订单。显示订单 ID 和总金额。
取消待处理发票
查找本月发送给客户 'John Doe' 的未支付发票,并使用正确的版本号取消它。
多位置支付报告
检索 2024 年第一季度所有三个位置的支付。按位置分组并计算总额。自动处理分页。

最佳实践

  • 在��行工作流之前,始终先调用 RUBE_SEARCH_TOOLS 以获取当前工具架构
  • 初始检索后缓存位置 ID,避免冗余 API 调用
  • 所有日期范围筛选器使用 RFC 3339 时间戳格式(例如,2024-01-01T00:00:00Z)
  • 通过跟随游标值直到不存在来处理大型结果集的分页

避免

  • 不要尝试取消已完成的支付 - 应使用退款工作流
  • 避免在未先检索当前版本号的情况下调用 UPDATE_ORDER
  • 永远不要硬编码位置 ID - 始终通过 LIST_LOCATIONS 动态解析
  • 不要跳过分页处理 - 大型数据集将返回不完整的结果

常见问题

我需要 Square API 密钥吗?
不需要。此技能使用 Rube MCP 来处理 Square OAuth 身份验证。只需将 https://rube.app/mcp 添加为您的 MCP 服务器并完成 OAuth 流程。
我可以通过此技能处理新支付吗?
不能。此技能可以列出、取消和监控现有支付,但无法创建新的支付交易。请使用 Square 的结账流程进行新支付。
更新订单时为什么会出现 'version mismatch' 错误?
UPDATE_ORDER 需要当前版本字段。在更新之前,始终先使用 SQUARE_RETRIEVE_ORDER 检索订单���获取最新版本号。
如何找到我的位置 ID?
调用 SQUARE_LIST_LOCATIONS 检索所有位置。每个位置都有一个 'id' 字段(例如,'L1234ABCD'),您可以使用它来筛选订单和支付。
我可以取消已完成的支付吗?
不能。只能取消待处理的支付。对于需要撤销的已完成支付,请改用 Square 的退款流程。
当我有超过 100 个结果时会发生什么?
Square 会对��果进行分页。检查响应中的 'cursor' 字段并将���传递给下一个请求。继续直到游标不存在以获取所有结果。

开发者详情

文件结构

📄 SKILL.md