Amazon SP-API Skill
查询订单、库存、Listing、Reports、Finances、FBA 与 Feeds，不处理广告投放数据。
CLI + Skill for universal agents
紫鸟 Agent CLI
支持通用 Agent
调用跨境电商能力
支持 Claude Code、Codex、WorkBuddy 等可调用本地 CLI 与 Skills 的 AI Agent，通过紫鸟 ECO CLI（命令：zn-open-eco）接入 Amazon SP-API、Amazon Ads API、Temu API，并以 AI 浏览器自动化覆盖主流电商平台。查询操作可直接执行，写操作必须由用户确认。
Amazon SP-API
Amazon Ads API
Temu API
AI 浏览器自动化
# 全局安装前，Agent 必须先获得用户批准
$ node -v && npm -v
$ npm install -g @ziniao-agent/cli@latest
$ npx -y skills@1.5.23 add "https://cdn-znai-agent-swarm-resources-prod.ziniao.com/ai-agent-public-resources/agent-skill/skills.zip" --skill "*" -g -y
$ zn-open-eco version
$ zn-open-eco auth status
在 Codex 中发起任务
使用 amazon-ads-skill，查看我指定店铺美国站过去 30 天的广告花费、广告销售额和 ACOS。
amazon-sp-skill已安装
amazon-ads-skill已安装
temu-skill已安装
ziniao-agent-skill已安装
Capability layer
四个业务 Skill，
覆盖 主流电商平台
每个 Skill 对应清晰的业务边界，并在调用前检查 CLI Auth、店铺匹配和对应平台授权。
Amazon Ads API Skill
查询或管理 Campaign、Ad Group、关键词、预算与竞价，并分析 ACOS、ROAS 等广告表现。
Temu API Skill
查询或管理订单、履约、商品与库存，并适配全托管、半托管和本土店铺。
AI 浏览器自动化 Skill
通过 AI 操作浏览器，覆盖主流电商平台，完成页面导航、数据采集与后台业务操作。
Runtime flow
调用链路清晰，
每一步都有边界
Skill 理解任务并选择业务模块，ECO CLI 负责认证、店铺解析、平台授权检查和官方 API 代理调用。
通用 Agent
用户在 Codex、Claude Code 等 Agent 中发起跨境业务任务。
Skill 选择模块
根据订单、广告或 Temu 业务任务选择对应 Skill 与 API 模块。
CLI 校验上下文
检查 Auth Key、精确匹配店铺，并确认目标平台已完成授权。
官方 API 返回
通过代理调用官方 API，仅向用户展示必要业务结果，不暴露内部账号 ID。
Permission policy
查询可以直接执行，
写操作必须确认
CLI 通过身份认证、店铺解析、平台授权检查、最小化展示和写操作确认，共同约束 Agent 的调用边界。
认证与平台授权
调用前检查 CLI Auth、目标店铺和对应平台授权，未授权店铺不会调用目标 API。
店铺精确匹配
完全同名时优先匹配；出现多个候选时交由用户选择，不猜测店铺。
最小化信息展示
每页最多展示 20 个店铺名称，不向用户暴露 browser_id 或完整店铺对象。
写操作二次确认
修改、删除、发货、取消、预算和竞价调整前，先说明影响并获得用户确认。
Get connected
无需申请 CLI 开通，
四步完成接入
完成系统环境检查、CLI 与 Skills 安装，并使用 AI 控制台提供的 Auth Key 完成认证。目标店铺仍需具备对应平台授权。
检查运行环境
确认使用 Windows 或 macOS，并已安装可用的 Node.js 与 npm。
安装 CLI 与 Skills
全局安装 @ziniao-agent/cli，并从指定资源包安装全部配套 Skill。
配置 Auth Key
从 AI 控制台获取 Auth Key，通过 zn-open-eco auth set <AUTH_KEY> 写入系统原生凭据库。
确认店铺授权
通过 account stores 和 account platform-auths 确认店铺及目标 API 授权。
支持 Windows 与 macOS
暂不支持 Linux、Docker 或无法访问 Windows Credential Manager、macOS Keychain 的服务器环境。
FAQ
关于 Agent CLI
紫鸟 Agent CLI 支持哪些 Agent？
支持能够调用本地命令行工具并加载 Skills 的 AI Agent，包括 Claude Code、Codex、WorkBuddy 等。
接入是否需要申请开通？
不需要提交 CLI 开通申请。完成环境检查、CLI 与 Skills 安装，并使用 AI 控制台提供的 Auth Key 完成认证后即可使用。目标店铺仍需完成对应平台授权。
Auth Key 会保存在哪里？
Auth Key 保存在 Windows Credential Manager 或 macOS Keychain，不写入项目目录、普通明文配置文件或环境变量。
Agent 会直接执行修改或删除操作吗？
不会。新增、修改、删除、发货、取消、预算或竞价调整等写操作，必须先说明影响并获得用户确认。
支持 Linux 或 Docker 吗？
暂不支持。当前支持 Windows x64、Windows ARM64、macOS Intel 和 macOS Apple Silicon，并依赖系统原生凭据库保存 Auth Key。
店铺未完成平台授权怎么办？
使用 Boss 账号进入“AI → 设置 → 平台授权管理”，为目标店铺完成 Amazon SP-API、Amazon Ads API 或 Temu API 授权后，再重新执行任务。
