核心用法
Clawdeals 是一个文档型（docs-only）的 REST API 技能包，专为 AI Agent 设计，用于自动化操作 Clawdeals 平台的交易生态。技能包通过标准化的 HTTP 端点覆盖六大核心领域：
Deals（交易发现）：发布、投票、管理折扣信息，支持 NEW/ACTIVE 状态流转，具备防重复 URL 检测机制。
Watchlists（智能监控）：创建多条件监控列表，支持价格阈值、标签、地理半径等筛选条件，自动匹配新上架商品。
Listings（商品发布）：支持 DRAFT/LIVE/PENDING_APPROVAL 三种状态，包含完整的商品元数据管理（描述、价格、成色、类别）。
Offers（议价系统）：完整的报价-还价-接受工作流，自动创建买卖家对话线程，支持过期时间设置。
Transactions（交易履约）：成交后管理，包含联系人信息脱敏/揭示的审批流程（approval-gated）。
SSE 实时流：/v1/events/stream 提供 Server-Sent Events 支持实时状态推送。
显著优点
1. 零代码执行风险：纯文档型技能包，无脚本、无二进制、无安装钩子，彻底杜绝供应链攻击面
2. 企业级安全设计：强制幂等性键（Idempotency-Key）、OS 密钥链优先存储、令牌零日志策略
3. 防钓鱼机制：内置外部支付链接拦截、联系人揭示审批、链接内容自动脱敏（LINK_REDACTED）
4. 完整 OAuth 2.0 支持：主推荐 OAuth Device Flow（QR 码+用户码），降级至 Claim Link 流程
5. 精细化权限控制：最小权限原则（agent:read/agent:write），支持网络层白名单（app.clawdeals.com / localhost:3000）
潜在缺点与局限性
- 人工介入点较多：敏感操作（联系人揭示、高价值交易）强制进入审批队列，无法完全无人值守
- 时间窗口限制：交易（Deal）仅在 NEW 状态且无投票时可编辑/删除，操作窗口狭窄
- 速率限制严格：写入操作受 429 限制，高频自动化场景需实现退避重试
- 无离线能力：依赖实时 API 连接，无本地缓存或离线队列机制
- 仅限 Clawdeals 生态：非通用电商协议，无法对接 Amazon、eBay 等外部平台
适合人群
- AI Agent 开发者：需要为购物助手、比价机器人、交易自动化工具接入 Clawdeals 平台
- 电商运营团队：批量管理商品发布、价格监控、议价响应的自动化需求
- 安全敏感型企业：优先考虑供应链安全、凭证保护、操作审计的组织
- 个人高阶用户：熟悉 API 操作、需要定制化监控和交易流程的资深买家/卖家
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 凭证泄露 | 中 | 需严格遵循「永不打印令牌」规则，避免 CI 日志、聊天应用截图泄露 |
| 误操作交易 | 中 | 接受报价（accept）即时创建交易，无二次确认弹窗 |
| 审批延迟 | 低 | 联系人揭示等操作可能进入人工审批队列，影响自动化时效 |
| 幂等键冲突 | 低 | 重复使用相同 Idempotency-Key 导致 409 错误 |
| 钓鱼攻击 | 低 | 平台已内置多层防护，但仍需警惕第三方诱导执行本地命令 |