amz-vault

AMZ Vault MCP

也已发布到官方 MCP Registry，名称为 io.github.TheBurdz/amz-vault，并收录于 Claude 的连接器目录、Smithery 和 mcpservers.org。

将 Claude（或任何兼容 MCP 的 AI 客户端）直接连接到你的 Amazon Seller Central 和 Amazon Ads 数据，查看真实盈利能力、各粒度的 PPC 表现、库存、预测，以及安全且需审批的更改。

• 端点： https://www.amz-vault.com/mcp（Streamable HTTP）
• 身份验证： OAuth 2.1，支持动态客户端注册——当 AI 客户端提示时，使用你的 AMZ Vault 账户登录。无需创建、复制或担心泄露 API 密钥。
• 写入操作： 所有更改都会先暂存。在你审阅差异并确认之前，不会有任何更改应用到 Amazon。

此存储库是托管式 AMZ Vault MCP 服务的公开目录条目。服务本身运行于 amz-vault.com——无需从此处安装或运行代码。

快速开始（Claude）

1. 在 amz-vault.com 创建 AMZ Vault 账户并连接你的 Amazon 账户（14 天免费试用，无需信用卡）。
2. 在 Claude 中，前往 Settings -> Connectors -> Add custom connector，然后粘贴 https://www.amz-vault.com/mcp。
3. Claude 会打开 AMZ Vault 登录和授权页面。请批准。
4. 尽管提问：“上个月我的账户扣除所有费用后的盈利情况如何？”

想在连接自己的账户前试用这些工具？在线演示使用合成卖家账户运行，无需注册。

与众不同之处

• 基于结算数据的利润，而非仪表板估算。 损益工具会将订单、退款、各类 Amazon 费用、COGS 和运营支出与实际结算数据核对——结果与你的银行账户一致。
• 按合适的粒度提供答案。 产品问题会得到产品粒度的答案，广告活动问题会得到广告活动粒度的答案。每个回复都会标明范围，因此共享广告活动支出绝不会重复计算。
• 暂存写入操作，并由人工审批。 调整竞价、添加否定关键词、修改预算、创建广告活动、编辑商品信息——AI 会提出建议，你可以查看确切的差异，只有经过你确认才会执行。没有自主写入模式。
• 覆盖整个账户，而不只是广告。 通过一个连接器即可使用 PPC、自然搜索表现（SQP）、Brand Analytics、库存与补货、MCF、A+ 内容、按 ASIN 预测和补货计划。

示例提示词

• “上个月哪些产品扣除所有费用和广告支出后亏了钱？”
• “找出哪些搜索词消耗了大量支出却没有订单，并暂存否定关键词供我审批。”
• “比较我本季度 SP、SB 和 SD 的表现。”
• “我的头号竞争对手的 ASIN 排名靠前、而我没有竞价的关键词有哪些？”
• “根据当前销售速度和交货周期，我需要在什么时候为每个 SKU 补货？”
• “暂存一项竞价下调 15% 的操作，针对过去 30 天 ACoS 高于 60% 的所有目标——先给我看列表。”

客户端设置

