核心用法
Stripe Skill 通过 Python 脚本直接与 api.stripe.com 通信，实现对 Stripe 账户数据的全面管理。用户可通过命令行查询 charges（交易）、customers（客户）、invoices（发票）、subscriptions（订阅）、payment_intents（支付意向）、refunds（退款）、products（商品）及 prices（定价）等资源。支持分页、状态过滤（如 active 订阅）、邮件搜索等高级查询，也可执行退款创建、客户信息更新等写操作。输出默认为格式化表格，支持 --json 获取原始 API 响应。
显著优点
- 直连官方 API：无第三方中间层，数据流经 Stripe 官方基础设施，降低泄露风险
- 功能覆盖全面：涵盖 Stripe 核心资源类型的读写操作，满足日常财务运营需求
- 环境隔离支持：通过
sk_test_与sk_live_密钥区分测试/生产环境，便于安全验证 - 输出灵活：表格便于快速浏览，JSON 便于程序化处理
潜在缺点与局限性
- 需妥善保管密钥：
STRIPE_SECRET_KEY具备账户完全访问权限，泄露可导致资金风险 - 无内置审计日志：操作记录依赖 Stripe Dashboard 或自行埋点，本地无留存
- 权限粒度粗：单一密钥模式，无法按资源类型或操作类型细粒度授权
- 无 Webhook 支持：仅支持主动查询，无法实时接收支付状态变更通知
适合人群
- 开发者或运维人员需批量查询/修复 Stripe 数据
- 财务团队需快速导出交易记录或对账
- 小型团队无自建 Stripe 管理后台，需命令行工具辅助运营
常规风险
- 密钥泄露：环境变量或脚本中硬编码密钥可能导致凭证外泄
- 误操作风险：退款、客户更新等写操作不可逆，需确认对象 ID 正确
- 数据合规：处理客户支付信息需符合 PCI DSS 及数据保护法规要求
- 速率限制：高频调用可能触发 Stripe API 限流，影响业务系统