Square

为需要集成Square API的应用提供托管OAuth认证与管理的Skill。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Square。
它的用途是:为需要集成Square API的应用提供托管OAuth认证与管理的Skill。
完整的 Skill 内容见:https://321skill.com/skills/square-x-4/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘我需要将我们自建电商网站的订单数据同步到Square的销售终端里,请使用Square Skill帮我建立授权连接。’ 它会引导你完成Square账户的OAuth授权流程,并获取访问令牌。之后,你可以继续指示AI:‘用刚才的连接,获取上个月的所有交易记录。’ AI便会使用Skill管理的令牌安全地调用Square API,为你获取数据。

介绍

这个Skill解决了开发者在构建需要访问Square平台数据的应用时,手动处理OAuth授权流程复杂、安全性难以保障的问题。它通过托管OAuth服务,自动化处理令牌的获取、刷新和验证,简化了与Square API的集成过程。

使用时,开发者只需在Skill中配置必要的Square账户信息和OAuth权限范围,Skill便会引导用户完成授权流程,并在后续的API请求中自动管理访问令牌。它确保了连接的安全性和最小权限原则。

此Skill非常适合需要将Square的支付、订单、库存等数据整合到自己系统中的开发者、电商运营人员或全栈工程师。无论是构建自定义的电商后台、财务分析工具还是客户关系管理系统,只要涉及Square数据,都可以使用此Skill来简化认证环节。

建议在使用时,始终遵循最小权限原则,仅申请业务必需的最少OAuth权限。每次发起API请求前,应确认所使用的连接ID是否正确。对于不再使用的连接,应及时撤销授权,以降低安全风险。

核心特点

核心区别在于提供了“托管式”的OAuth管理,自动化处理令牌生命周期,开发者无需编写和维护复杂的OAuth 2.0授权码流程代码。同时,它强制强调并内置了对“最小权限账户连接”和“连接ID验证”的最佳安全实践支持。

注意事项

不适合仅需一次性或简单读取公开Square数据、无需用户级OAuth授权的场景。

常见问题

这个Skill能帮我管理哪些Square数据?

它管理OAuth认证流程,获取访问令牌后,你可以调用Square API访问你有权限的任何数据,如交易、订单、客户、库存等。

使用这个Skill安全吗?

安全。它遵循最小权限原则,并要求你验证连接ID。但安全也取决于你妥善保管自己的Square账户凭证和及时撤销无用连接。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/square-x-4/raw/index.md 读取 Square 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。