Square
集成Square API,提供托管的OAuth认证管理。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Square。 它的用途是:集成Square API,提供托管的OAuth认证管理。 完整的 Skill 内容见:https://321skill.com/skills/square-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把上个月的所有Square交易记录导出为CSV文件。’,它会使用你已授权的Square连接,自动调用Transactions API获取数据,并整理成结构化的表格文件供你下载。或者,当你说:‘检查一下店铺里库存低于10件的商品有哪些?’,它会查询Square的库存目录,并列出需要补货的商品清单。
介绍
这个Skill解决了开发者或管理员在应用中集成Square支付和管理API时,需要手动处理复杂的OAuth认证流程和权限管理的痛点。它通过托管的OAuth服务,自动化了授权码获取、令牌刷新和连接管理,让开发者能更专注于业务逻辑。
使用方式很简单:安装此Skill后,在需要调用Square API的地方,它会引导你完成与Square账户的授权连接。连接建立后,Skill会负责维护OAuth令牌的有效性,你只需提供连接ID和API请求参数,它就会自动处理认证并调用对应的Square接口。
它非常适合需要处理Square交易、库存、客户数据或员工管理的电商运营、后端开发者和财务人员。无论是构建在线商店、开发内部管理工具,还是自动化财务对账流程,这个Skill都能简化与Square平台的集成工作。
使用建议:始终遵循最小权限原则,仅请求业务必需的作用域(scopes)。在每次发起请求前,务必确认使用的连接ID是正确的,以避免操作错误的商家账户。对于不再使用的连接,应及时在Skill中或Square开发者后台撤销授权,以保障账户安全。
核心特点
与同类集成工具相比,它核心提供了托管的OAuth生命周期管理,自动处理令牌的刷新和存储,开发者无需自行搭建和维护OAuth服务器。同时,它明确强调并引导实施最小权限和连接验证的安全最佳实践。
注意事项
不适合仅需一次性或简单读取Square公开数据,而不需要进行账户管理和写操作的场景。
常见问题
这个Skill能管理多个Square店铺吗?
可以,它可以创建和管理多个OAuth连接,每个连接对应一个Square商家账户,但需要分别授权。
安装后如何撤销Square授权?
可以在Skill提供的管理界面中移除对应连接,或直接前往Square开发者后台的“已连接应用”列表撤销访问权限。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/square-x/raw/index.md 读取 Square 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/square-x/raw/index.md(查看排版版本)