客户端	操作方法
Claude（网页端 / 桌面端）	Settings -> Connectors -> Add custom connector -> https://www.amz-vault.com/mcp
Claude Code	claude mcp add --transport http amz-vault https://www.amz-vault.com/mcp
Cursor	Settings -> MCP -> Add server -> 输入 streamable-http，URL 为 https://www.amz-vault.com/mcp
VS Code（Copilot）	从命令面板选择 MCP: Add Server -> HTTP -> https://www.amz-vault.com/mcp
Windsurf	添加到 mcp_config.json：{"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}}
其他客户端	任何支持 MCP Streamable HTTP + OAuth 2.1 的客户端均可使用。元数据可通过 /.well-known/oauth-protected-resource/mcp 发现。

首次使用时，每个客户端都会进入相同的 OAuth 登录和授权页面——每个客户端批准一次即可完成连接。

工具目录

根据 2026-09-22 的实时工具注册表生成——共 110 个工具（客户端连接后还会显示另外 4 个 AI Workforce 工具）。始终更新的参考文档（含完整参数说明）位于 amz-vault.com/docs。

账户与发现

工具	功能说明
account_feedback	向 AMZ Vault 团队提供反馈和支持的渠道（不是 Amazon 写入操作）：action=submit 会开启一个主题（主题、正文、类别 bug|idea|...
account_health_check	检查所有租户的连接级别引导流程和同步健康状况（仅限超级管理员）
account_help	搜索并阅读 AMZ Vault 帮助中心——即用户在 /help 中看到的相同文章：设置、连接和数据语义、各页面平台...
account_management_guide	运营人员的品牌与 PPC 决策框架：利润主线（PPD + 利润区间）、产品定位、广告活动结构/竞价、收割...
account_notice_draft	将一次性通知邮件加入队列，供管理员审核（仅限管理员）
account_ops_events	运营健康信息流（仅限管理员）：来自工作进程和 Web 服务的去重错误 / 警告 / API 限流事件及发生...
account_profiles	列出与此令牌的卖家连接关联的广告资料（PPC 账户）。
account_report	权威的账户概览——一次调用即可获取：周期卡片 + 结算瀑布流 + 资金数据集的新鲜度说明，以及 quote_rules
account_sellers	列出此令牌可访问的 Amazon 卖家连接，以及对应的市场和货币。
account_support_access	授予或撤销 AMZ Vault 支持团队对该账户的只读查看权限：action=grant 可让支持团队在 7 天内查看用户所见内容...

数据仓库

工具	功能说明
data_describe	不带参数时：列出 data_query 可用的所有数据仓库数据集
data_freshness	各数据集的同步新鲜度、行数、日期覆盖范围和回填进度——用于为回答添加恰当说明
data_query	对任何数据仓库数据集进行通用查询（参见 data_describe）：列投影、筛选条件（eq/neq/gt/gte/lt/lte/in/contains）、日期范围...

损益／盈利能力

工具	功能
pnl_breakdown	按结算口径计算的账户瀑布流：收入 → 退款 → 销货成本 → 毛利 → Amazon 费用 → 边际贡献 → 广告 → 净利……
pnl_by_asin	指定日期范围内按 ASIN 列出的损益数据（可选单个 ASIN）：销售额、销量、费用、销货成本、利润率、TACoS、库存。
pnl_expenses	自定义运营费用（订阅、VA、货运、3PL 等）：范围、周期、金额。
pnl_mcf_summary	多渠道配送（Amazon 以外）汇总：指定日期范围内的商品数量、订单、配送费和销货成本。
pnl_period_cards	仪表板损益迷你卡片（今天／昨天／本月至今／本月预测／上月）。
pnl_refunds	指定日期范围内的退款组成：退款净额、数量和明细项（补偿、重新上架）。
pnl_sb_attribution	按 ASIN 归因的 Sponsored Brands 费用（按销售额加权拆分广告活动级 SB 支出）。
pnl_settlement_audit	结算费用审计：列出 Amazon 收取的每种不同费用组合，并归入损益类别——验证分类是否准确，或是否有误……
pnl_summary	指定日期范围内的损益汇总：账户数据卡片（销售额、费用、销货成本、广告支出、毛利、边际贡献、净利、TACoS……）

产品与库存

工具	功能
inventory_health	按 SKU 列出 FBA 可配送／在途／预留商品数量、库龄库存、补货建议和 AWD 库存池
inventory_shipment_tracking	实时供应链追踪（SP-API Tracking，仅限美国站点）：追踪货件在 Amazon 中流转的里程碑和预估信息——传入一个 ID……
product_cogs	当前各 SKU 的到岸成本（销货成本）和覆盖范围汇总。
product_fee_preview	Amazon 对未来几周各 SKU 费用的估算（推荐费、配送费、仓储费）。
product_library	权威产品目录，包含各产品系列的盈亏平衡 ACoS 和有效盈亏平衡利润率目标。

品牌分析

工具	功能
brand_market_basket	顾客购买各 ASIN 时还会一起购买的商品（关联购买组合及其占比）。
brand_repeat_purchase	按 ASIN 分析客户忠诚度：回头客占比及每周复购收入。
brand_search_catalog	按 ASIN 统计所有查询的搜索漏斗数据（不含查询词的 SQP）：展示量、点击量、加购量、购买量、中位价格。
brand_sqp	搜索查询表现：按 (ASIN, 查询词) 统计自然搜索漏斗数据——展示量／点击量／加购量／购买量及其占比
brand_store_analytics	品牌店铺表现（Stores Analytics API）：view='insights' = 按日期／页面／来源／店铺／标签统计店铺流量和销售额（访问量、访客……）
brand_top_search_terms	整个商城的热门搜索词，以及点击量排名前三的 ASIN 和它们的点击／转化占比

关键词情报

工具	功能
keyword_finder	关键词查找器（反向 ASIN／多输入查询）：列出输入 ASIN 已知的所有关键词词组，整合来自第一方数据的数据——SQ……
keyword_opportunities	关键词研究入口——针对产品的任何关键词问题（无论新产品还是已有产品），从这里开始
keyword_research	关键词研究（商城搜索词全集）：按词组搜索完整的热门搜索词库，不以任何 ASIN 为基准

PPC — 读取

工具	功能
ppc_account_summary	获取指定日期范围内的账户级汇总指标：总支出、销售额、ACoS、ROAS、点击量、展示量和购买量。
ppc_ad_groups	查询广告活动中的广告组表现数据
ppc_ad_type_breakdown	获取不同广告类型（SP、SB、SD）的表现对比
ppc_advertised_products	查询商品/ASIN 级表现数据（SP+SD 广告粒度，按 ASIN 合并并按项目拆分；SB 的 ASIN 级支出仅存在于 blen...
ppc_asset_upload_link	创建一个有效期为 1 小时的浏览器上传链接，以便用户提交本地文件（聊天附件无法传到服务端）
ppc_bid_recommendations	获取 Amazon 针对特定广告活动按关键词给出的建议竞价和范围（根据广告活动类型路由）
ppc_budget_alerts	查找每日预算即将用尽或已超支的广告活动——在 Marketing Stream 数据流入时提供当日数据（signal_source=stream 的行被 mi...
ppc_campaign_create_guide	通过 stage_campaign_create 创建广告活动的已验证规范：各广告格式的必填字段、目标、落地页规则、素材来源...
ppc_campaign_details	获取指定 SP 广告活动的详细数据，包括广告位、推广的 ASIN、广告位竞价调整和热门关键词/定向
ppc_campaign_metadata	广告活动配置和用户元数据：竞价策略、广告位设置、目标/KPI、标签、备注。
ppc_campaign_search	按广告活动名称进行轻量级查找
ppc_campaigns	查询广告活动表现数据，并可选择性应用筛选条件
ppc_change_history	获取近期广告活动变更历史，显示变更内容、时间以及变更前后的值
ppc_conversion_funnel	获取转化漏斗数据：展示量 → 点击量 → 订单量，以及各阶段之间的转化率
ppc_creatives	SB 广告创意（广告粒度，包括标题、品牌徽标、自定义图片、视频素材 ID、ASIN、落地页、创意状态），以及 SD 创意...
ppc_daily_trend	获取逐日指标，用于趋势分析
ppc_dayparting_analytics	分时投放计划以及按小时统计的实际表现
ppc_describe	不带参数时：列出 ppc_query 背后的原始 PPC 数据集（按广告活动/广告组/定向/搜索词/广告位划分的每日报告表...
ppc_harvesting_candidates	查找符合条件、可提升至手动广告活动的转化搜索词
ppc_keywords	查询 Sponsored Products 和 Sponsored Brands 的关键词/定向竞价表现（行中包含 ad_type SP/SB；SD 定向表达式...
ppc_match_type_breakdown	获取按关键词匹配类型（广泛、词组、精准等）划分的表现明细
ppc_negation_candidates	查找支出较高但未产生转化的搜索词——可考虑添加为否定关键词
ppc_negatives	获取当前的否定关键词和否定商品定向（广告活动级和广告组级），包括状态和来源
ppc_new_to_brand	获取各广告活动的新客品牌购买量/销售额和 NTB%（SB + SD，来自标准报告列——无需 AMC）
ppc_optimization_suggestions	分析广告活动，并分类为表现最佳（ACoS 达到或低于目标）、表现偏高（显著高于目标）和支出浪费...
ppc_period_comparison	将当前周期指标与时长相同的上一周期进行比较
ppc_placement_modifiers	获取各广告活动当前的广告位竞价调整（搜索顶部、商品页面、其他搜索位置）。
ppc_placements	根据 SP 广告位数据，获取按广告位类型（搜索顶部、商品页面、其他搜索位置）划分的表现明细
ppc_portfolios	获取投资组合级表现汇总
ppc_product_family	从商品库（Category Listing 报告）查询父商品/子商品层级
ppc_product_report	标准商品/商品系列报告——一次调用返回标记清晰的所有视图：商品系列解析、准确的 asin 级广告总计（SP+SD 广告粒度——...
ppc_query	对任何原始 PPC 数据集进行完整保真度的行级查询（参见 ppc_describe）：列投影、筛选条件（eq/neq/gt/gte/lt/lte/in/contains）、...
ppc_recommendations	获取 Amazon 汇总的建议（统一 Recommendations API）：竞价/预算/竞价策略调整、新关键词、否定关键词、目标...
ppc_search_terms	查询搜索词表现数据

自动化

工具	功能说明
automation_activity	V2 规则自动化的审批收件箱——待处理自动化审批的唯一入口（MinMax/AOE/计划任务工具是单独的……
automation_aoe_status	自适应优化引擎：各广告活动的配置、模式、护栏和近期优化周期
automation_dayparting	分时投放，仅供读取：action=list 显示计划和分配（修改操作在 stage_dayparting_schedule 中）。
automation_minmax_results	近期 MinMax 预算分析运行记录：范围、表现最佳者、预算消耗过快的广告活动
automation_recent_tasks	获取计划自动化任务列表，包括其状态、频率和上次执行结果。
automation_rules	V2 基于规则的自动化，仅供读取：action=list|get|dry_run（修改操作在 stage_automation_rule 中）
automation_scheduled_tasks	计划任务：类型、频率、启用状态、上次和下次运行时间

A+ 内容

工具	功能说明
aplus_document	获取一份实时 A+ 内容文档，包括完整的 contentModuleList——用于编辑的文案来源（aplus_content 数据集包含 met...）

暂存写入（确认前不会有任何内容提交至 Amazon）

Tool	功能
cancel_staged_changes	取消待处理的提案，不执行。
confirm_staged_changes	执行待处理的提案——仅在向用户以文本形式展示完整差异后调用（实体名称、当前值 → 提议值、r...
stage_ad_group_create	在现有广告活动中创建新的 SP 广告组（名称 + 默认竞价；创建后状态为 ENABLED）
stage_ad_group_update	重命名广告组（SP/SB）或更改其默认竞价（仅限 SP——SB 广告组没有默认竞价）
stage_aplus_update	创建或更新 A+（EBC/Premium）内容文档，可选择关联 ASIN 并提交给 Amazon 审核
stage_asset_upload	将 IMAGE 或 VIDEO 上传到 Creative Asset Library——来源可以是公开的 source_url，也可以是 staged_file_id（通过 ppc_ass... 进行浏览器上传）
stage_automation_review	为自动化审批收件箱中的项目暂存决策（收件箱本身请参阅 automation_activity）：操作为 approve|reject|undo，每个 ta...
stage_automation_rule	暂存规则变更：操作为 create|update|delete|toggle|duplicate|assign|unassign|run_now
stage_bid_changes	提议更改符合筛选条件的 SP + SB + SD 关键词/投放对象的竞价（ad_type 用于限定某个广告项目）
stage_budget_changes	提议更改 SP 广告活动的每日预算
stage_campaign_create	端到端创建 Sponsored Products、Sponsored Brands 或 Sponsored Display 广告活动
stage_campaign_tags	在 AMZ Vault 中为广告活动添加标签/注释（add_tags / remove_tags / note）——纯元数据，不会发送给 Amazon
stage_campaign_update	更新广告活动：名称、budget_amount、budget_type（LIFETIME 仅适用于 SB）、bidding_strategy、start_date / end_date（YYYY-MM-DD；null end_d...
stage_cogs_update	提议设置按 SKU 区分、带时间版本的到岸成本（COGS）
stage_competitor_watchlist	提议在评论洞察监控列表中添加/移除竞争对手 ASIN
stage_dayparting_schedule	暂存分时投放变更：操作为 create|update|delete|toggle|clone|assign|unassign
stage_entity_status	按 ID 暂停/启用/归档特定实体：广告组、商品广告、关键词、投放对象或广告活动（补充基于筛选条件的 stage...）
stage_listing_update	更新 Amazon 上的在线商品详情：title、bullet_points（完整替换列表）、description、search_terms（后台关键词，约 249 字节...）
stage_margin_target	提议为某个产品系列设置手动 BE（盈亏平衡）利润率目标（将 be_margin_pct 设为 null 可清除目标并应用计算得出的盈亏平衡值）
stage_negatives	提议添加否定关键词/否定 ASIN 投放对象
stage_negatives_remove	根据 ppc_negatives 中的本地 ID 移除（归档）否定关键词/否定商品投放对象——这是否定投放管理的另一部分
stage_po_upsert	提议创建或更新采购订单（按每个连接的 po_number 匹配）：supplier_name（若为新供应商则创建）、状态/里程碑日期...
stage_portfolio_create	创建新投资组合（无预算上限；之后可通过 stage_portfolio_update 设置预算，包括...
stage_portfolio_update	更新投资组合：name、budget_amount、budget_policy（DATE_RANGE/MONTHLY_RECURRING/"remove"）、budget_start_date、budget_end_date
stage_product_ad_add	向现有 SP 或 SD 广告组添加推广商品（campaign_type，默认为 SP）——创建后状态为 ENABLED
stage_product_edit	提议编辑 Product Library 中的一个字段（锁定该字段，防止后续同步覆盖）
stage_status_change	提议启用/暂停符合筛选条件的广告活动
stage_supplier_upsert	提议创建或更新供应商（按每个连接中的名称匹配）：联系人、付款条款以及生产/运输提前期...
stage_targeting_add	向现有广告活动和广告组（SP 或 SB）添加关键词、ASIN 商品投放对象和/或类别投放对象，例如...
staged_changes_pending	列出此账户中待处理（未确认）的提案

其他

工具	功能说明
forecast_reorder_report	单个卖家连接的补货建议：根据最新预测计算每个 ASIN 的库存耗尽日期（计入 FBA + AWD + 在途库存 + 未完成采购订单……）
forecast_report	12 个月的每个 ASIN 商品数量预测（夜间引擎）：品牌总量与去年同期对比、季节性指数、诊断信息，包括

这不是什么

• 不是自动驾驶工具。 未经你明确确认暂存的差异，任何写入都不会发送到 Amazon。
• 不是爬虫。 所有数据都通过你自己的授权连接，来自 Amazon 官方 Selling Partner API 和 Amazon Ads API。
• 不是本地服务。 MCP 服务托管在云端；此代码仓库的作用是让注册表和目录能够列出它。无需执行 npm install。
• 不是永久免费。 此连接器包含在每个 AMZ Vault 试用版和订阅中。在线演示免费且无需注册。

安全与隐私

• 使用 OAuth 2.1，支持动态客户端注册和逐客户端授权；可随时在设置中撤销任何客户端的令牌。
• 团队成员使用自己的账户连接，并且只能看到其访问授权允许的内容——每次调用都会实时解析授权。
• 破坏性操作会单独标记；现有的两项操作也与其他操作一样，必须获得明确确认。
• Amazon 2026 年 3 月的 Agent Policy，以及 AMZ Vault 如何遵守该政策：amz-vault.com/blog/amazon-ai-agent-policy

链接

• 网站：amz-vault.com
• 在线演示（无需注册）：amz-vault.com/demo
• 工具文档：amz-vault.com/docs
• 基于此连接器构建的免费 Claude 技能：amz-vault.com/skills
• 支持：amz-vault.com -> Feedback & Support，或直接使用 account_feedback 工具